Pular para o conteúdo principal
O evento 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.
Na ação remove, o objeto contact traz apenas o phone_number: os campos full_name e first_name não são enviados. Identifique o contato pelo número.

Carga inicial

Na sincronização inicial, todos os contatos chegam com a ação add, 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 de smb_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.