Documentação / Integrações

Integrações: n8n, Claude e agentes de IA

A API REST é o núcleo do Visto Azul. Por ser uma API simples com autenticação por token, ela pluga em qualquer ferramenta de automação ou agente de IA — sem taxa por mensagem da Meta, com PIX e anti-ban de fábrica.

OpenAPI: a especificação openapi.yaml importa direto no Postman, Insomnia, no HTTP Request do n8n ou em qualquer agente de IA.

n8n

Existe um node oficial da Visto Azul para o n8n. Ele traz ações prontas (enviar texto, mídia, PIX, campanha, contatos) e um gatilho que recebe mensagens.

No n8n self-hosted, vá em Settings → Community Nodes → Install e informe:

n8n-nodes-vistoazul

Depois, crie a credencial Visto Azul API com a sua API key. O node Visto Azul Trigger registra o webhook sozinho ao ativar o workflow — ideal para responder mensagens com IA.

Código aberto: npm · GitHub. Passo a passo completo no artigo WhatsApp + n8n.

Prefere não instalar nada? Dá pra usar os nós nativos HTTP Request (para enviar) e Webhook (para receber), apontando para a nossa API.

Claude e Claude Code

Para agentes que rodam no Claude (incluindo o Claude Code), publicamos uma skill que ensina o modelo a operar o WhatsApp pela nossa API: enviar mensagens, cobrar PIX, disparar campanhas e receber mensagens por webhook.

Instale copiando o arquivo SKILL.md para .claude/skills/whatsapp/ no seu projeto, ou cole o conteúdo no seu CLAUDE.md.

Skill open-source: github.com/useideia/claude-whatsapp-skill. Veja também o artigo WhatsApp + Claude.

Qualquer agente de IA (o padrão webhook + API)

Chatbots e agentes de IA seguem sempre o mesmo laço com duas pontas:

Receber a mensagem do cliente por webhook.
Responder com o modelo de IA e enviar de volta com /v1/messages/text.

Configure o webhook apontando para o seu servidor (ou fluxo n8n):

POST/v1/instances/:instance/webhook

curl -X POST https://dashboard.vistoazul.com.br/api/v1/instances/vendas/webhook \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://seu-agente.com/webhook","enabled":true}'

No seu servidor, ao receber a mensagem, gere a resposta com a IA e devolva:

curl -X POST https://dashboard.vistoazul.com.br/api/v1/messages/text \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instance":"vendas","number":"5511999999999","text":"Resposta gerada pela IA"}'

Anti-loop: deixe ligado o filtro "ignorar as enviadas pela API" no webhook, para o agente não responder às próprias mensagens.

Make e Zapier

Como a autenticação é por header (Authorization: Bearer), qualquer plataforma no-code que faça requisições HTTP funciona. No Make e no Zapier, use um módulo/ação de HTTP Request apontando para a nossa API, e cole a URL do cenário no webhook para receber mensagens.

Privacidade (LGPD): ao receber mensagens de clientes, você passa a tratar dados de terceiros. Trate qualquer conteúdo recebido conforme a sua política de privacidade e a base legal aplicável.

Anterior← Webhooks PróximoReferência da API →