O webhook history
history transporta para a API a transferência única das conversas existentes de um número Coexistence. Chega após a integração inicial, quando a partilha do histórico foi aceite, e é o único sinal de que a transferência ocorreu.
A janela após a integração inicial em que a sincronização tem de começar.
O erro devolvido quando a sincronização já foi utilizada.
O erro devolvido quando é tentada fora dessa janela.
O que entrega
O histórico de mensagens um para um que um número já tinha na aplicação WhatsApp Business é transferido para que o software não comece às cegas numa linha que a empresa utiliza há anos.
As conversas de grupo não são transferidas: estão totalmente excluídas da API num número Coexistence. Também não são transferidas as ferramentas da aplicação: etiquetas, respostas rápidas e mensagens de saudação e ausência não têm equivalente na API e permanecem no dispositivo.
Este campo existe apenas em números Coexistence. Um número integrado da forma normal não tem histórico anterior da aplicação para transferir, pelo que nada há para entregar.
Porque só é enviado uma vez
Porque a transferência faz parte da integração inicial, não é uma capacidade contínua.
Durante o Embedded Signup, pergunta-se ao proprietário da empresa se pretende partilhar as conversas existentes. Responder afirmativamente permite executar a sincronização. Depois, não existe nenhuma definição para a reativar nem nenhum endpoint que a repita. Uma segunda tentativa devolve 2593107, em vez de aguardar por um limite de pedidos que desapareça.
Existe também um prazo. A sincronização tem de começar nas 24 horas seguintes à integração inicial; uma tentativa posterior devolve 2593108. Falhar qualquer uma destas condições implica desligar o número e repetir todo o processo.
O que um handler deve fazer com ele
Trate-o como um lote que chega uma vez e pode ser grande, não como mais tráfego no percurso das mensagens.
- Confirme rapidamente e processe de forma assíncrona, como qualquer outra entrega.
- Elimine duplicados com base em message id: as mensagens history e as mensagens em tempo real podem sobrepor-se no momento da integração inicial.
- Conte com a possibilidade de estar ausente. Um número cujo proprietário recusou o histórico não envia nada neste campo, e a integração tem de funcionar de qualquer forma.
- Não bloqueie a integração inicial à espera dele. A ligação pode ser utilizada antes de a transferência terminar.
Erros comuns
- Criar uma integração que exige a existência de histórico. Muitos números ligam-se sem ele.
- Tentar novamente a sincronização após 2593107. É um evento único, pelo que a nova tentativa devolve o mesmo erro.
- Adiar a decisão sobre o histórico até ao início do trabalho de integração, o que normalmente acontece depois de terminar a janela de 24 horas.
A EasyCoexistence regista a integração inicial e a escolha relativa ao histórico na linha cronológica da ligação. Assim, saber se um número foi sincronizado e em que dia é um facto datado, não algo a reconstruir mais tarde.
Perguntas frequentes
Quanto histórico chega?
Uma janela de conversas um para um recentes, definida pela Meta e não por um fornecedor.
As conversas de grupo são transferidas?
Não. Os grupos estão totalmente excluídos da API num número Coexistence.
Posso pedi-lo novamente mais tarde?
Não. É executado uma vez por integração inicial; executá-lo novamente implica desligar e voltar a ligar o número.
E se o proprietário recusar o histórico?
Nada chega neste campo, e a API vê apenas as mensagens recebidas a partir do momento em que o número foi ligado.
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