approach

Approach Chat integration for n8n

Package Information

Released: 4 mo ago
Downloads: 19 weekly / 115 monthly
Latest Version: 1.2.19
Author: Approach TI

Available Nodes

Chat icon
Chat
Interact with the Chat API
Chat Trigger icon
Chat Trigger
Handle chat events via webhooks

Documentation

n8n-nodes-approach

Node comunitário n8n para integração com a plataforma Approach (fork customizado do Chatwoot).

Instalação

No diretório de dados do n8n (~/.n8n):

npm install @approachti/n8n-nodes-approach

Reinicie o n8n após a instalação.

Troubleshooting

Class could not be found

Se o n8n mostrar Class could not be found ao instalar o pacote, use a versão 1.0.3 ou superior. Essa versão mantém o trigger compatível com versões do n8n que ainda não expõem NodeConnectionTypes.

Em instalações Docker, se o erro continuar depois da atualização, limpe os arquivos antigos de community nodes e reinstale o pacote:

docker exec -it <container> sh -c "cd /home/node/.n8n/nodes && rm -rf package.json node_modules"
docker restart <container>

Credenciais

Approach API

Para operações de conta (agentes, conversas, contatos, etc.):

  • URL: URL base da instância (https://app.suainstalacao.com.br)
  • Access Token: Token pessoal — gere em Perfil → Access Token

Approach Platform API

Para operações de plataforma (contas, usuários globais, banners):

  • URL: mesma URL base
  • Platform Access Token: gere em Super Admin → Platform Apps

Recursos disponíveis

Node: Approach

Recurso Operações
Agent list, create, update, delete
Agent Bot (Account) list, get, set, remove
Automation Rule list, get, create, update, delete, clone
Banner Message list, next, dismiss
Campaign list, get, create, update, trigger, pause, resume, stop
Canned Response list, create, update, delete
Chat Room list, get, create, update, delete, markAsRead, members, messages
Contact list, get, create, update, delete, search, filter, import, export
Contact Note list, get, create, update, delete
Conversation list, get, create, update, delete, filter, messages, assignments, labels, participants, scheduled messages
Custom Attribute list, get, create, update, delete
Custom Resolution Reason list, get, create, update, delete, activate, deactivate, reorder
Custom Role list, get, create, update, delete
Custom Scheduled Message Type list, get, create, update, delete, activate, deactivate, reorder
Inbox list, get, create, update, delete, assignable agents, templates
Label list, get, create, update, delete
Message Template list, get, create, delete, sync, send via WhatsApp
Profile get, update
Scheduled Message list, get, update, delete
Team list, get, create, update, delete, members
Platform: Account list, get, create, update, delete
Platform: Account User list, create, delete
Platform: Agent Bot list, get, create, update, delete
Platform: Banner create, delete
Platform: User list, get, create, update, delete

Node: Approach Trigger

Recebe eventos via webhook. Eventos suportados:

  • contact_created / contact_updated
  • conversation_created / conversation_updated / conversation_status_changed
  • conversation_typing_on / conversation_typing_off
  • message_created / message_updated
  • message_incoming / message_outgoing
  • provider_event_received
  • webwidget_triggered

Suporta filtro por inbox específica ou todas as inboxes.

Licença

MIT

Discussion