Em Desenvolvedores > Credenciais, crie um token para a integração com messages:write. Copie-o na criação, guarde-o no backend e configure a conexão WhatsApp no painel antes de enviar.
API Developer
API para conectar o WhatsApp aos seus sistemas e aplicativos.
Integre CRM, ERP, aplicativos e sistemas internos ao WhatsApp com a API REST do WPP Marketing. Envie texto e mídia, consulte mensagens e acompanhe entregas de webhooks. Use também MCP para integrar seus fluxos à API Oficial. Conhecer o MCP.
Quando usar
Use a API de mensagens quando seu sistema precisa enviar WhatsApp.
Use seu CRM para iniciar um contato, seu ERP para enviar uma atualização ou seu aplicativo para avisar um cliente. A lógica de quando enviar fica no seu sistema; a API executa o envio pela conexão configurada na conta. Para automações comerciais prontas, use a Events API.
Use POST /send-text para texto ou POST /send-media para mídia. Na conexão oficial, texto e imagem usam os templates configurados; áudio, vídeo e documentos exigem uma mensagem recebida do cliente nas últimas 24 horas.
HTTP 200 indica aceitação, não entrega. Com messages:read, consulte GET /messages e acompanhe os status disponíveis para o canal.
Cadastre a URL HTTPS e habilite os eventos no painel. Use webhooks:read para consultar as tentativas em GET /webhooks; esse endpoint lista entregas, não cadastra assinaturas.
Do token ao primeiro envio acompanhado.
No seu servidor, substitua SEU_TOKEN pela credencial e o número pelo destinatário autorizado para o teste. Use uma chave exclusiva por envio e reutilize a mesma chave apenas ao repetir a mesma solicitação.
Confira o status HTTP e o corpo da resposta. Em 401, revise o token e sua validade; em 403, confira escopos e condições da conta. Em 409, verifique se a chave já foi usada com outro conteúdo. Em 429, respeite Retry-After antes de tentar novamente.
Depois, consulte GET /messages com messages:read ou acompanhe os webhooks configurados. A confirmação de entrega depende do retorno do canal.
cURLPOST /send-text
curl --request POST 'https://api.wppmarketing.com/send-text' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: pedido-10231-aviso-1' \
--data '{"number":"5511999999999","body":"Olá! Seu pedido foi atualizado."}'Texto, mídia, histórico e acompanhamento dos envios.
Use os endpoints REST para integrar o WhatsApp à sua aplicação. A API do WPP Marketing utiliza a conexão configurada na conta; para operar com a API Oficial do WhatsApp, configure essa conexão no painel. Consulte no OpenAPI os formatos, escopos, limites e respostas de cada operação.
POST
/send-text
Envia uma mensagem de texto para um número do WhatsApp.
Texto
POST
/send-media
Envia imagem, áudio, vídeo ou documento por URL pública HTTPS, conforme o formato e as condições da conexão. Áudio usa esse mesmo endpoint.
Mídia
GET
/messages
Consulta o histórico de mensagens enviadas com status e paginação.
Histórico
GET
/webhooks
Consulta as entregas de webhooks com evento, resultado HTTP, tentativas e paginação.
Webhooks
DOC
Swagger / OpenAPI
Documentação interativa com contratos, exemplos, campos obrigatórios e respostas esperadas.
Docs
Separação técnica
Escolha o recurso certo para cada etapa da integração.
Envie mensagens com a Messaging API, acione automações comerciais com a Events API e receba retornos com webhooks. Sua aplicação pode combinar esses recursos conforme o fluxo necessário.
A conexão oficial é o canal de comunicação; a API do WPP Marketing é a interface usada pelo seu sistema. Consulte os requisitos da API Oficial do WhatsApp e coexistência.
Seu sistema chama o WPP Marketing para enviar mensagens de texto ou mídia e consultar os históricos de mensagens e entregas de webhooks.
Seu sistema envia eventos comerciais, como pedido criado, pagamento aprovado, envio ou carrinho abandonado.
Entenda os eventos e as automações disponíveisO WPP Marketing retorna eventos padronizados de criação, entrega, leitura e erro para uma URL sua.
Veja os eventos de retorno e o acompanhamento de entregasUse a documentação interativa para validar payloads, autenticação e respostas antes de colocar em produção.
Tokens devem ficar no backend. Não exponha credenciais em páginas públicas, aplicativos front-end ou repositórios.
Em /send-text e /send-media, Idempotency-Key permite repetir a mesma solicitação com resposta bem-sucedida por até 48 horas. Reutilizar a chave com outro conteúdo retorna 409. Sem a chave, repetir a chamada pode duplicar o envio. Respeite os cabeçalhos RateLimit e Retry-After; os limites de requisições são diferentes da franquia do plano.
Uma credencial por integração, com as permissões necessárias.
No painel, dê um nome ao token, selecione os escopos e defina uma expiração opcional. O token completo aparece uma única vez na criação. A lista permite conferir último uso, expiração e revogar o acesso quando necessário.
Ao trocar uma credencial, atualize o segredo no seu servidor e revogue a anterior. Nunca use o token do provedor de WhatsApp no lugar da credencial da API.
Permite enviar texto e mídia. Conceda somente às integrações que precisam iniciar envios.
Permitem consultar, respectivamente, o histórico de mensagens e as entregas dos webhooks. Uma credencial de envio não recebe essas permissões automaticamente.
Permite informar clientes, carrinhos e pedidos pela Events API para as automações configuradas na conta.
Consulta configurações armazenadas, automações, contagens e registros recentes para diagnóstico. Pode incluir dados pessoais e conteúdo de mensagens: conceda somente a integrações e suporte autorizados. Essa consulta não verifica ao vivo a conexão com o provedor.
MCP e API Oficial do WhatsApp.
Conecte ferramentas de IA à sua operação de WhatsApp com o MCP do WPP Marketing. Integre o WhatsApp aos fluxos dos seus assistentes e agentes, com a API Oficial como conexão de mensagens.
MCP conecta os fluxos dos seus agentes à integração; a API de mensagens executa os envios e a conexão oficial segue as regras do WhatsApp. Isso não transforma o MCP em um chatbot nativo nem substitui a configuração da conta. A equipe orienta as ações e os requisitos da integração para seu caso de uso.
Use MCP como caminho de integração entre ferramentas de IA e o WhatsApp, complementando os fluxos dos seus sistemas e da sua equipe.
Converse com nossa equipe sobre a ferramenta de IA que você utiliza e as ações que deseja conectar ao WhatsApp. Confira os requisitos e o escopo adequado para sua operação.
Falar sobre integração MCPPronto para integrar seu sistema ao WPP Marketing?
Abra o Swagger para consultar endpoints da Messaging API, exemplos de payload, autenticação bearer token e respostas esperadas. Para eventos da loja e retorno de entrega, veja também Events API e Webhooks de status.