Webhooks
A webhook is an HTTPS request that Resia sends to your server when something happens. Resia sends six event types:
| Event | When | Configure with | Your reply |
|---|---|---|---|
call.ended |
A call reaches completed, error, or canceled. |
call_ended_webhook_url on the Call Agent, or on one call |
Any 2xx |
chat.ended |
A chat reaches completed, failed, or cancelled. |
chat_ended_webhook_url on the Chat Agent |
Any 2xx |
orchestration_run.ended |
A run reaches succeeded, failed, or cancelled. |
run_ended_webhook_url on the Orchestration Agent, or on one run |
Any 2xx |
call.incoming |
An inbound call arrives on your number, from a caller that no orchestration run registered on that number. | inbound_input_webhook_url on the Call Agent |
200 with inputs, within 30 seconds |
chat.incoming |
A text starts a new chat on your number. | inbound_input_webhook_url on the Chat Agent |
200 with inputs, or 404 to refuse, within 30 seconds |
text_message.received |
A human text arrives on your number. | webhook_url on the text receiver |
Any 2xx |
Result events
call.ended, chat.ended, and orchestration_run.ended carry the same record that the matching GET request returns, built when Resia sends the event.
{
"type": "call.ended",
"call": {
"id": "01K1SA3F7M8QW2V5C9H4YTB0KD",
"call_agent_version_id": "01K1S9V9Q0RS7X4T2N6BJ8ZDE5",
"call_agent_id": "01K1S7RA9M8QW2V5C9H4YTB0AG",
"call_agent_name": "Front desk",
"status": "completed",
"created_at": "2026-09-15T14:00:00.000+00:00"
}
}
The record is under call, chat, or orchestration_run. Real events include more fields, such as the transcript and analysis.
Since API version 0.25.2, the run-ended event is orchestration_run.ended, with the run under orchestration_run. Resia sends no event with the old name, also for a run started through an old route. See Deprecations.
Delivery rules:
- Reply with any
2xxstatus as soon as you accept the event. Do slow work after you reply. - If delivery fails, Resia retries on a fixed schedule: up to 6 attempts over about 8.6 hours.
- The same event can arrive more than once. Use the record's ID (
call.id,chat.id, ororchestration_run.orchestration_run_id) to ignore duplicates. - If every attempt fails, read the record with a
GETrequest to recover it.
Human text notifications
text_message.received carries saved SMS or MMS under text_message. Use text_message.text_message_id to discard duplicates.
The same six-attempt retry schedule applies. Recover missed content through GET /v1/text-messages/received.
Your acknowledgement supplies no reply to the sender. Send a reply through the text API.
See Receive and reply to human texts.
Inbound events
call.incoming and chat.incoming let your server supply inputs before the conversation starts, such as the caller's name from your CRM.
{
"type": "call.incoming",
"call": {
"from_phone_number": "+12125550142",
"to_phone_number": "+16465550175"
}
}
Reply within 30 seconds with HTTP 200 and this envelope. inputs must match the agent's input_schema:
{"inputs": {"patient_name": "Ada"}}
Resia makes one attempt and does not retry. The endpoint, the chat.incoming body, and what happens when the reply is late or wrong are in Give an inbound agent details about the caller.
Security
Webhook requests have no signature header. Authenticity comes from HTTPS and from the secrecy of the URL.
- Put your own random token in the URL, such as
https://example.com/resia/webhook?token=..., and check it on every request. - Treat the complete URL as a secret.
- Never use your Resia API key as the token.
- Resia stores webhook URLs, returns them on reads, and shows them in request logs. Limit who can read those records.
Debugging
Every webhook attempt appears in request logs with its request, your response, and its status:
curl --fail-with-body --silent --show-error \
"$RESIA_API_BASE/v1/request-logs?kind=webhook&limit=10" \
--header "Authorization: Bearer $RESIA_API_KEY"
API reference: each event is documented under the Webhooks section of the API reference.

