● Self-hosted · Laravel · Meta WhatsApp Cloud API

Bring WhatsApp conversations into
your Bitrix24 Contact Center

A self-hosted bridge that lands inbound WhatsApp messages in a Bitrix24 Open Channel — auto-creating a Lead per new customer — and relays your operators' replies straight back to the customer on WhatsApp.

💬
Customer
WhatsApp
☁️
Meta Cloud API
Graph / webhook
🔗
This Bridge
Laravel · HTTPS
🟦
Bitrix24
Contact Center
Capabilities

Everything the bridge handles for you

Built for reliability — no inbound message is silently lost, no outbound reply is silently duplicated.

↔️

Two-way messaging

Inbound WhatsApp → Open Channel, and operator replies → WhatsApp, end to end as text.

🧲

Auto Lead creation

Each new customer number auto-creates a Bitrix Lead in the Contact Center.

🔁

Self-healing delivery

Queued jobs retry with backoff and dead-letter on terminal failure — recoverable, never lost.

🧬

Idempotent & deduped

Inbound deduped on wamid, outbound on the Bitrix message id — no doubles on re-delivery.

🔐

Encrypted credentials

Secrets live encrypted in the DB, edited via a token-gated admin form — .env is only a fallback.

🔑

Auto token refresh

The Bitrix OAuth grant is refreshed proactively and on demand — sending keeps working past the hourly expiry.

🩺

Audit log & health

Every webhook is recorded with a correlation id; /health exposes DB, queue depth & failures.

🛟

Disaster recovery

Raw payloads are persisted and replayable; PII is pruned automatically on a schedule.

Architecture

How a message flows

Two independent, queue-backed pipelines — each audited and idempotent.

INBOUND Customer → Operator

  1. Customer messages your WhatsApp business number.
  2. Meta calls POST /webhook/whatsapp (HMAC-verified, audit-logged).
  3. The message is deduped on wamid and queued.
  4. imconnector.send.messages drops it into the Open Channel.
  5. Operator sees it — a Lead is auto-created for new customers.

OUTBOUND Operator → Customer

  1. Operator replies inside the Bitrix Open Channel.
  2. Bitrix fires OnImConnectorMessageAddPOST /bitrix/events (token-gated).
  3. The reply is deduped on the Bitrix message id and queued.
  4. Meta Graph /{phone-number-id}/messages delivers it.
  5. Customer receives the reply on WhatsApp (within the 24h window).

Ready to wire it up?

The documentation walks through install, connector activation, credentials and verification — step by step.

Open the documentation →