Equipes e projetos
A equipe é dona dos membros, da cobrança, das chaves da equipe, dos projetos e do histórico de auditoria da equipe. As funções de membro disponíveis são Proprietário, Administrador e Membro. Um projeto agrupa recursos de mensagens, como sessões, tokens de projeto, webhooks, modelos, campanhas e configurações de integração. Os tokens de projeto ficam vinculados a um único projeto, por isso não autorizam o acesso aos recursos de outro projeto.Sessões
Uma sessão representa um número conectado. Cada sessão tem um identificador estável, usado em caminhos da Messaging API como/messaging/{session}/messages/send.
Os tipos públicos da Messaging API usam três estados de conexão:
Números novos recebem IDs opacos em formato de string decimal, qualquer que
seja a forma como foram criados. Mantenha os IDs como strings; não os converta
em números de JavaScript. Use
testMode para identificar números de teste. Os
números de teste são criados em um projeto de desenvolvimento e não iniciam uma
conexão real com o WhatsApp.
Credenciais
As operações públicas da Platform API em
/platform/* aceitam uma chave da
equipe ou um bearer do dashboard verificado. Elas recusam tokens de projeto. As
operações da Messaging API, do MCP e de bridge aceitam apenas os tipos de
credencial indicados na referência gerada de cada uma.
Toda credencial de serviço é um segredo do tipo bearer. Mantenha chaves da
equipe e tokens de projeto em servidores confiáveis, solicite apenas os escopos
necessários e revogue uma credencial quando ela puder ter sido exposta.
Consulte Autenticação para ver os nomes de escopo atuais
e as regras de público de cada API.
Mensagens e webhooks
Os endpoints de mensagens usam corpos de requisição e de resposta tipados para texto, mídia, localização, contato, enquete, reação e outras operações compatíveis. Use a referência gerada da Messaging API para ver os campos e os formatos exatos. Os webhooks entregam eventos no seu endpoint HTTPS. As entregas nativas usamX-Webhook-Signature; as entregas compatíveis com a Meta usam
X-Hub-Signature-256. Verifique a assinatura com o corpo bruto da requisição
antes de interpretá-lo. O guia de webhooks lista os nomes de
evento, os formatos e as configurações de novas tentativas atuais.
Versionamento
As requisições da Messaging API podem fixar a versão de data atual:vNN.0. Consulte
Versionamento para ver os padrões atuais e os cabeçalhos de
resposta.
Sandbox
O Sandbox oferece fluxos de trabalho com números de teste para projetos de desenvolvimento. Os números de teste gratuitos têm limite de 5 mensagens por segundo, 1 GB de armazenamento incluído, 5 chamadas recebidas e 5 chamadas feitas por mês e 1.000 execuções serverless por mês. Eles não incluem campanhas. As operações de pool, claim, dispositivo e mensagem do Sandbox têm rotas documentadas próprias; não presuma que toda operação de produção tem um equivalente simulado.Próximos passos
Início rápido
Faça sua primeira requisição autenticada.
Visão geral da API
Escolha o contrato de API correto.
Autenticação
Associe credenciais e escopos às rotas.
Sandbox
Teste com números de projetos de desenvolvimento.