Skip to main content

​
Webhooks

The Webhook node fires an HTTP POST to a URL when the conversation reaches it. Use it to send transcripts, trigger CRM updates, create support tickets, or notify external systems.

​
Adding a Webhook node

  1. Drag the Webhook node from the sidebar (Integration category) onto the canvas
  2. Connect the End node’s output to the Webhook node’s in handle (or connect any step that should trigger the webhook)
  3. Set the transferTarget URL

​
Parameters

ParameterTypeRequiredDescription
transferTargetstring✅The HTTP endpoint URL to POST to

​
Payload

The webhook receives a POST request with this JSON body: 
{
  "conversation": [
    {
      "type": "user",
      "text": "I need help with my bill",
      "timestamp": "2025-01-01T12:00:00.000Z"
    },
    {
      "type": "assistant",
      "text": "I'd be happy to help with your billing question.",
      "timestamp": "2025-01-01T12:00:01.000Z"
    }
  ]
}

​
Response handling

Voiceblox checks the HTTP response status. The call proceeds regardless of the webhook response — failures are logged but don’t crash the session.

​
Common use cases

  • CRM update — POST conversation summary to Salesforce or HubSpot
  • Support ticket — Create a Zendesk ticket with the transcript
  • Analytics — Send conversation data to your data warehouse
  • Notifications — Alert your team via Slack or email webhook

​
Connecting Webhook to End

The most common pattern is to fire the webhook after the conversation ends: 
[End] ──▶ [Webhook]
The Webhook node is a terminal node — it has no output. Once the webhook fires, the session closes.