<body id="yoopta-clipboard" data-editor-id="1f3fe8e4-7432-4ca9-b8d1-94bb8354793e" data-yoopta-json="{&quot;version&quot;:1,&quot;editorId&quot;:&quot;1f3fe8e4-7432-4ca9-b8d1-94bb8354793e&quot;,&quot;blocks&quot;:[{&quot;id&quot;:&quot;8d6c3949-1afd-45da-99e8-7310f7d325cb&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;1a62bf46-5292-4341-bf52-0a5c168d8731&quot;,&quot;type&quot;:&quot;heading-one&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Como conectar qualquer API ao Chatwoot&quot;,&quot;bold&quot;:true}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;type&quot;:&quot;HeadingOne&quot;,&quot;meta&quot;:{&quot;order&quot;:0,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;a781a5c7-f8bc-4e61-9dc2-9f15f1883f8c&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;4011dbc1-d177-416e-9354-531ea4bcfc5d&quot;,&quot;type&quot;:&quot;paragraph&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;O Chatwoot é uma plataforma &quot;},{&quot;text&quot;:&quot;open source&quot;,&quot;italic&quot;:true},{&quot;text&quot;:&quot; fantástica para centralizar o atendimento multicanal. No entanto, para extrair o máximo do seu potencial, muitas vezes precisamos conectá-lo a sistemas externos, como CRMs, ERPs, agentes de Inteligência Artificial ou provedores não oficiais de WhatsApp (como Evolution API, Z-API ou W-API).&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;type&quot;:&quot;Paragraph&quot;,&quot;meta&quot;:{&quot;order&quot;:1,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;c6f42d3c-11ca-4a6d-bac0-40d85d3c4902&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;6118e6ad-5c24-4ffe-ae6a-a789165d0a08&quot;,&quot;type&quot;:&quot;paragraph&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Abaixo, detalhamos as melhores abordagens para conectar literalmente qualquer API ao seu Chatwoot, garantindo estabilidade e escalabilidade.&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;type&quot;:&quot;Paragraph&quot;,&quot;meta&quot;:{&quot;order&quot;:2,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;2f1d3204-b139-4516-997c-d78bb57c68cb&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;bc0f11de-6293-415e-b00b-270484a62b64&quot;,&quot;type&quot;:&quot;heading-one&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;1. A Ponte Universal: Usando webhooks e o n8n&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;type&quot;:&quot;HeadingOne&quot;,&quot;meta&quot;:{&quot;order&quot;:3,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;c847ace9-9d46-47fc-8d68-6ec216bdd090&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;a4cc9571-5a3d-4295-8abb-03b16a054a82&quot;,&quot;type&quot;:&quot;paragraph&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;A forma mais flexível de integrar o Chatwoot a qualquer serviço externo é utilizando o &quot;},{&quot;text&quot;:&quot;n8n&quot;,&quot;bold&quot;:true},{&quot;text&quot;:&quot;, uma ferramenta de automação visual. O fluxo básico funciona assim:&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;type&quot;:&quot;Paragraph&quot;,&quot;meta&quot;:{&quot;order&quot;:4,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;b94d8534-916e-482c-9b2c-4a1457bc6bb2&quot;,&quot;type&quot;:&quot;BulletedList&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;93f4a1fa-ed31-4a3c-8e5b-8ded342545ea&quot;,&quot;type&quot;:&quot;bulleted-list&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Enviando do Chatwoot para o n8n&quot;,&quot;bold&quot;:true},{&quot;text&quot;:&quot;: Configure um Webhookno painel do Chatwoot (em Configurações → Integrações → Webhooks) apontando para a URL do seu n8n. Selecione eventos específicos, comomessage_created, para que o n8n seja notificado apenas quando uma nova mensagem chegar.&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;meta&quot;:{&quot;order&quot;:5,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;d21199cc-ac53-4862-abac-4cec97e29966&quot;,&quot;type&quot;:&quot;BulletedList&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;b68042be-adea-4896-a944-b6e23412d81a&quot;,&quot;type&quot;:&quot;bulleted-list&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Filtros Importantes&quot;,&quot;bold&quot;:true},{&quot;text&quot;:&quot;: No n8n, certifique-se de filtrar mensagens de entrada (incoming) e ignorar as mensagens enviadas pelo próprio bot ou atribuídas a um agente humano, evitando assim loops infinitos que podem travar seu servidor.&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;meta&quot;:{&quot;order&quot;:6,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;362a3ee5-de92-47ff-9966-7b10279e4378&quot;,&quot;type&quot;:&quot;BulletedList&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;869b653f-e92a-4f41-9b23-b6866080a0ca&quot;,&quot;type&quot;:&quot;bulleted-list&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Conectando a outras APIs&quot;,&quot;bold&quot;:true},{&quot;text&quot;:&quot;: Utilize o poderoso node HTTP Request do n8n para consultar bancos de dados externos, enviar leads para o CRM ou se comunicar com a API de provedores como a Evolution API.&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;meta&quot;:{&quot;order&quot;:7,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;955953a2-22b7-4809-9508-e03c89ba703a&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;2a5a0bf5-7a49-4e09-9ff0-58be367ac4f1&quot;,&quot;type&quot;:&quot;heading-one&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;2. O Segredo para Enviar Mídias via API no n8n&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;type&quot;:&quot;HeadingOne&quot;,&quot;meta&quot;:{&quot;order&quot;:8,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;23a2a5c1-e036-43b5-8a12-5ed1c7d7ad86&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;3384ef50-f640-454a-9beb-85146d68bb15&quot;,&quot;type&quot;:&quot;paragraph&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Uma das maiores dificuldades da integração direta via API é o envio de arquivos e áudios do n8n para o Chatwoot. Se você optar por não usar nodes prontos e construir as requisições HTTP na mão (o que evita problemas se a API do Chatwoot for atualizada), existe um truque: Ao enviar a requisição HTTP tipo POST para o Chatwoot, você deve passar o arquivo binário em um campo chamado &quot;},{&quot;text&quot;:&quot;attachment&quot;,&quot;code&quot;:true},{&quot;text&quot;:&quot;, e formatar o envio como &quot;},{&quot;text&quot;:&quot;data&quot;,&quot;code&quot;:true},{&quot;text&quot;:&quot; (ex: configurando o tipo como &quot;},{&quot;text&quot;:&quot;N8N binary file&quot;,&quot;italic&quot;:true},{&quot;text&quot;:&quot; e associando ao nome &quot;},{&quot;text&quot;:&quot;data&quot;,&quot;code&quot;:true},{&quot;text&quot;:&quot;). Isso garantirá que áudios, imagens e PDFs cheguem perfeitamente à caixa de entrada.&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;type&quot;:&quot;Paragraph&quot;,&quot;meta&quot;:{&quot;order&quot;:9,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;54e2b5be-c325-4d73-97cd-a1ae41bc6f71&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;606b8a5d-1581-448d-b984-d9e25089c503&quot;,&quot;type&quot;:&quot;heading-one&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;3. Acelerando o processo: Node Comunitário do Chatwoot&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;type&quot;:&quot;HeadingOne&quot;,&quot;meta&quot;:{&quot;order&quot;:10,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;0e3472bc-5d2b-4496-8a33-e091277cb984&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;2068aadd-9a2e-471e-a1e9-7a002547d8da&quot;,&quot;type&quot;:&quot;paragraph&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Se você busca praticidade dentro do n8n, a comunidade criou o pacote &quot;},{&quot;text&quot;:&quot;@fazer-ai/n8n-nodes-chatwoot&quot;,&quot;code&quot;:true},{&quot;text&quot;:&quot;. Este node facilita imensamente a vida do desenvolvedor, oferecendo:&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;type&quot;:&quot;Paragraph&quot;,&quot;meta&quot;:{&quot;order&quot;:11,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;05be545c-eec5-4400-b152-6dbee8e3d864&quot;,&quot;type&quot;:&quot;BulletedList&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;89866b0c-3d8d-452a-9373-337b0343ec1b&quot;,&quot;type&quot;:&quot;bulleted-list&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Triggers automáticos&quot;,&quot;bold&quot;:true},{&quot;text&quot;:&quot;: O node cria e gerencia os webhooks no seu Chatwoot automaticamente.&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;meta&quot;:{&quot;order&quot;:12,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;c1cdc4d3-6945-42e4-b131-117a7e8332ed&quot;,&quot;type&quot;:&quot;BulletedList&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;eef5639c-7112-4d4d-a759-51243d6e5098&quot;,&quot;type&quot;:&quot;bulleted-list&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Operações Nativas&quot;,&quot;bold&quot;:true},{&quot;text&quot;:&quot;: Permite realizar ações de CRUD (criar, ler, atualizar, deletar) em contatos, conversar, gerenciar caixas de entrada e até gerenciarKanban boards.&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;meta&quot;:{&quot;order&quot;:13,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;dcf6e5a0-bfa3-420e-96e8-5e54874fc036&quot;,&quot;type&quot;:&quot;BulletedList&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;03e378b7-b99a-49b4-a98f-10d384bbec94&quot;,&quot;type&quot;:&quot;bulleted-list&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Compatibilidade com IA&quot;,&quot;bold&quot;:true},{&quot;text&quot;:&quot;: O node suporta ser utilizado como uma \&quot;ferramenta de IA\&quot; (AI Tool) em fluxos de agentes inteligentes no n8n.&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;meta&quot;:{&quot;order&quot;:14,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;c58e8662-ba3e-4d1c-9619-48d198dd8a94&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;c1679984-39eb-42f3-8a1d-ee713a1dac8b&quot;,&quot;type&quot;:&quot;heading-one&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;4. Conectores Dedicados para Alta Performance (WhatsApp)&quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;type&quot;:&quot;HeadingOne&quot;,&quot;meta&quot;:{&quot;order&quot;:15,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;9f4a1750-f3ef-46ed-a56e-5ea2565e36d2&quot;,&quot;value&quot;:[{&quot;id&quot;:&quot;7d923261-cd4b-4bda-8eab-36d1a5a1856a&quot;,&quot;type&quot;:&quot;paragraph&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Se o seu objetivo exclusivo é conectar instâncias de WhatsApp de provedores como &quot;},{&quot;text&quot;:&quot;W-API, Z-API ou Whapi&quot;,&quot;bold&quot;:true},{&quot;text&quot;:&quot;, construir todo o fluxo manualmente pode não ser a melhor rota para alto volume. &quot;}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}],&quot;type&quot;:&quot;Paragraph&quot;,&quot;meta&quot;:{&quot;order&quot;:16,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;}},{&quot;id&quot;:&quot;36ea49f4-98ba-4ac2-a35b-b65ec852b0b8&quot;,&quot;type&quot;:&quot;Paragraph&quot;,&quot;meta&quot;:{&quot;order&quot;:17,&quot;depth&quot;:0,&quot;align&quot;:&quot;left&quot;},&quot;value&quot;:[{&quot;id&quot;:&quot;7d923261-cd4b-4bda-8eab-36d1a5a1856a&quot;,&quot;type&quot;:&quot;paragraph&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;Nesses casos, utilizar uma solução self-hosted como o &quot;},{&quot;text&quot;:&quot;API Connector&quot;,&quot;bold&quot;:true},{&quot;text&quot;:&quot; pode ser o ideal. Esses conectores rodam no seu servidor (via Docker) e atuam como um roteador bidirecional entre o Chatwoot e as APIs de WhatsApp. Eles utilizam processamento assíncrono com filas Redis e MQTT, garantindo &quot;},{&quot;text&quot;:&quot;99.9% de entrega e zero perda de mensagens&quot;,&quot;bold&quot;:true},{&quot;text&quot;:&quot;, mesmo processando milhões de requisições.\n\n&quot;},{&quot;text&quot;:&quot;Conheça o API Connector:&quot;,&quot;bold&quot;:true},{&quot;text&quot;:&quot;\n&quot;},{&quot;type&quot;:&quot;link&quot;,&quot;children&quot;:[{&quot;text&quot;:&quot;https://api-connector.cloud/&quot;}],&quot;props&quot;:{&quot;url&quot;:&quot;https://api-connector.cloud/&quot;,&quot;target&quot;:&quot;_self&quot;,&quot;rel&quot;:&quot;noopener noreferrer&quot;}}],&quot;props&quot;:{&quot;nodeType&quot;:&quot;block&quot;}}]}]}"><h1 data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left"><strong style="font-weight: bolder;">Como conectar qualquer API ao Chatwoot</strong></h1><p data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left">O Chatwoot é uma plataforma <i>open source</i> fantástica para centralizar o atendimento multicanal. No entanto, para extrair o máximo do seu potencial, muitas vezes precisamos conectá-lo a sistemas externos, como CRMs, ERPs, agentes de Inteligência Artificial ou provedores não oficiais de WhatsApp (como Evolution API, Z-API ou W-API).</p><p data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left">Abaixo, detalhamos as melhores abordagens para conectar literalmente qualquer API ao seu Chatwoot, garantindo estabilidade e escalabilidade.</p><h1 data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left">1. A Ponte Universal: Usando webhooks e o n8n</h1><p data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left">A forma mais flexível de integrar o Chatwoot a qualquer serviço externo é utilizando o <strong style="font-weight: bolder;">n8n</strong>, uma ferramenta de automação visual. O fluxo básico funciona assim:</p><ul data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left"><li><strong style="font-weight: bolder;">Enviando do Chatwoot para o n8n</strong>: Configure um Webhookno painel do Chatwoot (em Configurações → Integrações → Webhooks) apontando para a URL do seu n8n. Selecione eventos específicos, comomessage_created, para que o n8n seja notificado apenas quando uma nova mensagem chegar.</li></ul><ul data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left"><li><strong style="font-weight: bolder;">Filtros Importantes</strong>: No n8n, certifique-se de filtrar mensagens de entrada (incoming) e ignorar as mensagens enviadas pelo próprio bot ou atribuídas a um agente humano, evitando assim loops infinitos que podem travar seu servidor.</li></ul><ul data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left"><li><strong style="font-weight: bolder;">Conectando a outras APIs</strong>: Utilize o poderoso node HTTP Request do n8n para consultar bancos de dados externos, enviar leads para o CRM ou se comunicar com a API de provedores como a Evolution API.</li></ul><h1 data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left">2. O Segredo para Enviar Mídias via API no n8n</h1><p data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left">Uma das maiores dificuldades da integração direta via API é o envio de arquivos e áudios do n8n para o Chatwoot. Se você optar por não usar nodes prontos e construir as requisições HTTP na mão (o que evita problemas se a API do Chatwoot for atualizada), existe um truque: Ao enviar a requisição HTTP tipo POST para o Chatwoot, você deve passar o arquivo binário em um campo chamado <code style="background-color: rgb(242 242 242); border-radius: .25rem; font-size: 75%; padding: 3px 6px;">attachment</code>, e formatar o envio como <code style="background-color: rgb(242 242 242); border-radius: .25rem; font-size: 75%; padding: 3px 6px;">data</code> (ex: configurando o tipo como <i>N8N binary file</i> e associando ao nome <code style="background-color: rgb(242 242 242); border-radius: .25rem; font-size: 75%; padding: 3px 6px;">data</code>). Isso garantirá que áudios, imagens e PDFs cheguem perfeitamente à caixa de entrada.</p><h1 data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left">3. Acelerando o processo: Node Comunitário do Chatwoot</h1><p data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left">Se você busca praticidade dentro do n8n, a comunidade criou o pacote <code style="background-color: rgb(242 242 242); border-radius: .25rem; font-size: 75%; padding: 3px 6px;">@fazer-ai/n8n-nodes-chatwoot</code>. Este node facilita imensamente a vida do desenvolvedor, oferecendo:</p><ul data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left"><li><strong style="font-weight: bolder;">Triggers automáticos</strong>: O node cria e gerencia os webhooks no seu Chatwoot automaticamente.</li></ul><ul data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left"><li><strong style="font-weight: bolder;">Operações Nativas</strong>: Permite realizar ações de CRUD (criar, ler, atualizar, deletar) em contatos, conversar, gerenciar caixas de entrada e até gerenciarKanban boards.</li></ul><ul data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left"><li><strong style="font-weight: bolder;">Compatibilidade com IA</strong>: O node suporta ser utilizado como uma "ferramenta de IA" (AI Tool) em fluxos de agentes inteligentes no n8n.</li></ul><h1 data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left">4. Conectores Dedicados para Alta Performance (WhatsApp)</h1><p data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left">Se o seu objetivo exclusivo é conectar instâncias de WhatsApp de provedores como <strong style="font-weight: bolder;">W-API, Z-API ou Whapi</strong>, construir todo o fluxo manualmente pode não ser a melhor rota para alto volume. </p><p data-meta-align="left" data-meta-depth="0" style="margin-left: 0px; text-align: left">Nesses casos, utilizar uma solução self-hosted como o <strong style="font-weight: bolder;">API Connector</strong> pode ser o ideal. Esses conectores rodam no seu servidor (via Docker) e atuam como um roteador bidirecional entre o Chatwoot e as APIs de WhatsApp. Eles utilizam processamento assíncrono com filas Redis e MQTT, garantindo <strong style="font-weight: bolder;">99.9% de entrega e zero perda de mensagens</strong>, mesmo processando milhões de requisições.

<strong style="font-weight: bolder;">Conheça o API Connector:</strong>
<a href="https://api-connector.cloud/" target="_self" rel="noopener noreferrer" style="color: rgb(0 122 255);
                cursor: pointer;
                position: relative;
                text-decoration-line: underline;
                text-underline-offset: 4px;">https://api-connector.cloud/</a></p></body>

Explorando Whatsapp

Como conectar qualquer API externa ao Chatwoot usando o n8n