WhatsApp Cloud API или Coexistence: что нужно номеру

Cloud API и Coexistence действительно разные вещи?

Нет, и такая формулировка часто вводит в заблуждение. Cloud API это размещённая Meta платформа WhatsApp Business. Coexistence это режим подключения номера к тому же API, при котором приложение WhatsApp Business продолжает работать с этим номером.

Эндпоинты одинаковые, формат сообщений одинаковый, шаблоны работают одинаково, а окно 24 часа применяется по одним правилам. Всё, что написано для одного варианта, работает и для другого.

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

Когда обычный Cloud API лучше подходит?

Когда на этот номер никто не должен отвечать вручную. Такое бывает чаще, чем кажется.

Номеру для уведомлений, который отправляет только обновления по заказам, не нужно сохранять работу человека. Новый номер, купленный специально для интеграции, раньше ни в чьём приложении не использовался. Линия поддержки с большим объёмом обращений, которая уже работает через сервис поддержки, имеет отдельный рабочий процесс, и возвращать туда приложение WhatsApp Business означало бы раздробить его.

В таких случаях Coexistence без причины добавляет ограничение: пропускная способность номера Coexistence фиксирована Meta и не растёт вместе с рейтингом качества и уровнем сообщений, а периодическое требование активности устройства становится лишней обязанностью.

Когда Coexistence единственный рабочий вариант?

Когда номер уже используется бизнесом и человек уже отвечает с него.

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

Coexistence устраняет этот компромисс. Приложение продолжает работать, команде не нужно учиться чему-то новому, а программное обеспечение получает тот же API.

Можно ли позже перевести номер с одного варианта на другой?

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

Когда номер впервые подключается через Coexistence, Meta спрашивает, нужно ли передать существующие разговоры в API. Это решение принимается один раз при подключении, и позже вернуться к нему нельзя. Если отказаться, а затем понадобятся прежние разговоры, единственный путь это отключить номер и подключить его снова.

Поэтому внимательно выбирать нужно не режим подключения. Важно решить, соглашаться ли на передачу истории в этот день, поскольку изменить этот выбор позже нельзя.

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

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

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

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