​
Introduction

This guide will help you integrate and set up webhooks for inbound AI-powered calls. It explains how to configure webhook settings, set up an API receiver, and dynamically replace variables in AI-generated prompts.

​
Prerequisites

Before you begin, make sure you have:

  • An account for your application.
  • A valid URL to handle webhook calls.

​
Configure Webhook Settings

To get started, set up your webhook URL, headers, and query parameters.

  • Enter your webhook URL
  • Add your API authentication details, such as bearer tokens or API keys.
  • Include any dynamic parameters you wish to pass, such as customer_name and order_status.

​
Create an API Receiver

  • Create an API endpoint to process incoming webhook requests.
app.get('/get-webhook', (req, res) => {
    console.log("Request Headers: ", req.headers);
    console.log("Request Query: ", req.query);

    // Respond with variables for AI prompt
    res.status(200).json({
        variables: {
            customer_name: "John Doe",
            order_status: "shipped"
        }
    });
});

Note: The API response should always include the variables object in the following format:

{
    "variables": {
        "customer_name": "John Doe",
        "order_status": "shipped"
    }
}

​
Replace Variable in AI Prompts

Use the returned variables from your webhook to dynamically update AI prompts.

Example Prompt in Call Flow Designer:

Hello, {{customer_name}}, your order status is {{order_status}}.

When the webhook processes the request, variables are replaced dynamically:

Hello, John Doe, your order status is shipped.