Erro 2593107 do WhatsApp: limite de sincronização excedido
O erro 2593107 significa que esse número já usou a sua única sincronização de contatos e histórico de conversas. A sincronização roda uma vez por onboarding e não pode ser repetida, então a única forma de rodar de novo é desconectar o número e conectar outra vez.
Código da Meta para ter excedido o limite de chamadas da API de sincronização em um número.
Quantas vezes contatos e histórico de conversas podem ser sincronizados por onboarding.
O código relacionado, devolvido quando a sincronização é tentada fora da janela de 24 horas dela.
Que sincronização é essa?
É a etapa que leva os contatos existentes e o histórico de conversas de um número em Coexistência para o lado da API, para que o software não comece cego em um número que a empresa usa há anos.
Isso só existe por causa da Coexistência. Um número integrado da forma comum não tem histórico anterior no app para trazer, e não há nada para sincronizar. Um número em Coexistência tem as duas coisas, e a Meta oferece uma transferência única delas no momento em que o número conecta.
É também por isso que o erro é desconhecido até para quem trabalha com a Cloud API há muito tempo. Ele pertence a um modo de onboarding que essas pessoas nunca usaram.
Por que ela só pode rodar uma vez?
Porque faz parte do onboarding e não é um recurso contínuo, e a Meta trata isso como uma decisão única tomada no momento da conexão.
O dono do negócio é perguntado durante o Embedded Signup se quer compartilhar o histórico de conversas existente. Responder que sim é o que permite a sincronização rodar. Não existe uma configuração para religar isso depois nem um endpoint que repita a operação, e é por isso que uma segunda chamada devolve esse erro, em vez de um limite de taxa que passa.
A consequência prática é que a escolha pesa mais do que parece na hora. Quem clica rápido pelo onboarding e recusa o histórico porque recusar parece mais seguro tomou uma decisão que só uma desconexão e reconexão completas conseguem rever.
E se você realmente precisar dela de novo?
O número tem de ser desconectado e conectado outra vez, o que é uma operação de verdade e não uma configuração.
Reconectar roda o Embedded Signup do começo, incluindo a leitura do código no celular, e dá uma nova oportunidade de aceitar o histórico. O app do WhatsApp Business não é afetado em nenhum momento, então a empresa não perde nada, mas também não é uma ação silenciosa de bastidor: alguém precisa estar com o celular na mão.
Há uma consequência que vale planejar. Uma desconexão remove o destino do webhook, porque esse destino vive como um override em uma assinatura de app e não no número. Reconectar restaura o envio e o monitoramento, mas não a entrega no seu próprio servidor, a menos que algo recoloque isso.
Erros comuns
- Repetir a chamada de sincronização. É um evento único, então a repetição devolve o mesmo erro em vez de acabar dando certo.
- Recusar o histórico de conversas durante o onboarding por precaução. Essa escolha só pode ser revista reconectando o número.
- Reconectar sem planejar restaurar o destino do webhook, que é desinstalado junto com o app.
A EasyCoexistence reaplica o destino de webhook de um número automaticamente depois de qualquer reconexão, porque o envio e o monitoramento voltam sozinhos e a entrega no seu servidor não.
Perguntas frequentes
Isso acontece em um número comum da Cloud API?
Não. A sincronização existe só para números em Coexistência, porque só eles têm histórico anterior no app para trazer.
Quanto histórico é sincronizado?
A Meta sincroniza uma janela de histórico recente de conversas no onboarding. O tamanho exato é definido pela Meta, e não por um provedor.
Reconectar vai perder minhas conversas no celular?
Não. O app do WhatsApp Business e as conversas dele não são tocados ao desconectar e reconectar o lado da API.
O 2593108 é o mesmo problema?
Não. Aquele significa que a sincronização foi tentada mais de 24 horas depois do onboarding, e não que ela já rodou.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em