Webhooks
Webhooks notify your systems in real-time when events happen — a call starts, ends, or analytics complete. Atoms sends an HTTP POST to your URL with the relevant data.
Managing Webhooks
All webhooks are created and managed from the dashboard.
Location: Left Sidebar → Settings → Webhook
The table shows all your webhooks with their URL, assigned agents, created date, and status.
Creating a Webhook
Click Create to add a new webhook endpoint.
The right panel shows example Flask code for handling webhooks with HMAC signature verification.
Click Add endpoint to save.
Webhook Details
Click any webhook to see its details and subscriptions.
Adding to an Agent
Once a webhook exists, connect it to your agent.
Location: Agent Editor → Agent Settings → Webhook tab
Select your webhook from the list. The agent will now send events to that endpoint.
Events
Subscribe to the events you need when connecting the webhook to an agent.
Payload Data
Each event sends relevant data:
pre-conversation:
- Caller phone number
- Agent ID
- Call direction
- Timestamp
analytics-completed:
- Full transcript
- Call duration
- Post-call metrics
- Variables collected
Tips
Verify signatures
Use the signing secret to verify requests actually come from Atoms. The example code in the Create modal shows how.
Handle failures gracefully
If your endpoint is down, events may be lost. Log everything and consider retry logic.
One webhook, multiple agents
You can connect the same webhook to multiple agents. The payload includes the agent ID so you know which agent sent it.
