Use o token bearer gerado no painel para autorizar chamadas de servidor para servidor.
API Developer
API de mensagens para integrar WhatsApp ao seu ERP, CRM ou sistema.
A API Developer do WPP Marketing permite que ERP, CRM, loja customizada ou sistema interno envie mensagens pelo WhatsApp e consulte os históricos de mensagens e entregas de webhooks usando endpoints REST, autenticação bearer token e documentação Swagger.
Quando usar
Use a API de mensagens quando seu sistema precisa enviar WhatsApp.
A API Developer é indicada para ERP, CRM, loja customizada, backoffice ou sistema próprio que precisa iniciar mensagens. Eventos comerciais e retornos de entrega usam, respectivamente, Events API e webhooks de status.
Dispare mensagens operacionais dentro das regras e janelas permitidas do WhatsApp.
Consulte o histórico de mensagens enviadas e seus status usando o endpoint GET /messages.
Configure os eventos de retorno e consulte o resultado das entregas usando o endpoint GET /webhooks.
O que esta página cobre.
Esta página apresenta os endpoints da API Developer para envio de mensagens e consulta dos históricos. Events API e o recebimento de webhooks de status possuem páginas próprias.
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 usando uma URL pública HTTPS.
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
API Developer não substitui Events API nem webhooks de status.
Cada recurso tem uma direção diferente. Essa separação evita integrações frágeis e deixa claro quem chama quem em cada fluxo.
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.
O WPP Marketing retorna eventos padronizados de criação, entrega, leitura e erro para uma URL sua.
Use 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.
Registre logs, trate erros de API, respeite limites operacionais e valide números antes de disparos sensíveis.
Pronto 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.