Ошибка WhatsApp 2593107: превышен лимит синхронизации

О какой синхронизации идёт речь?

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

Такая возможность существует только благодаря Coexistence. При обычном подключении номера прежней истории приложения нет, поэтому переносить нечего. У номера Coexistence есть и контакты, и история, а Meta предлагает перенести их один раз в момент подключения номера.

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

Почему синхронизация выполняется только один раз?

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

Во время Embedded Signup владельца бизнеса спрашивают, нужно ли предоставить существующую историю чатов. Ответ «да» позволяет запустить синхронизацию. Настройки для повторного включения позже нет, как нет и эндпоинта для повторного запуска. Поэтому второй вызов возвращает эту ошибку, а не временное ограничение частоты запросов.

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

Что делать, если синхронизация снова нужна?

Номер нужно отключить и подключить заново. Это полноценная операция, а не изменение настройки.

При повторном подключении Embedded Signup запускается сначала, включая сканирование кода на телефоне, и появляется новая возможность принять историю. Приложение WhatsApp Business при этом не затрагивается, поэтому бизнес ничего не теряет. Однако это не фоновое действие: кто-то должен находиться у телефона.

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

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

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

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

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