O webhook history
O history carrega a transferência única das conversas que um número com Coexistência já tinha para a API. Ele chega depois da integração, quando o compartilhamento de histórico foi aceito, e é o único sinal que uma integração recebe de que a transferência aconteceu.
A janela depois da integração em que a sincronização precisa começar.
O erro devolvido quando a sincronização já foi usada.
O erro devolvido quando ela é tentada fora dessa janela.
O que ele entrega
O histórico de mensagens individuais que um número já tinha no app do WhatsApp Business, trazido para o outro lado, para que o software não comece às cegas em uma linha que uma empresa usa há anos.
O que não vem junto são as conversas em grupo, que ficam totalmente fora da API em um número com Coexistência, e as ferramentas do próprio app: etiquetas, respostas rápidas, mensagens de saudação e de ausência não têm equivalente na API e ficam no aparelho.
Este campo existe apenas em números com Coexistência. Um número integrado do jeito comum não tem histórico anterior de app para trazer, então não há nada para ele entregar.
Por que ele dispara uma vez só
Porque a transferência faz parte da integração, e não é uma capacidade contínua.
O dono do negócio é perguntado durante o Embedded Signup se quer compartilhar as conversas existentes. Responder que sim é o que permite a sincronização rodar, e não há configuração que ligue isso de novo depois nem endpoint que repita. Uma segunda tentativa devolve 2593107, e não um limite de taxa que passa.
Também existe um prazo. A sincronização precisa ser iniciada em até 24 horas da integração, e tentar depois devolve 2593108. Perder qualquer um dos dois significa desconectar o número e rodar o fluxo inteiro de novo.
O que um handler deve fazer com isso
Tratar como um lote que chega uma vez e pode ser grande, e não como mais tráfego no caminho de mensagem.
- Confirme rápido e processe de forma assíncrona, como em qualquer outra entrega.
- Elimine repetições pelo id da mensagem: o histórico e as mensagens ao vivo podem se sobrepor perto do momento da integração.
- Espere que ele não venha. Um número cujo dono recusou o histórico não envia nada aqui, e a integração precisa funcionar dos dois jeitos.
- Não bloqueie a integração por causa dele. A conexão já é utilizável antes de a transferência terminar.
Erros comuns
- Construir uma integração que exige a existência de histórico. Muitos números conectam sem ele.
- Repetir a sincronização depois do 2593107. É um evento único, então a repetição devolve o mesmo erro.
- Deixar a decisão sobre o histórico para quando o trabalho de integração começar, o que em geral é depois de a janela de 24 horas fechar.
A EasyCoexistence registra a integração e a escolha de histórico dela na linha do tempo da conexão, então se um número sincronizou, e em que dia, é um fato com data em vez de algo para reconstruir depois.
Perguntas frequentes
Quanto histórico chega?
Uma janela de conversas individuais recentes, definida pela Meta e não por um provedor.
As conversas em grupo vêm junto?
Não. Os grupos ficam totalmente fora da API em um número com Coexistência.
Posso pedir de novo mais tarde?
Não. Roda uma vez por integração, e rodar de novo significa desconectar e reconectar o número.
E se o dono recusou o histórico?
Nada chega neste campo, e a API vê apenas as mensagens a partir do momento em que o número conectou.
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