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étodoPathDescrição
GET/wa-connector/channelsCanais WhatsApp Oficial ativos
GET/wa-connector/templatesTemplates aprovados
POST/wa-connector/send-templateEnviar 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.

CampoTipoRegras
channel_idintegerobrigatório (canal official ativo)
tostringobrigatório, número destino (só dígitos; máscara é removida)
template_namestringobrigatório
languagestringpadrão pt_BR
componentsarrayparâ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.

api whatsapp wa-connector templates meta integração

Este artigo foi útil?

Artigos Relacionados