Will I receive a webhook notification if the form is updated as well?

  • Profile Image
    atleta
    Asked on February 04, 2017 at 10:27 AM

    Will I receive a webhook notification if the form is updated as well?



    This is a re-post of a comment on Send Instant Submission Notifications with Webhooks

  • Profile Image
    Welvin
    Answered on February 04, 2017 at 12:56 PM

    Do you mean the updates that are made in the form builder? I don't think this is possible with Webhook alone. You will need to do this with our API.

    http://api.jotform.com/docs/

    This is a bit technical so if you don't know this, you may consider hiring someone to develop this for you. 

  • Profile Image
    atleta
    Answered on February 04, 2017 at 01:33 PM

    Thanks for getting back to me. I am a developer and trying to implement the webhook. The docs is a bit technical, but mostly too sloppy unfortunately. The API response format for getting the submissions contains a field called 'updated_at'. It's not documented, but I assume that it means that the user, who did the submission went back and edited the submission and sent it again. Though looking at our data this is pretty unlikely, so it might be bogus, because we have a lot of forms where *months* have passed between the original submission ('created_at') and the update. Could you confirm what the updated_at field means?

    The question is: do I get a webhook callback in this case as well? And while we are at it: does it change the flag and/or the 'new' status of a submission? I'm trying to find a way to consistently get the updated data from the forms. (Polling is OK, I have already implemented it for fetching the existing data and using the flag to mark the ones that we have fetched. I can switch over to using the 'new' flag and clearing it, if that gets changed when the user re-submits.)

  • Profile Image
    atleta
    Answered on February 04, 2017 at 01:34 PM

    One more thing: what's the format of the data I'm going to receive through the webhook. It's undocumented. Is it the same JSON that I get through the API when querying the submissions?

  • Profile Image
    Kevin
    Answered on February 04, 2017 at 07:57 PM

    Using our API is the best way to achieve this as suggested by my colleague above, it will allow you to capture the entire info from a form, submission, user or anything you need to know.

    Regarding to your question about what "updated_at" means, this variable will let you know when the submission or form was updated, for example, may be that the submission was created on 2017-01-30 12:36:5 and then it was updated, then when you get the info the "updated_at" variable will have the value when the user did a change on the submission, example "2017-02-04 19:49:04".

    Regarding to the "new" variable you see in the API response, it will not change when the submission is edited, it will be set to 1 only when the submission has been sent for the first  time and until the user reads it, once the submission is viewed the flag will be set to 0 and this will not be changed back. 

    what's the format of the data I'm going to receive through the webhook

    If you're using WebHooks the info will be submitted using the POST method, you will be able to capture this variable and get any info you need. 

    Also, I would suggest you to take a look to our Jotform API libraries where you will find different programming languages to use our API: https://developers.jotform.com/libraries#jotform-api-php 

    Hope this helps. 

  • Profile Image
    atleta
    Answered on February 05, 2017 at 05:53 PM

    Thanks for the confirmation of the function of updated_at and clarifying how the 'new' property works.

    On the other hand, my original question is still not answered: will I get a webhook callback/notification if the submission is updated by the user nor not?

    Also, what's the format of the data being sent in the POST request.

    Unfortunately your response to this one doesn't make sense at all. You repeated that the webhook will be called with a POST, but that was part of the question and then you talk about some variable, but it doesn't make sense in this context. Also, and it's not the first time it happens, the link that you've thrown in has nothing to do with it. That's the PHP implementation of your API client and not a webhook listener. I don't need an example, I'd just prefer a clear documentation. But of course, if I have to, I can decode if form sample code as well.

    Could you please get someone with programming knowledge answer this question? Of course I can experiment my way around it, but I'd just prefer if you answered and then updated the docs.

  • Profile Image
    Chriistian
    Answered on February 05, 2017 at 10:44 PM

    Apologies for the inconvenience. Here's the documentation related to the webhooks: http://api.jotform.com/docs/#form-id-webhooks. I believe our API team can better assist you with your questions about the API and webhooks. You may contact our API team directly at api@jotform.com

    Thank you,