Integrações com N8N
O que e o N8N
N8N (pronuncia-se "nodemation") e uma plataforma de automacao de workflows visual e open source. Com ele, voce conecta diferentes servicos e APIs usando uma interface drag-and-drop, sem precisar escrever codigo complexo.
O N8N esta disponivel em duas modalidades:
| Modalidade | Descricao |
|---|---|
| N8N Cloud | Hospedado pela equipe do N8N. Comece em minutos sem configuracao de servidor. |
| Self-hosted | Instale no seu proprio servidor (Docker, npm). Controle total sobre dados e infraestrutura. |
Por que integrar Ogmma API com N8N
Ao conectar a Ogmma API ao N8N, voce pode automatizar fluxos completos de comunicacao via WhatsApp:
- Enviar mensagens automaticamente -- a partir de eventos no seu CRM, ERP, e-commerce ou planilhas
- Processar mensagens recebidas -- receber webhooks e executar logica de negocio (auto-resposta, roteamento, classificacao)
- Sincronizar dados -- manter contatos atualizados entre Ogmma e outros sistemas
- Criar chatbots -- combinar com OpenAI/Claude para respostas inteligentes
- Enviar campanhas -- disparar mensagens em massa a partir de planilhas do Google Sheets
Arquitetura da Integracao
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Seu Sistema │────►│ N8N Workflow │────►│ Ogmma API │────►│ WhatsApp │
│ (CRM, ERP, │ │ (HTTP Request)│ │ /api/... │ │ │
│ Planilhas) │ └──────────────┘ └──────────────┘ └──────┬───────┘
│ │ │
│ │ ┌──────────────┐ ┌──────────────┐ │
│ │◄────│ N8N Webhook │◄────│ Ogmma Webhook│◄───────────┘
│ │ │ (Trigger) │ │ (Eventos) │ Mensagem recebida
└──────────────┘ └──────────────┘ └──────────────┘
Fluxo de envio: Seu sistema aciona um workflow N8N → N8N faz HTTP Request para a Ogmma API → Ogmma envia a mensagem via WhatsApp.
Fluxo de recebimento: WhatsApp recebe mensagem → Ogmma processa e dispara webhook → N8N Webhook node recebe o evento → Seu workflow processa e reage.
Pre-requisitos
Antes de comecar, voce vai precisar de:
| Requisito | Descricao |
|---|---|
| Instancia N8N | Cloud (n8n.io) ou self-hosted. Criar conta gratuita |
| Conta Ogmma | Conta criada na plataforma Ogmma. Primeiros Passos |
| API Key | Chave de autenticacao da Ogmma API. Criar API Key |
| Canal conectado | Pelo menos um canal WhatsApp conectado. Conectar Canal |
O que voce vai aprender
Esta secao cobre tudo que voce precisa para integrar o N8N com a Ogmma API:
| Guia | Descricao |
|---|---|
| Configurar Autenticacao | Configurar sua API Key no N8N para autenticar requisicoes |
| Enviar Mensagens | Enviar texto, imagem e templates via workflows N8N |
| Receber Webhooks | Configurar Webhook node para receber eventos em tempo real |
| Auto-Resposta | Exemplo completo de chatbot com respostas automaticas |
| Workflows Avancados | Envio em massa, integracao com IA, e-commerce e CRM |
Workflows Prontos para Importar
Cada guia inclui workflows N8N exportados em JSON que voce pode importar diretamente no seu N8N. Basta baixar o arquivo e usar Import from File no editor de workflows.
| Workflow | Descricao | Download |
|---|---|---|
| Testar Autenticacao | Verifica se sua API Key esta funcionando | JSON |
| Enviar Mensagem | Envia mensagem de texto via WhatsApp | JSON |
| Receber Eventos | Recebe webhooks e roteia por tipo de evento | JSON |
| Auto-Resposta | Responde automaticamente por palavras-chave | JSON |
| Envio em Massa | Envia mensagens em massa via Google Sheets | JSON |
| Chatbot com IA | Responde com OpenAI GPT automaticamente | JSON |
No N8N, clique nos tres pontos (⋮) no canto superior direito do editor → Import from File → selecione o arquivo JSON baixado. O workflow sera criado automaticamente com todos os nodes configurados.