Skip to main content

Webhooks

Templates​

To jump straight into some template code, you can go to our integration-guides repository on GitHub and pay close attention to the directories under /pages/api.

Create your own webhook​

You can define one webhook URL for an AI Agent, and then call the webhook from one or more dialog nodes. To create your own webhook, go to your AI Agent → Webhooks → + Create webhook. You need to provide the following:

  • Name
  • URL
  • Verification token

Custom headers​

You can also add any headers that you want to pass to the service during the webhook call.

The only headers that you aren't allowed to add are:

'Connection',
'Content-Disposition',
'Content-Encoding',
'Content-Length',
'Content-Type',
'Host',
'Upgrade',
'Accept'

Test your webhook​

Simple test​

You can test your webhook by clicking on Send test request.

On the right side, you will receive:

  • The status code
  • The execution time
  • The response or any error

Update context variables​

Upon receiving your webhook's response, you can select Update context variables to use the values returned by the webhook in the AI Agent while setting context variables from the auto-complete functionality.

Advanced test​

The Advanced test section allows you to edit the payload of the request.

Testing with cURL​

We provide an integration-guides repository on GitHub, which includes ready-made webhooks that you can use in your AI Agents and that might also function as templates for your own custom implementations.

Random number generator​

This is a simple function that returns a random number based on the values of the query parameters. It can be used for simple examples such as A/B testing

, and more. You can make an example call to the webhook using curl:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Moveo-Signature: 7b2e526f80d3ad094ee0a2ccc2501afdab7044f89839f9fcba9466d15a967774" \
-d '{"lang": "el", "channel":"web", "context": {"firstname": "John", "lastname": "Snow"}}' "https://integration-guides.moveo.ai/api/common/random-number-generator?max=100&min=0"

Get recent purchases​

This function is more involved and returns a carousel of recent purchases for the user. It takes into consideration a time-cursor so that it can keep loading older cards in the carousel message.

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Moveo-Signature: 7b2e526f80d3ad094ee0a2ccc2501afdab7044f89839f9fcba9466d15a967774" \
-d '{"lang": "el", "channel":"web", "context": {"firstname": "John", "lastname": "Snow"}}' "https://integration-guides.moveo.ai/api/ecommerce/purchases-get-recent"
Last updated on