Pre-Call Webhook

Called before an inbound call is answered. Return variables to be merged with the agent’s default variables for this call.

WEBHOOK pre-call

Example

{
  "event": "pre_call",
  "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "fromNumber": "[phone]",
  "toNumber": "[phone]",
  "dialedAgentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

200

{
  "variables": {}
}

Authorizations

x-api-key · string · header · required

API key for authentication. Generate API keys from the RevRing dashboard.

Body

application/json

event · string · required

Example:

"pre_call"

agentId · string<uuid> · required

The agent ID

fromNumber · string · required

Caller's phone number (E.164)

Example:

"[phone]"

toNumber · string · required

Dialed phone number (E.164)

Example:

"[phone]"

dialedAgentId · string<uuid> | null

Agent ID when the call was routed directly to an agent (null if routed via phone number)

Response

200 - application/json

Webhook response with optional variables

variables · object

Additional variables to merge with agent defaults