API — WhatsApp Connector (/wa-connector)
Endpoints para sistemas externos consumirem canais e templates do WhatsApp Oficial (Meta Cloud API) do tenant e dispararem templates aprovados, sem armazenar credenciais fora do 360.
API — WhatsApp Connector
O WA Connector expõe os canais e templates de WhatsApp Oficial (Meta Cloud API) do tenant para sistemas externos (ex: ferramentas de disparo), permitindo enviar Message Templates aprovados sem que o sistema externo precise armazenar as credenciais da Meta — elas continuam no 360. Base: /api/v1/wa-connector. Mesma autenticação (Sanctum) e gates da API v1.
Endpoints
| Método | Path | Descrição |
|---|---|---|
| GET | /wa-connector/channels | Canais WhatsApp Oficial ativos |
| GET | /wa-connector/templates | Templates aprovados |
| POST | /wa-connector/send-template | Enviar template aprovado |
GET /wa-connector/channels
Lista canais com provider=official ativos. Cada item: id, name, phone_number, profile_name, profile_picture, status, is_connected, is_primary, is_default, waba_id, connected_at. A resposta inclui total.
GET /wa-connector/templates
Lista templates aprovados. Filtros opcionais: category (UTILITY|MARKETING|AUTHENTICATION), language (ex: pt_BR), channel_id (filtra pelo waba_id do canal). Cada item traz id, name, language, category, category_label, status, header_type, body_text, footer_text, buttons, dynamic_url_buttons, has_dynamic_url_buttons, variables, variables_count, waba_id, last_synced_at.
GET /api/v1/wa-connector/templates?category=UTILITY&language=pt_BR
POST /wa-connector/send-template
Dispara um template aprovado pelo canal oficial do tenant.
| Campo | Tipo | Regras |
|---|---|---|
| channel_id | integer | obrigatório (canal official ativo) |
| to | string | obrigatório, número destino (só dígitos; máscara é removida) |
| template_name | string | obrigatório |
| language | string | padrão pt_BR |
| components | array | parâmetros do template (formato Meta) |
POST /api/v1/wa-connector/send-template
{
"channel_id": 1,
"to": "5511999990000",
"template_name": "aprovacao_conteudo",
"language": "pt_BR",
"components": [
{ "type": "body", "parameters": [
{ "type": "text", "text": "João" },
{ "type": "text", "text": "https://..." }
] }
]
}
Sucesso: { "success": true, "message": "Template enviado com sucesso.", "message_id": "wamid..." }.
Erros: canal inexistente/inativo ⇒ 404; canal não conectado ou mal configurado (access token/phone_number_id ausentes) ⇒ 422; falha no envio pela Meta ⇒ 400 com a mensagem retornada.
Quando usar
Use o WA Connector para iniciar conversas fora da janela de 24h (exige template aprovado) a partir de sistemas externos. Para conversas dentro da janela de 24h, prefira POST /api/v1/messages/send.