Интеграция с вашими системами и сервисами

Как подключить WhatsApp к вашей CRM, магазину или приложению через REST API и webhooks, какие типы сообщений доступны и как работает каскад WhatsApp → SMS.

Готовое рабочее место в FlowZap закрывает большинство задач. Но если у вас своя система — CRM, интернет-магазин, ERP или мобильное приложение — WhatsApp можно подключить к ней напрямую. У FlowZap открытый REST API и webhooks: вы управляете перепиской программно, прямо из своего кода.

Входящие сообщения клиентов мы передаём в вашу систему через webhook, а ваш backend отправляет ответы и шаблоны через JSON API. Поддерживаются все типы сообщений Meta — текст, медиа, документы, шаблоны.

Как устроена интеграция

Всё закрывают два простых механизма — приём и отправка:

Webhooks для входящих

Каждое новое сообщение клиента приходит в вашу систему мгновенно: текст, фото, голосовые, документы, геолокация — все типы.

REST API для отправки

Ваш backend отвечает клиентам и отправляет шаблоны обычным JSON-запросом. Полный программный контроль из любого приложения.

Все типы сообщений Meta

Текст, изображения, видео, документы, кнопки, списки и шаблоны всех категорий — без ограничений по формату.

Шаблоны всех категорий Meta

Через API доступны все категории шаблонных сообщений — под любую задачу:

Сервисные

Уведомления по заказу: подтверждение, статус, доставка, напоминания.

Авторизационные

Одноразовые коды доступа и подтверждение транзакций.

Маркетинговые

Акции, новости и рекламные рассылки по вашей базе.

Чем отличаются категории и как они влияют на цену — в статье Категории шаблонных сообщений.

Каскад WhatsApp → SMS: сообщение дойдёт всегда

Иногда WhatsApp недоступен — у клиента нет интернета или аккаунта на этом номере. Чтобы сообщение всё равно дошло, FlowZap поддерживает каскадную отправку: пробуем сначала дешёвый канал, и только если не получилось — резервный.

WhatsApp — основной канал. Дешевле и с богатым форматом: медиа, кнопки, шаблоны.
SMS — резерв. Включается автоматически, только если сообщение в WhatsApp не доставлено.

Надёжность

Сообщение гарантированно дойдёт: нет интернета, нет WhatsApp на номере или истёк срок жизни — система сама переключит на SMS.

Экономия бюджета

Сначала дешёвый WhatsApp, и только при недоставке — SMS. За недоставленные сообщения в WhatsApp вы не платите.

Гибкость и контроль

Свой текст для SMS отдельно от WhatsApp-шаблона. Подходит для сервисных и транзакционных уведомлений — кодов, статусов.

Простейшая интеграция

Вам нужно только отправить один запрос — выбор канала, повтор и резерв система берёт на себя.

Поможем с интеграцией

Не нужно разбираться в одиночку: мы консультируем по подключению, подсказываем по API и помогаем запустить интеграцию под вашу систему. Полная техническая документация и примеры — на нашем портале.

Подробнее об API

Примеры запросов на отправку

Простая интеграция не займёт много времени: отправка сообщения — это обычный JSON-запрос. Вот несколько готовых примеров, которые можно взять за основу:

Отправка изображения. Передаём картинку с подписью по прямой ссылке.

json

{
  "requestId": "test-001",
  "to": "77771234567",
  "content": {
    "whatsappContent": {
      "contentType": "image",
      "caption": "Мое изображение",
      "url": "https://kazinfoteh.kz/img/display.png"
    }
  }
}

Отправка шаблона авторизации с кодом доступа. В шаблон подставляется только сам код.

json

{
  "requestId": "test-001",
  "to": "77771234567",
  "content": {
    "whatsappContent": {
      "contentType": "AUTHENTICATION",
      "name": "MyAuth",
      "code": "999789"
    }
  }
}

Каскад: если WhatsApp не доставлен — уходит SMS. В одном запросе и WhatsApp-шаблон, и резервный текст для SMS.

json

{
  "requestId": "test-001",
  "to": "77771234567",
  "content": {
    "whatsappContent": {
      "contentType": "AUTHENTICATION",
      "name": "MyAuth",
      "code": "999789"
    },
    "smsContent": {
      "typeSend": "0",
      "sender": "ZagolovokSMS",
      "msg": "Ваш код: 999789"
    }
  }
}

За недоставленные сообщения в WhatsApp платы нет. SMS тарифицируются за все отправленные сообщения.

Частые вопросы

Для работы в готовом интерфейсе FlowZap — нет. Интеграция по API нужна, только если вы хотите подключить WhatsApp к своей системе; тогда её настраивает ваш разработчик, а мы помогаем консультацией.

Это автоматическое уведомление: как только клиент пишет вам в WhatsApp, мы мгновенно отправляем это сообщение в вашу систему — вам не нужно ничего опрашивать вручную.

Сообщение сначала уходит в WhatsApp. Если оно не доставлено (нет интернета или WhatsApp на номере), система автоматически отправляет SMS. За недоставленный WhatsApp вы не платите — только за реально доставленные сообщения.

Готовы подключить официальный WhatsApp Business API?

Начать в FlowZap