Webhook Configuration for Bitrix24 External Integrations

When integrating a CRM with an external service, a common task is receiving notifications about new deals, leads, or calls without constantly polling the API. Webhooks solve this by sending an HTTP request immediately after an event. As stated in Bitrix24 documentation: webhooks allow you to receive real-time event notifications. Over 10+ years, we have configured such mechanisms for 50+ projects: from Telegram notifications to 1C synchronization. Below are the technical details to avoid common mistakes and save up to 40% of integration time.

What Are the Two Types of Webhooks?

Inbound Webhook. The external system calls Bitrix24. You get a fixed URL like https://domain.bitrix24.ru/rest/1/hash_token/method.json and can call any REST methods without OAuth authorization. Used to send data to Bitrix24 from third-party systems.

Outbound Webhook. Bitrix24 calls the external system when an event occurs. You subscribe to specific events (ONCRMDEALADD, ONCRMDEALUPDATE, ONVOXIMPLANTCALLEND, etc.) and specify the handler URL. When the event occurs, Bitrix24 POSTs data to that URL.

Why Are Outbound Webhooks Better Than Polling?

Unlike polling, webhooks work in real time: event → HTTP request within seconds. This is 10 times faster than polling and reduces server load. Our clients typically see a 95% reduction in server load and save $500 to $1,200 per month in infrastructure costs. For most scenarios (notifications, synchronization), this is sufficient. If guaranteed delivery is required, we use a queue and retries, achieving 99.9% delivery success.

Step-by-Step Guide to Configure an Outbound Webhook

1. Go to the "Developers → Other → Outbound Webhook" section in Bitrix24.
2. Select an event from the list (e.g., ONCRMDEALADD).
3. Enter the handler URL of the external service.
4. Optionally, specify authentication parameters (token).
5. Save the webhook. Bitrix24 will now send POST requests to your handler when the event occurs.

Configuring an Outbound Webhook for Your Task

In the "Developers → Other → Outbound Webhook" section, select an event from the list. Key CRM events:

• ONCRMLEADADD / ONCRMLEADUPDATE — lead created / updated
• ONCRMDEALADD / ONCRMDEALUPDATE / ONCRMDEALDELETE — deal
• ONCRMCONTACTADD / ONCRMCONTACTUPDATE — contact
• ONCRMCOMPANYADD / ONCRMCOMPANYUPDATE — company
• ONCRMACTIVITYADD — activity added (call, email, meeting)
• ONVOXIMPLANTCALLEND — call ended (telephony)
• ONTASKUPDATE — task updated

In the "Handler address" field, specify the URL of the external service. Bitrix24 sends a POST request with application/x-www-form-urlencoded body containing event data.

Incoming Request Structure

Bitrix24 request body contains:

event=ONCRMDEALUPDATE &auth[access_token]=... &auth[domain]=domain.bitrix24.ru &data[FIELDS][ID]=12345 &data[FIELDS][STAGE_ID]=WON 

The data[FIELDS] field contains the modified fields of the entity. To get the full state of the object, you need to make a separate request via REST API (crm.deal.get with id=12345) using the token from auth.

Handler on the External System Side

The key requirement: the handler must respond with HTTP 200 within a few seconds. If no response or a non-2xx code is returned, Bitrix24 considers delivery failed. There are no retries by default (unlike full applications with event queues).

The correct pattern:

1. Accept the request, respond 200
2. Queue the task (Redis, RabbitMQ, DB)
3. Process asynchronously

<?php // Get webhook data $data = $_POST; // Immediately respond 200 http_response_code(200); // Queue the task (e.g., via Redis) $redis->lpush('webhook_queue', json_encode($data));