Integre WhatsApp, SMS e Email em minutos
APIs REST v4 simples, documentadas e prontas para producao. Autenticacao JWT, webhooks, envio em massa e muito mais.
- Autenticacao JWT Bearer segura
- Webhooks em tempo real para todos os eventos
- Sandbox gratuito, sem cartao de credito necessario
- Documentacao completa OpenAPI 3.0
Integre em 3 passos
De zero a mensagens enviadas em menos de 10 minutos.
Obtenha seu token
Chame o endpoint de autenticacao com suas credenciais para obter um token JWT para usar em todas as solicitacoes subsequentes.
{"username":"...","password":"..."}
→ {"token": "eyJh..."}
Envie sua primeira mensagem
Use o token no cabecalho Authorization e chame o endpoint para enviar uma mensagem WhatsApp, SMS ou Email.
Authorization: Bearer <token>
→ {"status": "sent"}
Receba eventos
Configure um webhook para receber mensagens recebidas, confirmacoes de entrega e atualizacoes de status em tempo real.
"url": "https://your-app.com/hook"
→ {"status": "active"}
Autenticacao JWT Bearer
Todas as APIs da Chat API usam tokens JWT. Gere seu token com uma unica chamada POST e inclua-o no cabecalho Authorization de cada solicitacao.
Expiracao configuravel
Os tokens expiram apos um periodo configuravel. Regenere automaticamente via API sem interrupcao.
HTTPS necessario
Todas as comunicacoes acontecem via HTTPS com TLS 1.2+. Nenhuma chamada em texto simples e aceita.
Credenciais seguras
Nome de usuario e senha sao trocados apenas uma vez para obter o token usado nas chamadas de API.
{
"username": "your@email.com",
"password": "your-password"
}{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...",
"expiresIn": 3600,
"type": "Bearer"
}Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...Todos os endpoints disponiveis
Cada endpoint e documentado com parametros, respostas e exemplos em nossa documentacao OpenAPI.
Enviar mensagem
/api/v4/whatsapp/chats/{id}/message Envie uma mensagem WhatsApp direta
Listar modelos
/api/v4/notifications/whatsapp/templates Veja modelos WhatsApp aprovados
Notificacao de modelo
/api/v4/whatsapp/notifications Envie notificacao individual fora da janela de 24h
Envio em massa
/api/v4/whatsapp/bulk Envie para milhares de contatos em um unico lote
Enviar SMS
/api/v4/sms/send Envie um SMS para qualquer numero no mundo
Campanha SMS
/api/v4/sms/bulk Envio em massa para listas de contatos
Relatorio de entrega
/api/v4/sms/reports/{id} Verifique o status de entrega
Enviar email
/api/v4/email/send Email transacional com DKIM/SPF
Campanha de email
/api/v4/email/bulk Envie campanhas de marketing em massa
Eventos de email
/api/v4/email/events Taxa de abertura, cliques, rejeicoes, descadastros
Autenticacao
/api/v4/auth/token Gere token JWT Bearer
Webhooks
/api/v4/webhooks/create Configure a recepcao de eventos em tempo real
Widget de Chat
/api/v4/iframes/whatsapp/chat-box Gere um iframe para o chat WhatsApp
Integre na sua linguagem
Exemplos prontos para autenticar e enviar sua primeira mensagem.
curl -X POST \
https://app.roxpay.eu/api/v4/auth/token \
-H "Content-Type: application/json" \
-d '{"username":"...","password":"..."}'
# Use the token:
curl -X POST \
.../whatsapp/chats/123/message \
-H "Authorization: Bearer <token>" \
-d '{"body":"Hello!"}'import requests
# Authentication
r = requests.post(
"https://app.roxpay.eu/api/v4/auth/token",
json={"username":"...", "password":"..."}
)
token = r.json()["token"]
# Send message
requests.post(
"...whatsapp/chats/123/message",
headers={"Authorization": f"Bearer {token}"},
json={"body": "Hello!"}
)// Authentication
const r = await fetch(
"https://app.roxpay.eu/api/v4/auth/token",
{ method: "POST",
headers: {"Content-Type":"application/json"},
body: JSON.stringify({username,password}) }
);
const { token } = await r.json();
// Send message
await fetch("...chats/123/message", {
method: "POST",
headers: { Authorization: `Bearer ${token}` },
body: JSON.stringify({ body: "Hello!" })
});Sandbox e producao
Teste livremente no ambiente sandbox sem custo, depois mude para producao com uma unica mudanca de URL. Zero refatoracao.
Sandbox gratuito
Sem creditos consumidos. Mensagens simuladas. Testes ilimitados sem configuracao extra.
Producao escalavel
Infraestrutura empresarial com SLA 99,9% e suporte tecnico dedicado.
Troca instantanea
Mude apenas a URL base para ir do sandbox para producao. Mesmo codigo, mesmo contrato de API.
URL base
https://sandbox.roxpay.eu ✓ Mensagens simuladas · ✓ Sem custo · ✓ Dados de teste
URL base
https://app.roxpay.eu ✓ Mensagens reais · ✓ SLA 99,9% · ✓ Suporte dedicado
Documentacao completa disponivel
Todos os parametros, esquemas de resposta, codigos de erro e exemplos interativos na interface Swagger.