A webhook is a call from the Vonage AI platform to an outside service, often an API, that allows you to pass information from a matched intent to a web service and get a response. Webhooks are used to log and deliver information collected by your agent to your service, database, or another information storage tool. They can perform many types of actions, such as logging the data, building your response to the user based on data stored in a database or data returned from other APIs, etc.
Implementing webhooks into our agents can be done without writing any code and will expand the capabilities of your agent. Be aware that a webhook will only run once all required parameters are filled.
The URL used for accessing your web service should be a public URL.
When an intent in which a webhook was enabled is triggered, Vonage AI sends data to the service in the form of POST request with a POST body in the format of response to query. The key component that the JSON contains is the NLU response node. Other parts of the JSON will contain other valuable user information (when available).
The service should be able to handle the following errors:
Timeout for service response – 5 seconds
Data received in the response from the service – up to 64K