← Back
Incoming Webhooks
Connect any external service to your AI agent — CRM, GitHub, payment systems, your own server
What are incoming webhooks?
Any external service can send events to your AI agent. The agent receives the payload and sends you a notification in Telegram. GitHub can notify about a new pull request, your CRM about a new lead, your payment system about a successful payment — and the agent immediately creates a task or sends a message.
How to set up a webhook?
- Find your agent ID in the agent settings in the dashboard.
-
Get a webhook token via API:
GET https://asibiont.com/api/agent-webhook-token/{agent_id}?action=regenerate
Response:
{"token": "abc123...", "url": "https://asibiont.com/api/agent-webhook/42/abc123..."}
-
Configure the external service to send POST requests to:
POST https://asibiont.com/api/agent-webhook/{agent_id}/{token}
Request body (JSON, any fields):
{
"event": "new_order",
"order_id": 12345,
"amount": 9900,
"customer": "Иван Петров"
}
- The agent receives the event, creates a task, and sends you a notification in Telegram.
Is the webhook secure?
The token is verified via constant-time comparison (timing-safe) — this prevents timing attacks. You can regenerate the token at any time by calling the same endpoint with ?action=regenerate. The old token becomes invalid immediately.
Which services can send webhooks?
Any service that supports outgoing webhooks (POST requests):
- GitHub / GitLab — pull requests, issues, deployments
- Payment systems (Stripe, ЮKassa, Robokassa)
- CRM systems (AmoCRM, Bitrix24, HubSpot)
- Your own server or script
- Zapier, Make (Integromat), n8n
- Any monitoring or alert system
What format does the request body need to be?
JSON with any fields. The agent receives the entire payload and converts it into a readable notification. There are no required fields — send whatever your service provides. The Content-Type header should be application/json.