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.

---

​

Related