n8n-nodes-chatwoot-konan

Este é um pacote de n8n Community Node para integração completa com a API Oficial do Chatwoot.

🚀 Funcionalidades Principais

O pacote disponibiliza dois nós no n8n:

1. Konan Chatwoot (Node Principal de Ações)
2. Konan Chatwoot Trigger (Node de Disparo por Webhook)

Recursos Cobertos (API Oficial v1)

• Account (Conta): Get, Update
• Contact (Contatos): Create, Get, Update, Delete, List, Search, Set Custom Attributes, Destroy Custom Attributes
• Conversation (Conversas): Create, Get, List, Send Message, Send File (com suporte a anexos binários), List Messages, List Attachments, Assign Agent, Assign Team, Add/Remove/Update Labels, Toggle Status, Set Priority, Set Custom Attributes, Update Last Seen, Update Presence, Mark Unread, Update Attachment Metadata
• Custom Attribute (Atributos Customizados): Create, Get, List, Update, Delete (Suporte exclusivo aos modelos oficiais Contact e Conversation)
• Inbox (Caixas de Entrada): Get, List
• Label (Etiquetas): Create, Get, List, Update, Delete
• Profile (Perfil de Usuário): Get, Update (Rota global /api/v1/profile)
• Team (Times): Create, Get, Update, Delete, List, Get Team Members, Assign Agent, Unassign Agent

Eventos de Webhook (Trigger Node)

• Contact Created (contact_created)
• Contact Updated (contact_updated)
• Conversation Created (conversation_created)
• Conversation Status Changed (conversation_status_changed)
• Conversation Typing Off (conversation_typing_off)
• Conversation Typing On (conversation_typing_on)
• Conversation Updated (conversation_updated)
• Live Chat Widget Opened (webwidget_triggered)
• Message Created (message_created)
• Message Updated (message_updated)

⚙️ Configuração de Credenciais

Para utilizar os nós no n8n, crie a credencial Konan Chatwoot API preenchendo:

1. Base URL: Endereço da sua instância Chatwoot (ex.: https://app.chatwoot.com ou https://chatwoot.suaempresa.com).
2. Account ID: O ID numérico da sua conta no Chatwoot (encontrado na URL da conta).
3. API Access Token: O token obtido em Profile Settings no canto inferior esquerdo do painel do Chatwoot.

A autenticação é injetada automaticamente via HTTP Header api_access_token.

📦 Instalação e Build Local

# Instalar dependências
npm install

# Compilar TypeScript e copiar ícones
npm run build

# Testar localmente com o n8n
npm link
cd ~/.n8n/custom
npm link n8n-nodes-chatwoot-konan
n8n start

📄 Licença

MIT