Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Webhooks are used to communicate between two different or same systems. You can use webhooks when you want central to send/receive any data from/to other systems. On Central, you can operate webhooks in 3 different manner, which are as follows -

On Flow Complete

On flow complete webhooks are used when you want to push/send all the flow details to the default webhook once the flow gets completed.

In order to send the details on flow complete, you need to follow below steps -

Step 1 : Configure webhook

First step is to configure a webhook(to which the details will be send) and set it as ‘default webhook’. To configure a webhook, you can follow below steps -

  1. Go to Advanced → Webhook page

  2. Click on ‘add webhook’

  3. Select the method as ‘Post’

  4. Enter or paste the URL and click on ‘check button’.

  5. Once you see a green tick beside check button, select the authentication method.

    1. None : If there is no authentication required

    2. Basic : If username and password is required

  6. Select the body type as ‘None’.

  7. Enable ‘Is default webhook' and click on save button.

Step 2 : Enable webhook in flow

Open the ‘Details section’ of the flow for which you want to send details to the webhook.

Enable ‘webhook for the flow’ and done. After ever execution of this flow, all the flow details will be send to the default webhook in the predefined format.

To know more about webhook’s Predefined Format, you can click here.

Outcome : Everytime the flow is executed, all the flow details (ex- phonon UUID, request ID, CLI number, flow variables etc) will be send to the default webhook selected.

Custom Webhook

Custom webhooks are internal webhooks which can be used to pass on the data in between the flow execution.

Using webhook widget, you can simply invoke any configured internal webhook in between the flow and call any specific method to push some data.

You do not need to bother about the request body or need to specify the variables that needs to be passed. You can simply follow the 2 steps to invoke any webhook in between the flow.

Step 1 : Configure Internal Webhook

First step is to configure a webhook(to which the details will be send). To configure a webhook, you can follow the below steps -

  1. Go to Advanced → Webhook page

  2. Click on ‘add webhook’

  3. Select the method as ‘Post’

  4. Enter or paste the URL and click on ‘check button’.

  5. Once you see a green tick beside check button, select the authentication method.

    1. None : If there is no authentication required

    2. Basic : If username and password is required

  6. Select the body type as ‘None’ and click on save button.

Step 2 : Save Variable (Optional)

If you want to provide any parameters then first you can store that parameter in any flow variable using operation widget (General Assignment Method). This step is completely optional.

Step 3 : Select configurations

In the webhook widget, you need to perform following configurations -

  1. Select URL : Once you have configured the webhook, you will be able to see that URL in the webhook widget. Select the URL of the webhook that you need to invoke.

  2. Enter Method : Enter the name of the method that you need to call

  3. Select Parameters : Select the parameters that you want to pass. Query parameters are the type of variables that will be passed based on the method selected. You can select multiple parameters.

    1. Call : All the variables of ‘call type’ ($call.cli, $call.state, $call.start etc)

    2. $flow.key : All the variable of type ‘$flow.key’ ($flow.key.<keyname>) will be passed

    3. $user.key : All the user key variables will be passed ($user.key.<keyname>) will be passed. To know more about variables, you can click here.

  4. Document API : You can use this area to document your API that is you can explain or provide some insights of the purpose of this webhook call/API. This is an optional field.

Note :

  1. To know more about webhook methods, you can visit here.

  2. Make sure your HTTP usage is enabled for your account. If not, then you can send a mail to request for the same on support@phonon.io

  3. Make sure to whitelist your IP in the whitelist section of your account

  4. Once any specific method is called, the response of will be mentioned in the mentioned variables of that method.

Invoke API

FAQs

  • No labels

This document has been developed by Phonon.io for the sole and exclusive use of the customer / prospective customer with whom this document is being shared. Further, this document has been provided by Phonon.io to the recipient in good faith and based on request from the recipient for the same. This document is a confidential document and contains confidential product technology, workflow and commercial details that are for the sole usage of the intended recipients of this document. Recipients are advised not to share this document with any third party that is not the intended recipient of this document and neither to bring this document in full or parts into the public domain. Any unauthorized access may be brought to Phonon.io’s notice immediately. Phonon.io is free to take any legal action it deems necessary against any person or entity that violates this confidentiality agreement. Phonon.io is bound and governed by the rules of the state of Gujarat in India. In case you are not in agreement with the terms set in this clause or are not an intended recipient of this document, please destroy the document and intimate us of the same at info@phonon.io.