Клиент пишет туда, где ему удобно: один — в WhatsApp*, другой — в Telegram, третий — в MAX. А оператор прыгает между приложениями и ищет вчерашний вопрос. Зачем бизнесу несколько каналов связи, мы уже разобрали. Здесь расскажем, как устроить омниканальную поддержку технически: принимать сообщения из всех мессенджеров в одну очередь, отвечать из одного окна и не писать отдельную интеграцию под каждый канал.
Содержание
Мультиканальность и омниканальность: в чём разница
Мультиканальная поддержка — это несколько каналов, которые работают отдельно: в каждом свой сотрудник, своя история и свои правила. Клиент, который вчера писал в WhatsApp, а сегодня в Telegram, для поддержки — два разных человека.
Омниканальность в поддержке клиентов начинается там, где каналы работают как одна система:
- у клиента одна история во всех мессенджерах;
- обращения из всех каналов попадают в одно окно — CRM, хелпдеск или панель оператора;
- правила ответа и сроки везде одинаковые;
- ответ уходит в тот мессенджер, откуда пришёл вопрос.
Почему отдельная интеграция под каждый мессенджер обходится дорого
Часто каждый мессенджер подключают через его собственный API. Через полгода у команды три интеграции, и каждую поддерживают отдельно.
- Разные форматы сообщений. Текст, вложения и данные отправителя в каждом API описаны по-своему. Для каждого канала пишут свой парсер.
- Разные вебхуки. Свои адреса, своя авторизация, своя логика повторной доставки.
- Разные ошибки и лимиты. У каждого API свои коды ошибок и ограничения на частоту запросов.
- Тройная работа. Каждую новую функцию поддержки делают трижды, а данные о клиенте расходятся по трём системам.
Архитектура омниканальной поддержки на одном API

Схема из пяти частей:
- Мессенджеры. Клиент пишет в WhatsApp, Telegram или MAX. У каждого аккаунта компании свой инстанс GREEN-API.
- Вебхуки. Все инстансы отправляют уведомления на один адрес вашего сервера. Его указывают в личном кабинете или в поле
webhookUrlметода SetSettings. - Обработчик. На сервере работает единый обработчик вебхуков. Он определяет канал и приводит сообщение к внутреннему формату.
- Очередь обращений. Сообщение попадает в очередь, CRM или хелпдеск. Оттуда его забирает бот или оператор.
- Ответ. Оператор отвечает в 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, requestimport requestsapp = 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 "", 200def 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.