REST API • WhatsApp • Twilio

Avizuaí API

Plataforma de comunicação WhatsApp para envio de mensagens, campanhas em massa, agendamentos e integração com sistemas legados via Twilio.

v1.0.0 Java 21 Spring Boot 3.5
293
Endpoints
52
Controllers
2
Grupos API
6
Módulos

APIs Disponíveis

Dois grupos de API com autenticação independente, documentados via Swagger/OpenAPI.

🔑

API v2 — Externa

Para integradores externos. Envio de mensagens, consulta de saldo, tarifas e extrato financeiro.

Autenticação
X-Api-Key + X-Api-Secret
Endpoints principais
  • /api/v2/messages/send
  • /api/v2/messages/historico
  • /api/v2/financeiro/saldo
  • /api/v2/config/aplicacao
Swagger API v2 →
🔒

API Admin — Interna

Para o painel administrativo (BFF). Gestão completa de aplicações, mensagens, IA, financeiro e sistema.

Autenticação
JWT Bearer Token
Endpoints principais
  • /api/admin/auth/login
  • /api/admin/aplicacoes
  • /api/admin/whatsapp/*
  • /api/admin/ia/*
Swagger Admin →

Envie sua primeira mensagem

  • Cadastre sua aplicação e obtenha API Key + Secret
  • Configure as credenciais Twilio no painel admin
  • Envie mensagens WhatsApp via API REST
Métodos de autenticação
  • API v2: headers X-Api-Key + X-Api-Secret
  • Admin: Authorization: Bearer {jwt}
terminal
# Enviar mensagem WhatsApp
curl -X POST /api/v2/messages/send \
  -H "X-Api-Key: sua-api-key" \
  -H "X-Api-Secret: seu-secret" \
  -H "Content-Type: application/json" \
  -d '{
    "telefone": "+5511999999999",
    "mensagem": "Olá! Sua consulta é amanhã."
  }'

# Resposta: 200 OK
{
  "sucesso": true,
  "messageSid": "SM1234567890abcdef",
  "status": "queued"
}

Recursos da Plataforma

Funcionalidades completas para comunicação WhatsApp empresarial.

💬

Envio WhatsApp

Mensagens de texto via API REST com rastreamento de entrega e status em tempo real via webhooks do Twilio.

📣

Campanhas em Massa

Envio em lotes com importação de destinatários via Excel, variáveis dinâmicas e controle de progresso.

Agendamentos

Mensagens agendadas por data fixa, relativo a eventos ou recorrente com expressão cron.

🤖

IA Multi-Provider

Auto-resposta inteligente com OpenAI, Claude, Groq e Ollama. Base de conhecimento RAG integrada.

💰

Financeiro Completo

Tarifas por serviço, saldo por aplicação, cotação USD/BRL automática e impostos configuráveis.

🔗

Integrações

Conecte sistemas legados via banco de dados ou API REST. Agente on-premises com OAuth2/JWT.