Disparar sincronização
POST/v1/:phone_number_id/smb_app_data
Dispara a sincronização do histórico de conversas ou da lista de contatos do WhatsApp Business App para a Cloud API.
Cada tipo (history e smb_app_state_sync) pode ser disparado uma única
vez por integração, e só dentro de 24 horas após o Embedded Signup.
Errou ou perdeu o prazo, o cliente precisa refazer o onboarding completo.
A resposta é imediata e apenas confirma o agendamento. Os dados chegam depois, em múltiplos webhooks assíncronos — leia a descrição da seção Espelho · Sincronização para saber como montar as conversas a partir deles.
Request
Responses
- 200
- 401
- 403
- 429
- 502
Resposta da Meta Cloud API, repassada sem alteração. O formato depende do endpoint — consulte a documentação oficial da Meta.
Response Headers
Categoria do limite aplicada — send, media ou default.
Qual balde os outros headers descrevem — key (a API key), session (o painel) ou account (o teto da conta).
Teto de requisições da categoria na janela atual.
Requisições restantes na janela atual.
Token ausente, malformado, desconhecido ou revogado (authentication), ou
conta suspensa (tenant_inactive).
O recurso informado não pertence à sua conta (forbidden), ou o caminho está
na lista de bloqueio do espelho (forbidden_endpoint), ou a sua API key é restrita a
alguns números e a operação é da conta inteira (forbidden).
Limite de requisições excedido (rate_limit).
Response Headers
Segundos a aguardar antes de tentar de novo.
Categoria do limite aplicada — send, media ou default.
Qual balde os outros headers descrevem — key (a API key), session (o painel) ou account (o teto da conta).
Teto de requisições da categoria na janela atual.
Requisições restantes na janela atual.
Não foi possível alcançar a Meta (upstream_error), ela respondeu com erro
5xx (meta_error) ou demorou mais de 30 segundos.