Skip to main content

Documentation Index

Fetch the complete documentation index at: https://katavenai.mintlify.app/llms.txt

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

Three steps:
  1. Register provider credentials (see Telephony).
  2. Register the phone number with agent_id set to the agent that should handle inbound.
  3. Carrier-side, point the number’s webhook at Kataven’s gateway.
The carrier-side webhook URL depends on your provider — see your provider’s docs for “voice webhook URL.” Point it at: 
https://api.kataven.ai/twilio/voice    # for Twilio
https://api.kataven.ai/plivo/voice     # for Plivo
https://api.kataven.ai/vobiz/voice     # for Vobiz
That’s the entire wiring. When the number rings, the gateway looks up which agent it’s pinned to and brings up the conversation.

​
Reassign at runtime

Pinning a number to a different agent is one PATCH: 
client.telephony.update_number(number_id, agent_id="<new agent>")
Effective on the next inbound call — no carrier reconfiguration.

​
Detach (free the number)

client.telephony.update_number(number_id, agent_id=None)
Inbound calls to a detached number return a busy signal until you re-attach.