O webhook smb_app_state_sync
smb_app_state_sync transporta o estado da própria aplicação WhatsApp Business, sobretudo a sincronização de contactos feita quando se liga um número de Coexistência. É separado de history, que transporta conversas, e existe apenas em números de Coexistência.
Campos de sincronização específicos da Coexistência: este e history.
A janela após a integração em que a sincronização tem de começar.
Equivalente num número integrado sem Coexistência.
O que transporta
Estado do lado da aplicação, que na prática significa os contactos que uma empresa já tinha no telemóvel.
Todos os contactos com um número WhatsApp podem ser sincronizados com a plataforma. Isto permite ao software reconhecer um cliente que está há anos no telemóvel da empresa, em vez de o tratar como um número novo. É diferente das próprias conversas, que chegam no campo history. Os dois são separados porque um é um diretório e o outro é uma transcrição.
Tal como history, este campo só existe na Coexistência. Não há estado da aplicação para sincronizar num número que nunca esteve numa aplicação.
O que não transporta
As ferramentas de trabalho da própria aplicação, que não têm representação do lado da plataforma.
- Etiquetas, que ficam no dispositivo e não podem ser lidas pelo software.
- Respostas rápidas e mensagens de saudação e de ausência.
- O catálogo, as encomendas e o estado.
- Canais e histórico de chamadas de voz ou vídeo.
Porque é importante para uma integração
Porque determina se o seu sistema sabe quem está a escrever desde o primeiro dia.
Sem a sincronização de contactos, cada mensagem recebida chega como um número de telefone sem nome associado, e cabe-lhe relacioná-lo com um registo de cliente. Com a sincronização, a própria lista de contactos da empresa fica disponível e a correspondência está praticamente feita.
Vale a pena planear para os dois cenários, porque uma empresa pode recusar a sincronização ou perder a janela. Uma integração que presuma a existência de contactos mostrará uma parede de números sem nome a quem a abrir.
Erros comuns
- Pressupor que os contactos estarão disponíveis. Uma empresa pode recusar a sincronização ou perder a janela.
- Esperar etiquetas ou respostas rápidas neste payload. Permanecem no dispositivo.
- Confundir este campo com history, que transporta conversas e não a lista de contactos.
A EasyCoexistence subscreve os campos operacionais e regista a sequência de integração, para que seja visível na linha temporal o que um número sincronizou ou não.
Perguntas frequentes
É o mesmo que a sincronização de history?
Não. Este campo transporta o estado da aplicação, sobretudo contactos. history transporta as conversas.
É executado mais do que uma vez?
A sincronização inicial ocorre uma única vez durante a integração, com a mesma janela de 24 horas que history.
Recebo as etiquetas?
Não. As etiquetas são uma funcionalidade da aplicação sem equivalente na API.
Existe num número normal da Cloud API?
Não. Não há estado da aplicação WhatsApp Business para sincronizar num número desse tipo.
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