This widget is used to make custom API calls that enables AVOXI Flow Builder to communicate with different systems by retrieving or sending data. 

Responses from these API calls can be stored in variables and referenced further in the flow to make routing decisions. 

How it works

• Scenario - Know if the caller is a valid customer based on customer id entered by caller before routing the call to a support queue
• Caller is prompted to enter customer Id
  • Customer Id is collected using gather input widget and is stored in variable customerId. Refer gather input article for more details.
• Make an API call to respective endpoint to validate customer
  • Sample Method & URL - GET request -  https://testcrm.com/validateCustomer
  • Pass “customer id” collected in gather input as a parameter to this request Parameter (key:value) - cId : <customerId>
  • Sample response received : {“valid” : 1}
  • Store the response in a variable - is_customer_id_valid
  • Successful API calls will proceed with success path

This variable <is_customer_id_valid> can be used to make routing decisions using condition widget.

Configuration

1. Add “Webhook” widget from Widget library
2. Refer respective API docs for config details - sample API docs - https://genius.avoxi.com/api/v2/api-docs/ 
3. Use widget config panel to manage specific configurations
   1. You can select one of the 3 request method and respective URL
      1. GET - Used to retrieve data
      2. POST - Used to submit  information to specified resource 
      3. PUT - Used to replace/update current information at target with request payload
   2. Pass required additional data using headers and parameters key value pairs
      1. Values can be plain text values or variables defined earlier in the flow. Differentiate values from variable by surrounding variable names with “<>” example - <customerId>
      2. This can include data like username, password, authentication tokens, etc
      3. Add headers and parameters using “+” button
      4. Use delete button to delete respective header/parameter key value pairs
      5. There is a list of internal call variables available in dropdown. eg - <call.from.number>, <call.from.name> and many more
   3. With POST method, request body can be sent in Form data, JSON or text format
   4. Name the webhook response key, This is used to reference variables defined in capture webhook response further in the flow. All the variables in capture webhook response are nested within webhook response key.
   5. If the API call made is successful, capture responses received in variables. These variables can be referred to elsewhere in the flow to make routing decisions (condition widget - coming soon)
4. Configure “Success” and “Fail” path
   1. Success Path
      1. This represents that API call was successful
   2. Fail Path
      1. This represents that API call was not successful

Example

Raw Webhook Response: {
	"customerDetails": {
		"name": "XYZ Corp",
		"emailAddress": "test@xyz.com",
		"valid" : "1" 
	}
}

Webhook Response Key: "customer" 

Capture Webhook Response:
[
	{ "retrieveFrom": "customerDetails.name", "applyTo": "customerName" },
{ "retrieveFrom": "customerDetails.valid", "applyTo": "isCustomerIdValid" } 
]

AVOXI Call State: // how variables key value pairs are stored in AVOXI's system
{
	"customer": {
		"customerName": "XYZ Corp",
		"isCustomerIdValid": "1"
	}
}

The stored values can be referred to further in the flow using WebhookResponseKey.ApplyTo -> <customer.customerName> or <customer.isCustomerIdValid>

Troubleshooting

Webhook resposnes are captured within call journey for further troubleshooting. To check call journey navigate to 'Activity' and select a call to view the Call Details.
 

Connect app within Flow builder

1. You can add you new connections while configuring webhooks in Flow Builder
2. Navigate to Flow Builder > click “+Add”
3. Add webhook widget, within webhook config panel, use “Auth” tab to configure connection details
   1. 
4. Within Authentication dropdown, select “+ Add New Credential” 
   1. 
5. Search and select the app/CRM you want to connect to
6. Based on the selected app, give the connection a name and configure details following instructions on screen.
   1. 
7. To use a preconfigured connection, search and select the app/CRM from Authentication list

Read more here.