Skip to main content
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:
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:
Effective on the next inbound call — no carrier reconfiguration.

​
Detach (free the number)

Inbound calls to a detached number return a busy signal until you re-attach.