Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vocode.dev/llms.txt

Use this file to discover all available pages before exploring further.

You can set up webhooks on agents so that you can listen to events in realtime or for post-call automation.

​
Adding Webhooks

To get data from the agent during a call, you can add a webhook and assign it to listen for specific events. Let’s send a POST request to “https://example.com” every time a call ends. 
from vocode import AgentUpdateParams, EventType, HttpMethod, WebhookUpdateParams

new_webhook = WebhookUpdateParams(
    subscriptions=[EventType.EVENT_PHONE_CALL_ENDED],
    url="https://example.com",
    method=HttpMethod.POST,
)

number = vocode_client.numbers.update_number(
    phone_number="YOUR_NUMBER",
    inbound_agent=AgentUpdateParams(
        webhook=new_webhook,
    ),
)

​
EventTypes

The full list of EventType is listed here:
  • EVENT_MESSAGE: A message in the conversation.
  • EVENT_ACTION: An action taken during the conversation.
  • EVENT_PHONE_CALL_CONNECTED: Indicating the phone call has connected.
  • EVENT_PHONE_CALL_ENDED: Indicating the phone call has ended.
  • EVENT_TRANSCRIPT: The transcription of the entire conversation.
  • EVENT_RECORDING: The recording of the conversation has become available.
  • EVENT_HUMAN_DETECTION: Indicating whether a human or a machine has picked up the phone.