Синхронизация данных между WhatsApp и Green-API#
Синхронизация данных обеспечивает корректное функционирование инстанса Green-API, включая отправку и приём сообщений, работу с контактами, шифрование и доступ к истории чатов.
Когда включается синхронизация?#
1. Подключение к инстансу#
При первом подключении к инстансу или повторной авторизации система автоматически инициирует синхронизацию:
- Загружаются все доступные контакты аккаунта,
- Подтягивается история сообщений,
- Проверяются и обновляются ключи шифрования.
2. Перенос аккаунта WhatsApp на другое устройство#
При переносе аккаунта WhatsApp на новое устройство:
- Генерируются новые ключи шифрования,
- Требуется повторная авторизация в Green-API,
-
Запускается синхронизация, включающая:
- Обновление ключей шифрования,
- Загрузку истории последних диалогов,
- Синхронизацию списка контактов.
Статус инстанса starting
#
Во время синхронизации инстанс переходит в статус starting
.
Это технический статус, означающий, что синхронизация активна.
- Обычно длится от нескольких секунд до пары минут
- В это время могут быть недоступны некоторые API-запросы
Если инстанс долго остаётся в статусе
starting
(более 5 минут), это может указывать на зависание. В таком случае рекомендуется выполнить перезагрузку инстанса.
Важные требования#
Внимание
Не закрывайте приложение и не прерывайте процесс, пока открыто окно синхронизации!
Приложение должно оставаться активным на экране — переход в фоновый режим, блокировка экрана или выключение устройства может прервать синхронизацию.
Пока синхронизация не завершена:
- Контакты не будут загружены
- История чатов не будет доступна
Если устройство не активно или выключено, синхронизация не завершится, а инстанс может остаться в статусе starting
.
Синхронизация завершается автоматически. После её завершения можно продолжить работу с инстансом.
Рекомендации#
1. Убедитесь, что устройство подключено к стабильному интернет-соединению
2. Дождитесь окончания синхронизации перед выполнением любых операций через API
3. При возникновении ошибок повторно выполните авторизацию