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.

SDKs oficiais (Node e Python)

Cliente pronto para as duas linguagens mais usadas, cobrindo instances, messages, campaigns, contacts e templates, além de raw() para qualquer rota da API.

npm install vistoazul     # Node / TypeScript
pip install vistoazul     # Python

Node / TypeScript:

import { VistoAzul } from "vistoazul";

const wa = new VistoAzul("SUA_API_KEY");
await wa.messages.sendText("vendas", "5541999999999", "Olá!");

Python:

from vistoazul import VistoAzul

wa = VistoAzul("SUA_API_KEY")
wa.messages.send_text("vendas", "5541999999999", "Olá!")

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.

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.

Chatwoot (atendimento)

Ligue o seu Chatwoot ao número e as conversas do WhatsApp aparecem lá pra sua equipe atender. No painel, em Integrações, cole a URL e o token de API do seu Chatwoot (o token fica em Perfil → Token de acesso). A Visto Azul cria o inbox e o webhook sozinha, é só a URL + token.

• Só leitura (padrão): as conversas espelham no Chatwoot pra acompanhamento. Nada é reenviado, sem risco de loop.
• Responder pelo Chatwoot: ligue a resposta e o que o atendente digita no Chatwoot sai no WhatsApp do cliente.
• Receber as saídas no seu webhook: na configuração do número (aba Webhook), desmarque "Ignorar as enviadas pela API" pra receber também as mensagens de saída (Chatwoot/atendente) no seu endpoint. Os seus próprios disparos por API são filtrados automaticamente — sem loop, sem você precisar tratar isso na sua automação.

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.

Para conectar como ferramenta nativa (o padrão MCP, que funciona no Claude Desktop, Claude Code e Cursor), use o servidor MCP da Visto Azul — um comando e o agente já opera o WhatsApp.

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

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

1. Receber a mensagem do cliente por webhook.
2. 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):

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"}'

Frameworks de agente (para desenvolvedores)

Constrói agentes em código? Qualquer framework do momento opera o WhatsApp pela nossa API REST ou pelo servidor MCP: LangChain / LangGraph, CrewAI, Vercel AI SDK, Mastra, PydanticAI, OpenAI Agents SDK e Google ADK. Importe o openapi.yaml como ferramenta, ou conecte o MCP (suportado nativamente por vários desses SDKs).

Make, Zapier, Dify e no-code

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