Guia de integração oficial
WhatsApp Cloud API: do cadastro ao primeiro teste seguro
A conexão oficial exige ativos e credenciais da empresa na Meta. Criar a conta Yoco é rápido; aprovação, número e configuração de webhook dependem da Meta e do responsável pelo negócio.
1. Prepare os ativos
Confirme quem será o proprietário e evite contas pessoais sem governança.
- ✓Portfólio empresarial da Meta e usuários administradores.
- ✓Conta do WhatsApp Business e número elegível.
- ✓Nome de exibição, dados legais e método de pagamento quando aplicável.
2. Configure o aplicativo
Associe o produto WhatsApp, o número e as permissões necessárias. Use credenciais de produção apenas no servidor.
3. Proteja o webhook
Valide o token de verificação, confirme a assinatura de cada POST, rejeite eventos inválidos e processe identificadores de mensagem apenas uma vez.
4. Cadastre catálogo e regras
Produtos, preços, limites e critérios de atendimento humano devem estar prontos antes de habilitar respostas automáticas.
5. Teste antes de liberar
Execute casos normais e negativos.
- ✓Mensagem válida, repetida e assinatura inválida.
- ✓Produto inexistente, preço não confirmado e pedido de humano.
- ✓Falha do modelo, indisponibilidade da Meta e tentativa de reprocessamento.
6. Monitore
Acompanhe entrega, falha, tempo de resposta, transferências, correções e qualidade do catálogo. Rotacione credenciais quando houver troca de responsável ou suspeita de exposição.
Use sempre a documentação oficial
Precisa de onboarding acompanhado?
O piloto verifica credenciais, webhook, catálogo e conversa de teste sem expor chaves no navegador.
Solicitar onboarding