MAZAM WABA Connector

Conector oficial da MAZAM para integracao com a Meta WhatsApp Cloud API v25.0, oferecendo uma API REST que abstrai a complexidade da API oficial da Meta para comunicacao via WhatsApp Business.

O que e o MAZAM WABA Connector?

O MAZAM WABA Connector atua como ponte entre o ecossistema MAZAM (Agente IA + Dashboard) e o WhatsApp oficial, gerenciando multiplas instancias, webhooks, templates e envio/recebimento de mensagens. Principais funcionalidades:

• Envio de mensagens — Texto, imagem, video, audio, documento, sticker, localizacao, contatos, reacoes
• Mensagens interativas — Botoes, listas, CTA URL
• Templates — Criar, listar, deletar, sincronizar e enviar templates aprovados pela Meta
• Webhooks — Receber e processar eventos em tempo real com buffer inteligente e idempotencia
• Multi-instancia — Gerenciar multiplos numeros WhatsApp Business simultaneamente
• OAuth Embedded Signup — Onboarding de novos negocios via fluxo OAuth da Meta
• Admin Panel — Painel web para gerenciamento visual de instancias e status
• Integracao com Agente IA — Encaminhamento automatico para o mazam-ia-leads

Inicio Rapido

Envie sua primeira mensagem de texto via Meta Cloud API:

curl -X POST "https://sua-api.com/send/text" \
  -H "Authorization: Bearer sua-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999",
    "body": "Ola! Esta e uma mensagem de teste via Cloud API."
  }'

Secoes da Documentacao

Autenticacao

Todas as requisicoes protegidas devem incluir o header Authorization com sua API key:

Authorization: Bearer sua-api-key

Os endpoints de webhook e health sao publicos e nao requerem autenticacao. O admin panel usa autenticacao JWT separada.

Base URL

https://sua-api.com

Em desenvolvimento local (Docker Compose):

http://localhost:8200

Arquitetura

Cliente WhatsApp → Meta Cloud API → Webhook POST → MAZAM WABA Connector → mazam-ia-leads (Agente IA)
                                                                        ← resposta do agente
                                  ← POST /\{phone_number_id\}/messages