smb_app_state_sync entrega os contatos da agenda do aplicativo do WhatsApp Business. Ele é usado em dois momentos:
- Na carga inicial, após a sincronização ser solicitada em Sincronizar contatos.
- No dia a dia, sempre que um contato é adicionado, editado ou removido no celular.
Campos
A edição de um contato chega como
add, com os dados já atualizados. Trate o add como inclusão ou atualização, usando o phone_number como identificador.Carga inicial
Na sincronização inicial, todos os contatos chegam com a açãoadd, na lista state_sync. Diferente do histórico de conversas, não há divisão em blocos nem campo de progresso: a agenda vem junta, em uma única entrega.
Contato na agenda não significa conversa iniciada. Enviar mensagem para esses números continua sujeito à janela de 24 horas, o que exige um template aprovado quando não há conversa aberta.
Se a entrega falhar
As entregas desmb_app_state_sync que falham são reenviadas automaticamente, com intervalos crescentes: 10s, 1min, 5min e 30min. Enquanto a sua URL responder 200, a entrega é concluída normalmente.
Como a carga inicial é uma sincronização única, se a URL ficar indisponível além dessa janela a forma garantida de recuperar a agenda é desconectar o número e refazer a conexão, solicitando a sincronização de novo.
A referência completa está na documentação do webhook smb_app_state_sync da Meta.