Вебхук smb_app_state_sync
smb_app_state_sync передаёт состояние самого приложения WhatsApp Business, прежде всего синхронизацию контактов при подключении номера Coexistence. Это отдельное поле от history, где передаются диалоги, и оно есть только у номеров Coexistence.
Специальные поля синхронизации Coexistence: это поле и history.
Окно после подключения, в течение которого должна начаться синхронизация.
Эквивалент для номера, подключённого без Coexistence.
Что оно передаёт
Состояние со стороны приложения, то есть на практике контакты, которые компания уже хранила в телефоне.
Каждый контакт с номером WhatsApp можно синхронизировать с платформой. Благодаря этому программа узнаёт клиента, который годами был в телефоне компании, вместо того чтобы считать его новым номером. Это не то же самое, что сами диалоги: они приходят в поле history. Поля разделены, потому что одно содержит справочник, а другое является расшифровкой диалогов.
Как и history, это поле есть только у Coexistence. На номере, который никогда не был подключён к приложению, нечего синхронизировать из состояния приложения.
Что оно не передаёт
Рабочие инструменты самого приложения, которым нет соответствия на стороне платформы.
- Метки, которые хранятся на устройстве и недоступны программе.
- Быстрые ответы, приветственное сообщение и сообщение об отсутствии.
- Каталог, заказы и статусы.
- Каналы, а также история голосовых и видеозвонков.
Почему это важно для интеграции
От этого зависит, будет ли ваша система знать, кто пишет, уже в первый день.
Без синхронизации контактов каждое входящее сообщение приходит как номер телефона без имени, и сопоставлять его с карточкой клиента приходится вам. При синхронизации доступен собственный список контактов компании, поэтому сопоставление в основном выполняется автоматически.
Стоит учитывать оба сценария: компания может отклонить синхронизацию или пропустить окно. Интеграция, которая предполагает наличие контактов, покажет пользователю целую стену необработанных номеров.
Распространённые ошибки
- Считать, что контакты будут доступны. Компания может отклонить синхронизацию или пропустить её окно.
- Ожидать метки или быстрые ответы в этом поле. Они остаются на устройстве.
- Путать это поле с history, где передаются диалоги, а не список контактов.
EasyCoexistence подписывается на операционные поля и фиксирует последовательность подключения, поэтому на временной шкале видно, что именно номер синхронизировал или не синхронизировал.
Часто задаваемые вопросы
Это то же самое, что синхронизация history?
Нет. Это поле передаёт состояние приложения, прежде всего контакты. history передаёт диалоги.
Оно запускается несколько раз?
Первичная синхронизация выполняется один раз при подключении, в том же окне 24 часа, что и history.
Метки будут доступны?
Нет. Метки являются функцией приложения и не имеют эквивалента в API.
Это поле есть у обычного номера Cloud API?
Нет. У такого номера нет состояния приложения WhatsApp Business, которое можно синхронизировать.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на