Erro 2593107 do WhatsApp: limite de sincronização excedido
O erro 2593107 indica que este número já usou a sua única sincronização de contactos e histórico de conversas. A sincronização ocorre uma vez por integração e não pode ser repetida, pelo que é necessário desligar o número e voltar a ligá-lo.
O código da Meta para exceder o limite de chamadas à API de sincronização num número.
Quantas vezes os contactos e o histórico de conversas podem ser sincronizados por integração.
O código relacionado devolvido quando a sincronização é tentada fora da janela de 24 horas.
A que sincronização se refere este erro?
É o passo que transporta os contactos existentes e o histórico de conversas de um número Coexistence para o lado da API, para que o software não comece sem contexto num número que uma empresa utiliza há anos.
Isto só existe devido à Coexistence. Um número integrado da forma habitual não tem histórico anterior da aplicação para transportar, pelo que não há nada para sincronizar. Um número Coexistence tem ambos, e a Meta disponibiliza uma transferência única no momento em que o número é ligado.
É também por isso que este erro é desconhecido até para quem trabalha com a Cloud API há muito tempo. Pertence a um modo de integração que nunca utilizou.
Porque só pode ser executada uma vez?
Porque faz parte da integração, e não de uma capacidade contínua, e a Meta trata-a como uma decisão única tomada no momento da ligação.
Durante o Embedded Signup, o proprietário da empresa é questionado sobre se pretende partilhar o histórico de conversas existente. Responder afirmativamente permite executar a sincronização. Não existe nenhuma definição para a reativar mais tarde nem nenhum endpoint que a repita. Por isso, uma segunda chamada devolve este erro, e não um limite de frequência que desaparece.
A consequência prática é que esta escolha é mais importante do que parece no momento. Ao avançar rapidamente na integração e recusar o histórico por parecer mais seguro, toma-se uma decisão que só pode ser revista desligando e voltando a ligar completamente o número.
O que acontece se for mesmo necessário repeti-la?
É necessário desligar o número e voltar a ligá-lo. Trata-se de uma operação real, não de uma definição.
Ao ligar novamente, o Embedded Signup é executado desde o início, incluindo a leitura do código no telemóvel, e surge uma nova oportunidade para aceitar o histórico. A aplicação WhatsApp Business permanece inalterada, pelo que a empresa não perde nada, mas esta não é uma ação silenciosa em segundo plano: é necessário estar junto do telemóvel.
Há uma consequência que convém planear. O desligamento remove o destino do webhook, porque esse destino existe como substituição numa subscrição da aplicação, e não no número. Ligar novamente restaura o envio e a monitorização, mas não a entrega no seu próprio servidor, a menos que algo volte a configurá-la.
Erros comuns
- Repetir a chamada de sincronização. É uma operação única, pelo que a nova tentativa devolve o mesmo erro em vez de ter sucesso mais tarde.
- Recusar o histórico de conversas durante a integração por precaução. Esta escolha só pode ser revista ligando novamente o número.
- Ligar novamente sem planear a reposição do destino do webhook, que é removido juntamente com a aplicação.
A EasyCoexistence repõe automaticamente o destino do webhook de um número após qualquer nova ligação, porque o envio e a monitorização regressam por si, mas a entrega no seu servidor não.
Perguntas frequentes
Isto acontece num número normal da Cloud API?
Não. A sincronização existe apenas para números Coexistence, porque só estes têm histórico anterior da aplicação para transportar.
Quanto histórico é sincronizado?
A Meta sincroniza uma janela do histórico recente de conversas durante a integração. A quantidade exata é definida pela Meta, e não por um fornecedor.
Ao ligar novamente, perco as conversas no telemóvel?
Não. A aplicação WhatsApp Business e as suas conversas não são alteradas ao desligar e voltar a ligar o lado da API.
2593108 é o mesmo problema?
Não. Esse código significa que a sincronização foi tentada mais de 24 horas após a integração, e não que já tinha sido executada.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em