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