n8n-nodes-capichat

Este é um community node para o n8n que integra com o CapiChat CRM (GaranteDireito) - um sistema de atendimento via WhatsApp especializado em Direito Previdenciário.

Funcionalidades

O node CapiChat CRM oferece integração completa com os seguintes recursos:

📇 Contatos (Leads)

• Criar, buscar, listar, atualizar e remover contatos
• Buscar por telefone
• Criação em lote (até 100 contatos)
• Gerenciamento de etiquetas

💬 Conversas

• Criar, listar e atualizar conversas
• Transferir para usuário ou equipe
• Adicionar notas internas
• Finalizar e reabrir conversas

📨 Mensagens

• Enviar mensagens (texto, imagem, áudio, vídeo, documento)
• Agendar mensagens
• Verificar status de entrega
• Listar e cancelar mensagens agendadas

🎯 Oportunidades

• Criar e gerenciar oportunidades no funil
• Mover entre etapas
• Adicionar notas
• Duplicar oportunidades

✅ Tarefas

• Criar, listar e atualizar tarefas
• Marcar como concluída
• Definir prioridades e responsáveis

🏷️ Etiquetas

• Criar e gerenciar etiquetas
• Categorias: origem, interesse, prioridade, status, benefício, condição de saúde, desqualificação

👥 Equipes e Usuários

• Listar equipes e usuários
• Gerenciar disponibilidade
• Atribuir responsáveis

📋 Templates

• Criar e gerenciar templates de mensagens
• Atalhos para respostas rápidas

🤖 Chatbots

• Listar chatbots disponíveis
• Iniciar fluxos para contatos

🔗 Webhooks

• Criar e gerenciar webhooks
• Eventos: lead.created, message.received, opportunity.moved, etc.

📊 Funis

• Listar funis e etapas
• Obter campos personalizados

📱 Canais WhatsApp

• Listar instâncias WhatsApp conectadas

📁 Carteiras

• Criar e gerenciar carteiras de contatos
• Adicionar/remover contatos das carteiras

🔧 Campos Personalizados

• Criar campos customizados
• Tipos: texto, número, data, seleção, seleção múltipla, booleano

Instalação

Via n8n

1. Acesse Settings > Community Nodes
2. Clique em Install
3. Digite n8n-nodes-capichat
4. Confirme a instalação

Via npm

npm install n8n-nodes-capichat

Via pnpm

pnpm install n8n-nodes-capichat

Configuração

1. Obtenha seu token de API em Ajustes > Integrações > API no CapiChat CRM
2. No n8n, adicione uma credencial do tipo CapiChat CRM API
3. Cole seu token de API
4. Salve e teste a conexão

Uso

1. Adicione o node CapiChat CRM ao seu workflow
2. Selecione a credencial configurada
3. Escolha o recurso (Contato, Conversa, Mensagem, etc.)
4. Escolha a operação desejada
5. Preencha os parâmetros necessários
6. Execute!

Exemplos de Uso

Criar um contato

{
  "resource": "contato",
  "operation": "create",
  "name": "Maria Silva",
  "phone": "11999990001",
  "email": "[email protected]",
  "temperature": "warm"
}

Enviar mensagem

{
  "resource": "mensagem",
  "operation": "send",
  "contatoId": "uuid-do-contato",
  "tipo": "texto",
  "conteudo": "Olá! Como posso ajudar?"
}

Criar oportunidade

{
  "resource": "oportunidade",
  "operation": "create",
  "nome": "João Santos",
  "telefone": "11999990002",
  "temperatura": "hot",
  "etapaId": "uuid-da-etapa"
}

Rate Limiting

A API do CapiChat possui os seguintes limites:

| Operação | Limite | |----------|--------| | Envio de mensagens | 300 req/min | | Leitura (GET) | 3000 req/min | | Escrita (POST/PUT/DELETE) | 500 req/min |

Compatibilidade

• n8n >= 1.0.0
• Node.js >= 18.10

Suporte

• Documentação: https://capichat.lovable.app/api-docs
• Email: [email protected]

Licença

MIT

Changelog

1.0.0

• Versão inicial com suporte completo a todos os recursos da API
• 15 recursos implementados
• Mais de 50 operações disponíveis
• Suporte a agentes de IA (usableAsTool: true)