Skip to main content
An inbound webhook lets your application make a decision when a configured phone number receives a call. The runtime invokes the endpoint before the agent conversation starts. Use the webhook to return dynamic variables needed by the greeting, prompt, flow, or actions. Your endpoint can also reject the call when your application decides it should not proceed.

​
Configure the endpoint

Open a phone number’s inbound configuration, enter an HTTPS webhook URL, and use Test to inspect the response before enabling live traffic. Design the endpoint to:
  • Respond within the configured timeout
  • Return dynamic variables as string-compatible values
  • Avoid returning credentials or unnecessary personal data
  • Handle retries without causing duplicate side effects
  • Fail safely when the caller or account cannot be resolved
Keep authorization values in secrets or the supported phone configuration. Monitor webhook failures alongside the related conversation or observability session.