Справочник по Coexistence

Что это такое

Официальный режим Meta для одновременной работы приложения WhatsApp Business и Cloud API на одном номере. Это не отдельный API, а тот же Cloud API, подключённый так, чтобы приложение продолжило работать на номере.

Зачем команды это используют

Почти каждое подключение объясняется четырьмя причинами.

• Сохранить номер, уже напечатанный на машинах, чеках и сайте.
• Добавить отправку через API, вебхуки и шаблоны без перехода на новый инструмент.
• Оставить переписки вне общего входящего ящика провайдера.
• Позволить агентству хранить много номеров клиентов, каждый в собственном Business Portfolio клиента.

Как работает общение

Обе поверхности видят одну переписку. То, что отправлено через API, появляется в приложении. То, что команда вводит в приложении, поступает в программу как событие smb_message_echoes, которое не даёт автоматизации ответить поверх человека.

Как устроена оплата

Meta тарифицирует диалоги, а не сообщения, и списывает оплату с метода оплаты вашего WhatsApp Business Account. Ответы в течение 24 часов окна обслуживания клиентов бесплатны. Для начала диалога после этого окна нужен шаблон, за который взимается плата.

Подключённые устройства

Coexistence не является подключённым устройством и не использует его. Подключённое устройство является клиентом для частных пользователей, где выполнен вход в другом месте. Именно это автоматизируют неофициальные инструменты, что запрещено условиями WhatsApp. Здесь этот механизм не используется.

Функциональные ограничения

Ограничения установлены Meta и одинаковы у всех провайдеров.

• Групповые чаты недоступны через API.
• Шаблоны нельзя отправлять из приложения на телефоне, только через API.
• Пропускная способность отправки фиксирована и не растёт вместе с рейтингом качества и уровнем.
• Решение о передаче истории чатов принимается один раз при подключении.

Требования

Перед подключением номер должен соответствовать всем условиям.

• Номер уже активен в приложении WhatsApp Business, а не в приложении для частных пользователей.
• Номер находится в доступном вам Business Portfolio.
• Номер ещё не подключён к приложению другого провайдера.

Операционные нюансы

После подключения происходят вещи, которые легко не заметить.

• Приложение нужно периодически открывать, иначе Meta отключит сторону API.
• При отключении переопределение вебхука удаляется вместе с приложением.
• Рейтинг качества проверяется запросами, а не отправляется автоматически, поэтому падение не сопровождается оповещением.
• Отозванный токен выглядит так же, как удалённый номер, если нет второй учётной записи для проверки.

Нюанс выбора аккаунта

Во время Embedded Signup Business Portfolio и WhatsApp Business Account выбираются на разных шагах. Ошибочный выбор прикрепит номер не туда, куда вы планировали, а перенос потребует отключения и повторного прохождения всего процесса.

Односторонние решения

Передача существующей истории чатов запрашивается один раз и не может быть изменена позже. Синхронизация также должна начаться в течение 24 часов после подключения и может выполняться только один раз. При пропуске оба процесса выдают непонятные ошибки вместо предупреждений.

Отключение или возврат

Номер можно отключить в любой момент через панель управления или коннектор. Приложение WhatsApp Business продолжит работать как раньше, а переписки и история сохранятся. Сам номер не изменится навсегда из-за подключения.

Распространённые ошибки

• Считать Coexistence отдельным API. Это Cloud API с другим подключением.
• Строить процесс вокруг групповых чатов. Они исключены у всех провайдеров.
• Предполагать, что повторное подключение восстановит адрес назначения вебхука. Это не так.

Часто задаваемые вопросы

Читайте дальше