Documentação da API

Envie mensagens WhatsApp pelo gateway ÁguiaON — mesmo contrato estilo ConectaE — usando só uuid + access_token. Sem expor Evolution, WAHA ou QR ao sistema externo.

Gateway /api/send/text Token por conexão GET e POST

Visão geral

O gateway é o ponto único para N8N, Zapier, ERP, cardápio externo ou outra plataforma disparar texto pelo WhatsApp já conectado na ÁguiaON (loja ou Automação).

Loja (Delivery e demais segmentos): gera endpoint após conectar o QR.
Cliente Automação (portal): cada conexão tem uuid + token próprios.
O motor da plataforma (Evolution / WAHA / Meta) fica interno — o cliente só chama o endpoint.

Autenticação

Toda chamada exige:

uuid — identificador público da conexão
access_token — segredo (aparece uma vez ao gerar/regenerar)

Aceitamos aliases: gateway_uuid, token, gateway_token. O token nunca é reexibido no painel — regenere se perder.

Base URL

https://seu-dominio/api

O endpoint completo de envio é:

GET POST https://seu-dominio/api/send/text

Como obter credenciais

Loja (lojista)

Abra /loja → WhatsApp → API da Plataforma
Conecte o WhatsApp com o QR
Em Endpoint de integração, gere uuid + access_token

Automação (cliente / portal)

Abra /portal → Automação
Crie uma conexão e conecte o WhatsApp (QR ou Meta)
Copie uuid, endpoint e o token (só aparece uma vez)

Enviar texto

GET POST /api/send/text

Dispara uma mensagem de texto para um número WhatsApp. O número deve incluir DDI (ex.: 5511999999999). Compatível com integrações estilo ConectaE — use o uuid + access_token gerados no painel ÁguiaON, não credenciais de outro provedor. O WhatsApp do cliente vem do seu cardápio/ERP a cada pedido — não use número fixo de exemplo.

Parâmetros

Válidos em query string (GET) ou JSON body (POST).

Campo		Descrição
`uuid`	obrigatório	UUID da conexão. Alias: `gateway_uuid`.
`access_token`	obrigatório	Token secreto. Alias: `token`, `gateway_token`.
`number`	obrigatório	WhatsApp destino com DDI. Alias: `phone`, `telefone`, `celular`, `whatsapp`, `to`.
`text`	obrigatório	Mensagem. Alias: `body` (comum em ERPs), `message`, `mensagem`, `msg`.

Exemplos

GET

HTTP

POST JSON

JSON

cURL

Bash

JavaScript (fetch)

Respostas

Sucesso — 200

JSON

{
  "success": true,
  "ok": true,
  "status": "success",
  "message": "Mensagem enviada com sucesso.",
  "message_id": "enviado",
  "provider": "evolution",
  "failover": false
}

401UUID ou Access Token ausentes.

400number e text/body são obrigatórios.

403Credenciais inválidas ou conexão inativa.

402Assinatura Automação inativa (portal).

409WhatsApp ainda não conectado (escaneie o QR).

502Falha no provedor (Evolution/WAHA/Meta).

Segurança

Não compartilhe o access_token em repositórios públicos ou prints.
Regenere o token se suspeitar de vazamento — o anterior deixa de funcionar.
Sistemas externos não precisam da URL Evolution nem da apikey da plataforma.
O WhatsApp continua conectado só na ÁguiaON; o gateway apenas encaminha o envio.

N8N / Zapier / ERP

Fluxo típico:

HTTP Request → método GET ou POST
URL base = https://seu-dominio/api/send/text?uuid=...&access_token=... (sem number fixo)
A cada pedido, o outro sistema envia number (WhatsApp do cliente) e text/body
Use credenciais do painel ÁguiaON — trocar só o domínio mantendo uuid/token da ConectaE não funciona
Trate success: true como enviado / enfileirado

Para fallback da própria loja (se a API da plataforma falhar), use WhatsApp → API Externa no painel e cole um endpoint no mesmo formato (ex.: ConectaE ou outra conta ÁguiaON).