Erro 2593108 do WhatsApp: sincronização fora da janela de 24 horas
O erro 2593108 significa que a sincronização de contatos e histórico de conversas foi iniciada mais de 24 horas depois de o número ter passado pelo onboarding. Essa janela é fixada pela Meta, e depois que ela passa a única forma de sincronizar é conectar o número de novo.
Código da Meta para uma sincronização iniciada depois de 24 horas do onboarding.
Até quanto tempo depois do onboarding a sincronização de contatos e histórico pode ser iniciada.
O código relacionado, devolvido quando a sincronização já foi usada.
De que janela de 24 horas estamos falando?
Não é a de mensagens, e é daí que vem quase toda a confusão em torno desse erro.
A WhatsApp Business Platform tem uma janela de atendimento de 24 horas bastante conhecida, contada a partir da última mensagem do cliente, que determina se é possível enviar texto livre. Este é um relógio completamente diferente. Ele conta a partir do momento em que um número em Coexistência concluiu o onboarding, e determina apenas se os contatos e o histórico de conversas ainda podem ser trazidos.
Os dois não têm nada a ver um com o outro além do número, e uma mensagem enviada com sucesso não é indício nenhum de que a janela de sincronização continua aberta.
Por que ela passa despercebida?
Porque o onboarding e a integração costumam acontecer em dias diferentes, e muitas vezes com pessoas diferentes.
Uma sequência típica é o dono do negócio conectar o número à tarde e uma agência ou um desenvolvedor ligar isso aos sistemas dele mais adiante na mesma semana. Quando alguém enfim pensa no histórico, a janela já fechou, e a falha chega como um código de erro desconhecido em vez de como um aviso.
Vale tratar a sincronização como parte do onboarding, e não como parte da integração. Se o histórico importa de alguma forma, ele tem de ser puxado no mesmo dia em que o número conecta, antes de qualquer outra coisa ser construída.
Quais são as opções depois que ela fecha?
Desconectar e conectar o número de novo, ou aceitar começar sem histórico.
Reconectar reinicia o Embedded Signup, incluindo a leitura no celular, e abre uma janela nova. Nada no app do WhatsApp Business é afetado, então a empresa mantém as conversas dela de qualquer jeito. O que isso custa é alguém estar de novo com o celular na mão.
Começar sem histórico costuma ser tranquilo. A API recebe tudo a partir do momento em que é conectada, e a maioria das integrações se importa com conversas novas, não com as antigas. O histórico importa mais quando algo precisa consultar o contexto passado de um cliente na hora, o que é um caso mais restrito do que parece à primeira vista.
Erros comuns
- Confundir isso com a janela de mensagens. São relógios separados medindo coisas diferentes.
- Deixar o histórico para quando o trabalho de integração começar. A essa altura a janela já costuma estar fechada.
- Reconectar sem restaurar o destino do webhook, que não sobrevive a uma desconexão.
A EasyCoexistence registra o onboarding de cada conexão na linha do tempo dela, então o dia em que um número conectou fica visível, em vez de ser algo para reconstruir depois.
Perguntas frequentes
Essas 24 horas são as mesmas da janela de mensagens?
Não. Estas contam a partir do onboarding e governam a sincronização. A janela de mensagens conta a partir da última mensagem do cliente e governa o texto livre.
A janela pode ser estendida?
Não. Ela é definida pela Meta e nenhum provedor consegue alongar.
Reconectar custa alguma coisa?
Nada é cobrado pela reconexão. O custo é alguém estar presente junto ao celular para ler o código de novo.
E se eu nunca sincronizar o histórico?
A API continua recebendo tudo a partir do momento em que o número conecta. O histórico só importa se algo precisa do contexto passado na hora.
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