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