> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryopencomputer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks and call events

> Connect conversation results to your own service.

Athena has several distinct outbound and inbound integration paths:

| Mechanism | Purpose |
| - | - |
| Workflow webhook | Send data from the configured workflow step to your service. |
| HTTP tool | Make a request while executing an agent action. |
| Call-event destination | Export configured call events through the selected integration. |
| Telephony callback | Receive provider events inside Athena. |

Configure the mechanism that matches your use case; they do not share one universal payload or delivery guarantee.

## Verify your receiver

Use a temporary receiver under your control. Send synthetic data, verify the observed method and payload, and test how your receiver handles repeated deliveries and non-success responses.

## Workflow webhook contract

The workflow webhook renders your configured `payload_template` once. For object payloads, it adds `call_disposition` if your template did not already supply it.

The current wire headers retain their existing names:

| Header | Meaning |
| - | - |
| `X-Dograh-Delivery-Id` | Stable delivery identifier; use it to deduplicate retries. |
| `X-Dograh-Workflow-Run-Id` | The associated run. |
| `X-Dograh-Delivery-Attempt` | The delivery attempt number. |

These are correlation headers, not cryptographic signatures. Use the configured credential and authentication mechanism expected by your receiver.

Network failures and HTTP 408, 425, 429, 500, 502, 503, and 504 are eligible for retry. The delivery is stored and retried with backoff; exhausted attempts and permanent failures become dead-letter deliveries. Limits depend on deployment configuration.

Both an HTTP-tool request and a post-call workflow webhook have been observed at a controlled receiver. The post-call test matched a unique marker in the configured payload and included `call_disposition` after the controlled SIP run completed. Retry and dead-letter behavior is covered by local tests; a live delivery-failure drill has not been performed.

## Call-event delivery

The call-event exporter makes up to three delivery attempts within a bounded window. It can discard events if the destination changes, export remains unsuccessful, or the bounded queue is full. It is not an unlimited durable delivery queue.

These exporter semantics do not establish the behavior of a workflow webhook. Verify each integration separately.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.