Skip to main content
Webhooks send real-time itellicoAI events to another system you manage. Access: Go to Settings → Developers → Webhooks.
This page is usually handled by a technical teammate, even when operations, sales, or support teams decide which events should trigger follow-up work.

​
What You Configure

Each webhook subscription includes:
  • Name
  • Target URL
  • Active/inactive state
  • Optional signing secret
  • Optional agent scope
  • Event subscriptions
If you do not select any agents, the webhook applies to all agents in the current account.

​
Create a Webhook

1

Open Webhooks

Navigate to Settings → Developers → Webhooks.
2

Create a webhook

Click Create a Webhook.
3

Review the create form

The create dialog includes destination, signing secret, agent scope, and event selection controls.
4

Set the destination

Add a descriptive name and the HTTPS address that should receive deliveries.
5

Generate the signing secret

Use the Regenerate action to create a signing secret.
6

Choose agent scope

Optionally restrict the webhook to one or more agents. Leave it empty to receive events for all agents.
7

Select events

Pick the event groups and individual events you want to receive.
8

Save the subscription

Create the webhook and confirm the receiving system can acknowledge events quickly.
If you generate or regenerate a secret, copy it immediately and store it securely before closing. The current UI does not let you paste a custom secret value directly.

​
Fastest Way to Test

If you are setting up webhooks for the first time, start with a temporary inspection endpoint before you connect your production system.
1

Create a temporary endpoint

Use a request-inspection service such as Webhook.site or RequestBin to get a unique HTTPS URL.
2

Create a narrow subscription

Subscribe to one or two events only, such as conversation.ended or conversation.analysis.completed.
3

Trigger a real event

Place a test call or complete the workflow that should emit the selected event.
4

Inspect the payload

Confirm the headers, signature fields, event type, and data payload shape before wiring your real endpoint.
5

Move to your production endpoint

After you validate the shape and timing, swap the temporary URL for your real destination.

​
Implementation Model

The best webhook receivers follow a simple pattern:
  1. verify the signature against the raw body
  2. acknowledge quickly
  3. move slow processing into your own background jobs
If you are building the receiving endpoint itself, continue with the Webhook Implementation Guide.

​
Event Selection

The event picker is grouped by entity so you can subscribe at different levels:
  • select or clear all events
  • select or clear an entire entity group
  • select individual events within a group
Use a narrow event set for each destination so downstream systems receive only the data they need.

​
Webhook Inventory

The table shows the current subscriptions with:
  • Name
  • Target URL
  • Status
  • Subscribed event count
  • Agent scope
From the table, you can:
  • edit a subscription
  • delete a subscription
  • verify whether a signing secret is set
If no agents are selected, the table shows the subscription as applying to All Agents.

​
Security Recommendations

Deliveries should terminate on HTTPS so secrets and event data are protected in transit.
Validate the webhook signature and timestamp on every request before you trust the payload.
Acknowledge the event quickly and move long-running work to your own background jobs.
Use different webhook subscriptions for CRM sync, analytics, or alerting so you can tune event scope and credentials independently.

​
Troubleshooting

Confirm the webhook is active, the target URL is reachable, and the selected event set matches the activity you are testing.
Make sure your endpoint uses the raw request body and the current signing secret when calculating the HMAC signature.
Edit the webhook and set the Agents field instead of leaving it empty.

​
Next Steps

Webhook Events Reference

Review event names, payload envelopes, headers, and retry behavior

Webhook Implementation Guide

Build a receiver that is fast, safe, and easy to debug

Integration Testing

Validate your endpoint and end-to-end event handling

Integrations

Connect other account-level integrations in the same account

Secrets

Manage reusable credentials for supported configurations