Перейти к содержанию

Синхронизация данных между WhatsApp и Green-API#

Синхронизация данных обеспечивает корректное функционирование инстанса Green-API, включая отправку и приём сообщений, работу с контактами, шифрование и доступ к истории чатов.

Когда включается синхронизация?#

1. Подключение к инстансу#

При первом подключении к инстансу или повторной авторизации система автоматически инициирует синхронизацию:

  1. Загружаются все доступные контакты аккаунта,
  2. Подтягивается история сообщений,
  3. Проверяются и обновляются ключи шифрования.

2. Перенос аккаунта WhatsApp на другое устройство#

При переносе аккаунта WhatsApp на новое устройство:

  1. Генерируются новые ключи шифрования,
  2. Требуется повторная авторизация в Green-API,
  3. Запускается синхронизация, включающая:

    • Обновление ключей шифрования,
    • Загрузку истории последних диалогов,
    • Синхронизацию списка контактов.

Статус инстанса starting#

Во время синхронизации инстанс переходит в статус starting.
Это технический статус, означающий, что синхронизация активна.

  • Обычно длится от нескольких секунд до пары минут
  • В это время могут быть недоступны некоторые API-запросы

Если инстанс долго остаётся в статусе starting (более 5 минут), это может указывать на зависание. В таком случае рекомендуется выполнить перезагрузку инстанса.

Важные требования#

Внимание

Не закрывайте приложение и не прерывайте процесс, пока открыто окно синхронизации!

Приложение должно оставаться активным на экране — переход в фоновый режим, блокировка экрана или выключение устройства может прервать синхронизацию.

Пока синхронизация не завершена:

  • Контакты не будут загружены
  • История чатов не будет доступна

Если устройство не активно или выключено, синхронизация не завершится, а инстанс может остаться в статусе starting.

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

Рекомендации#

1. Убедитесь, что устройство подключено к стабильному интернет-соединению
2. Дождитесь окончания синхронизации перед выполнением любых операций через API
3. При возникновении ошибок повторно выполните авторизацию