Блог
hidden-dummy
Один API на три мессенджера: как построить омниканальную поддержку
Как подключить WhatsApp* Business API (WABA) за 1 день: пошаговая инструкция
Переход с WhatsApp* на MAX: как бизнесу не потерять клиентов в 2027 году
Шаблоны сообщений WABA*: как пройти модерацию Meta** с первого раза
ИИ-агент в WhatsApp*, Telegram и MAX: как уменьшить риск бана?
Как разработать приложение в чате WhatsApp*: кейс с Claude Code и GREEN-API
WhatsApp* переходит на “живое” общение: голосовые чаты теперь в любой группе
Отметки о прочтении в WhatsApp*: что значат галочки, как их отключить и как работать с ними через API
Авторы каналов в MAX теперь видят все
До свидания, Google! WhatsApp* готовит свое облако

Один API на три мессенджера: как построить омниканальную поддержку

Один API на три мессенджера: как построить омниканальную поддержку

Клиент пишет туда, где ему удобно: один — в WhatsApp*, другой — в Telegram, третий — в MAX. А оператор прыгает между приложениями и ищет вчерашний вопрос. Зачем бизнесу несколько каналов связи, мы уже разобрали. Здесь расскажем, как устроить омниканальную поддержку технически: принимать сообщения из всех мессенджеров в одну очередь, отвечать из одного окна и не писать отдельную интеграцию под каждый канал.

Содержание

Мультиканальность и омниканальность: в чём разница

Мультиканальная поддержка — это несколько каналов, которые работают отдельно: в каждом свой сотрудник, своя история и свои правила. Клиент, который вчера писал в WhatsApp, а сегодня в Telegram, для поддержки — два разных человека.

Омниканальность в поддержке клиентов начинается там, где каналы работают как одна система:

  • у клиента одна история во всех мессенджерах;
  • обращения из всех каналов попадают в одно окно — CRM, хелпдеск или панель оператора;
  • правила ответа и сроки везде одинаковые;
  • ответ уходит в тот мессенджер, откуда пришёл вопрос.

Почему отдельная интеграция под каждый мессенджер обходится дорого

Часто каждый мессенджер подключают через его собственный API. Через полгода у команды три интеграции, и каждую поддерживают отдельно.

  • Разные форматы сообщений. Текст, вложения и данные отправителя в каждом API описаны по-своему. Для каждого канала пишут свой парсер.
  • Разные вебхуки. Свои адреса, своя авторизация, своя логика повторной доставки.
  • Разные ошибки и лимиты. У каждого API свои коды ошибок и ограничения на частоту запросов.
  • Тройная работа. Каждую новую функцию поддержки делают трижды, а данные о клиенте расходятся по трём системам.

Архитектура омниканальной поддержки на одном API

Схема поддержки многоканального АПИ

Схема из пяти частей:

  1. Мессенджеры. Клиент пишет в WhatsApp, Telegram или MAX. У каждого аккаунта компании свой инстанс GREEN-API.
  2. Вебхуки. Все инстансы отправляют уведомления на один адрес вашего сервера. Его указывают в личном кабинете или в поле webhookUrl метода SetSettings.
  3. Обработчик. На сервере работает единый обработчик вебхуков. Он определяет канал и приводит сообщение к внутреннему формату.
  4. Очередь обращений. Сообщение попадает в очередь, CRM или хелпдеск. Оттуда его забирает бот или оператор.
  5. Ответ. Оператор отвечает в CRM или хелпдеске, где видны чаты из всех мессенджеров. Сервер отправляет ответ методом SendMessage через инстанс того канала, откуда пришёл вопрос.

Если сервер не принял уведомление, GREEN-API повторяет попытку раз в минуту и гарантирует доставку в течение суток. Поэтому сообщение может прийти дважды: проверяйте idMessage, чтобы не создавать дубли обращений.

Единый API для мессенджеров на практике

Методы. В GREEN-API у WhatsApp, Telegram и MAX одинаковые методы и поле typeInstance в вебхуке. Текст в любой мессенджер отправляет SendMessage с параметрами chatId и message по адресу {{apiUrl}}/waInstance{{idInstance}}/sendMessage/{{apiTokenInstance}}. Меняются только данные инстанса. Так же работают SendFileByUrl, SendTyping, ReadChat.

Канал в вебхуке. Мессенджер видно по полю instanceData.typeInstance: whatsapp, telegram или v3 для MAX. Типы уведомлений тоже общие, например incomingMessageReceived для входящего сообщения.

Различия, которые нужно учесть:

  • Формат chatId. В WhatsApp личный чат выглядит как 79001234567@c.us, группа заканчивается на @g.us. В Telegram и MAX суффиксов нет: chatId личного чата — число вроде 1234567890, а у группы оно со знаком минус. Не стройте логику на суффиксе @c.us.
  • Методы, которые есть не везде. API WhatsApp и Telegram совпадают не полностью: статусы, каталоги товаров и интерактивные кнопки есть только в WhatsApp. Реакции есть в WhatsApp и MAX, но не в Telegram. Проверка аккаунта в WhatsApp — CheckWhatsapp, в Telegram и MAX — CheckAccount.
  • Типы сообщений. Ответы на кнопки, заказы из каталога и приглашения в группу приходят только из WhatsApp. Незнакомый typeMessage обработчик пропускает и работает дальше. Иначе одно такое сообщение остановит приём остальных.

Вот обработчик на Python (Flask), который обслуживает все инстансы и отвечает в нужный канал:

from flask import Flask, request
import requests

app = Flask(__name__)
INSTANCES = {"1101000001": ("API_URL_WA", "TOKEN_WA"), # idInstance: (apiUrl, apiTokenInstance)
             "1101000002": ("API_URL_TG", "TOKEN_TG"),
             "1101000003": ("API_URL_MAX", "TOKEN_MAX")}

@app.post("/webhook")
def webhook():
    body = request.get_json()
    if body.get("typeWebhook") == "incomingMessageReceived":
        inst = body["instanceData"]
        save_ticket(id=body["idMessage"], channel=inst["typeInstance"], # whatsapp, telegram, v3
                    instance=str(inst["idInstance"]), chat_id=body["senderData"]["chatId"],
                    text=body["messageData"].get("textMessageData", {}).get("textMessage"))
    return "", 200

def reply(instance, chat_id, text):
    api_url, token = INSTANCES[instance]
    requests.post(f"{api_url}/waInstance{instance}/sendMessage/{token}",
                  json={"chatId": chat_id, "message": text})

save_ticket — ваша функция записи в базу, CRM или хелпдеск. Пример разбирает только простой текст, остальные типы добавляют по полю typeMessage.

Единый профиль клиента

У одного человека в каждом мессенджере свой chatId. Поэтому ключ профиля — ваш внутренний ID клиента, а chatId из разных каналов хранятся в профиле как привязки.

Склеить профили можно тремя способами:

  • По номеру телефона. В WhatsApp номер обычно виден в chatId, в вебхуках Telegram и MAX есть поле senderData.senderPhoneNumber. Храните номера в одном виде: только цифры с кодом страны.
  • По связке в CRM. Оператор видит, что клиент из Telegram писал и в WhatsApp, и объединяет карточки.
  • По данным из диалога. Если номера нет, бот в первом сообщении спрашивает номер заказа, телефон или email. Номера нет в двух случаях. В Telegram и MAX клиент может его скрыть — тогда senderPhoneNumber равен 0. В WhatsApp могут быть включены идентификаторы @lid (пока бета) — тогда в chatId вместо номера стоит идентификатор.

Не склеивайте профили только по имени. Разные клиенты с одинаковыми именами попадут в одну карточку, и оператор будет отвечать одному с оглядкой на другого.

Маршрутизация и SLA

Распределение. Раздавайте обращения по очереди, по загрузке или по навыкам: язык, тема, тип клиента. Если клиент недавно говорил с оператором, отдайте новое обращение тому же сотруднику, даже если оно пришло из другого мессенджера.

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

Время первого ответа. Таймер SLA стартует с поля timestamp в вебхуке, а не с момента, когда оператор открыл чат. Если срок на исходе, обращение поднимается в очереди или уходит старшему смены.

Передача от бота к оператору. Бот закрывает типовые вопросы. На стоп-слово вроде «оператор» или на вопрос вне базы знаний он передаёт диалог оператору вместе с историей. У чата появляется флаг «ведёт оператор», и бот молчит.

Метрики омниканальной поддержки

МетрикаКак считатьЧто показывает
Время первого ответа по каналамМедиана от входящего сообщения до первого ответаКакой канал проседает и когда
Доля решённых с первого обращенияДоля обращений без повторного вопроса за 3–7 днейРешает ли поддержка вопросы
Распределение обращений по мессенджерамДоля каждого канала по дням и часамСколько операторов нужно в смену
CSATОценка от 1 до 5 после закрытия обращенияНасколько довольны клиенты в каждом канале

Смотрите и повторные обращения в другом мессенджере: если их много, история теряется или один из каналов отвечает слишком медленно.

Ошибки в омниканальной поддержке

  • Разные ответы в разных каналах. Бот в Telegram обещает возврат за 14 дней, а оператор в WhatsApp говорит про 7. Нужна одна база знаний и одни шаблоны ответов.
  • Потерянная история при смене канала. Клиент повторяет всё заново, потому что профили не склеены. Это главный признак, что поддержка мультиканальная, а не омниканальная.
  • Бот не переключает на оператора. Клиент по кругу получает одно меню и уходит.
  • Ответ не в тот канал. Вопрос пришёл в MAX, а ответ ушёл в WhatsApp. Храните в обращении канал и инстанс и отвечайте только через них.

Омниканальная поддержка с GREEN-API

GREEN-API даёт API для WhatsApp, Telegram и MAX с одинаковыми методами и форматом вебхуков. Обработчик пишут один раз, а новый мессенджер добавляют как ещё один инстанс. Инстансы всех мессенджеров вы ведёте в одном личном кабинете и оплачиваете вместе. Попробовать можно на green-api.com.

Интеграция мессенджеров в CRM не всегда требует разработки: есть готовые интеграции с CRM, например с Bitrix24. Если вы делаете хелпдеск или платформу и подключаете много клиентов, пригодятся методы для партнёров: они создают и удаляют инстансы по API, без ручной работы в кабинете.

Вопросы и ответы

Чем омниканальность отличается от мультиканальности?

Мультиканальность — это несколько отдельных каналов связи. Омниканальность — одна история клиента и единое окно для мессенджеров, а ответ уходит туда, откуда пришёл вопрос.

Нужна ли отдельная CRM?

Не обязательно. На старте хватит базы данных с клиентами и обращениями. Оператору достаточно простой панели, где видны чаты и есть поле для ответа. Если CRM или хелпдеск уже есть, мессенджеры подключают к ним.

Можно ли подключить WABA и обычный WhatsApp API в одну схему?

Да. WABA — официальный API WhatsApp от Meta**. В GREEN-API у WABA тот же формат вебхуков и тот же метод SendMessage, поэтому её инстанс подключают к тому же обработчику. Учтите правила Meta: без шаблона отвечать можно только в течение 24 часов после последнего сообщения клиента, дальше — только шаблоном через SendTemplate. По документации typeInstance у WABA тоже whatsapp, поэтому её инстанс отличайте по idInstance.

Как определить, из какого мессенджера пришло сообщение?

По полю instanceData.typeInstance: whatsapp, telegram или v3 для MAX. Конкретный аккаунт показывает instanceData.idInstance.

Сколько стоит построить такую поддержку?

Платить придётся за три вещи: инстанс на каждый подключённый аккаунт, разработку обработчика и очереди (или готовую CRM с интеграцией) и работу операторов. С одним API вы экономите на разработке: обработчик пишут один раз, а не под каждый мессенджер. Тарифы — на сайте GREEN-API.


Подключите WhatsApp, Telegram и MAX к единой поддержке через один API — green-api.com.

Содержание раздела

Scroll to Top