Integrate WhatsApp with Bitrix24

Step by step

1. 1

   Create the instance and get the keys on ZapZap API

   In the ZapZap API dashboard, provision a number, scan the QR Code on WhatsApp and copy the instanceId, x-api-key and x-api-secret. This number is the one that will send the messages from Bitrix24.

2. 2

   Open Outbound webhooks in Bitrix24

   In Bitrix24, go to Applications, then Developer resources and click Outbound webhook. Select the event you want, for example ONCRMDEALUPDATE or ONCRMLEADADD, to fire when the deal changes stage.

3. 3

   Point the webhook to an automation tool

   In the Handler URL field, enter the URL of an intermediate service (such as Make, n8n or your own function) that will receive the Bitrix24 event and translate the deal data into the ZapZap API call.

4. 4

   Build the call to ZapZap API

   In the automation tool, configure an HTTP POST request to ZapZap API using the deal contact's phone and the message text. Send the x-api-key and x-api-secret headers to authenticate.

5. 5

   Test with a real deal and monitor

   Move a test deal through the Bitrix24 funnel, confirm the message arrived on WhatsApp and keep track of the sends. Use Bitrix24's Inbound webhooks if you want to record replies back into the CRM.

// ILLUSTRATIVE example: WhatsApp message fired when a stage changes in Bitrix24
// See the real endpoints and fields at https://api.zapzapapi.com/llms.txt

const res = await fetch(
  "https://api.zapzapapi.com/api/v1/{instanceId}/send/text",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": process.env.ZAPZAP_API_KEY,
      "x-api-secret": process.env.ZAPZAP_API_SECRET,
    },
    body: JSON.stringify({
      number: "5511999999999",
      text: "Hello! We received your contact and are already taking care of your request.",
    }),
  }
);

const data = await res.json();
console.log(data);