ÁguiaON API

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)

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

Automação (cliente / portal)

  1. Abra /portal → Automação
  2. Crie uma conexão e conecte o WhatsApp (QR ou Meta)
  3. 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.: 5599999999999).

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, whatsapp.
text obrigatório Mensagem. Alias: message, mensagem, msg.

Exemplos

GET

HTTP

        


        
POST JSON

        

          
JSON

          

        


        
cURL

        

          
Bash

          

        


        
JavaScript (fetch)

        

          
JS

          

        

      


      

        
Respostas

        
Sucesso — 200

        

          
JSON

          
{
  "success": true,
  "message_id": "enviado",
  "provider": "evolution",
  "failover": false,
  "status": "queued"
}

        


        

          
401UUID ou Access Token ausentes.

          
400number e text 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:

        
    
          
  1. HTTP Request → método GET ou POST
    2. 
          
  2. URL = endpoint completo /api/send/text
    3. 
          
  3. Query ou body com uuid, access_token, number, text
    4. 
          
  4. Trate success: true como enviado / enfileirado
    5. 
        

        

          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).