O webhook smb_app_state_sync

O que ele carrega

Estado do lado do app, o que na prática quer dizer os contatos que uma empresa já tinha no celular.

Todo contato com um número de WhatsApp pode ser sincronizado para a plataforma, e é isso que permite ao software reconhecer um cliente que está na agenda da empresa há anos em vez de tratar como um número novo. Isso é diferente das conversas em si, que chegam no campo history, e os dois são separados porque um é uma lista de contatos e o outro é uma transcrição.

Assim como o history, isso só existe na Coexistência. Não há estado de app para sincronizar em um número que nunca esteve em um.

O que ele não carrega

As ferramentas de trabalho do próprio app, que não têm representação do lado da plataforma.

• Etiquetas, que ficam no aparelho e não podem ser lidas pelo software.
• Respostas rápidas e as mensagens de saudação e de ausência.
• O catálogo, os pedidos e o status.
• Canais, e o histórico de chamadas de voz ou de vídeo.

Por que isso importa para uma integração

Porque decide se o seu sistema sabe quem está escrevendo já no primeiro dia.

Sem a sincronização de contatos, cada mensagem recebida chega como um número de telefone sem nome nenhum, e casar isso com um registro de cliente é problema seu. Com ela, a lista de contatos da própria empresa fica disponível e o casamento já está quase todo feito.

Vale planejar para os dois casos, porque uma empresa pode recusar a sincronização ou perder a janela, e uma integração que presume que os contatos existem vai mostrar uma parede de números crus para quem abrir.

Erros comuns

• Presumir que os contatos vão estar lá. Uma empresa pode recusar a sincronização ou perder a janela dela.
• Esperar etiquetas ou respostas rápidas neste payload. Elas ficam no aparelho.
• Confundir com o history, que carrega conversas em vez da lista de contatos.

Perguntas frequentes

Continue lendo