Conecte o Chatwoot ao n8n por webhook e API

A consulta ao índice oficial do n8n em 28/10/2026 não confirmou um Node nativo para Chatwoot. Você pode integrar os serviços com Webhook para receber eventos e HTTP Request para chamar a API oficial do Chatwoot.

Receba eventos de atendimento

Crie um Node Webhook com método POST. Durante o desenvolvimento, use a URL de teste com Listen for test event. Para receber eventos continuamente, publique o workflow e use a URL de produção.

A API do Chatwoot permite cadastrar a assinatura por POST no caminho abaixo, usando o domínio da sua instância e substituindo o identificador:

1
/api/v1/accounts/{account_id}/webhooks

Envie um corpo JSON com url apontando para o Webhook e subscriptions listando os eventos desejados. Entre os eventos documentados estão conversation_created e message_created. Cadastre apenas os eventos necessários para a automação.

Gere um evento no Chatwoot e examine o JSON recebido no n8n. Use os identificadores dessa execução para configurar as próximas chamadas. Confira o formato recebido antes de escrever expressões para campos internos.

Envie uma mensagem pela API

Adicione HTTP Request, selecione POST e configure a URL da instância com este caminho:

1
/api/v1/accounts/{account_id}/conversations/{conversation_id}/messages

Substitua os marcadores account_id e conversation_id pelos identificadores correspondentes da sua instalação. Para uma mensagem de texto pública, envie JSON com content contendo o texto, message_type igual a outgoing e private igual a false.

Configure o token em uma credencial do n8n. A API atual recomenda o cabeçalho Authorization: Bearer <token>, disponível no Chatwoot a partir da v4.19.0. A referência também documenta o suporte ao cabeçalho api_access_token. Confira a versão instalada antes de escolher o método.

Confira o evento e a resposta

Teste o recebimento e o envio separadamente em uma conversa destinada à conferência. Compare o identificador retornado pela API com a mensagem exibida no Chatwoot.

Uma assinatura de message_created também pode receber eventos associados às mensagens criadas pela própria automação. Examine o evento e filtre o caminho de resposta antes do envio para evitar respostas sucessivas na mesma conversa. Publique somente depois de conferir esse comportamento com o JSON recebido.