> For the complete documentation index, see [llms.txt](https://docs.poweromni.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweromni.ai/administracao-e-configuracao/artefatos/conectores/n8n.md).

# N8N

{% hint style="danger" %}

### Link do Template pré-configurado do N8N

[<mark style="color:$danger;">Clique aqui</mark>](https://stpowergptprodeastus.blob.core.windows.net/public/TemplateOmniOpenApi.json)
{% endhint %}

O Conector N8N permite que o Power Omni utilize fluxos de trabalho (workflows) criados na plataforma N8N para executar automações complexas, conectar-se a sistemas externos e processar dados, atuando como um poderoso orquestrador de automação.

### Parte 1: Preparação a Importação do Fluxo N8N

Para que o N8N se comunique corretamente com o Power Omni, é necessário importar um *template* de fluxo predefinido com a estrutura correta de gatilho (`Trigger`) e resposta (`Response`).

#### 1.1 Obtenção e Importação do Template

1. Obtenha o Template: Acesse o link do template OpenAPI pré-configurado: \
   [<mark style="color:red;">Clique aqui</mark>](https://stpowergptprodeastus.blob.core.windows.net/public/TemplateOmniOpenApi.json)
2. Salve o Arquivo (`TemplateOmniOpenApi.json`) em seu computador clicando com o botão direito do mouse e selecionando a Opção Salvar como.

<figure><img src="/files/UWQdbg4rvqKJUxemIJaY" alt=""><figcaption></figcaption></figure>

3. Importe no N8N: Acesse sua instância do N8N, clique em Create Workflow (Criar Fluxo de Trabalho).

<figure><img src="/files/MwiJHyLqzDdRiKPhO9I7" alt=""><figcaption></figcaption></figure>

4. Clique no ícone de três pontos (`...`) e selecione Import from File (Importar de Arquivo).

<figure><img src="/files/36feyJK5E8XkCWQQqhIr" alt=""><figcaption></figcaption></figure>

#### 1.2 Configuração da Autenticação no Fluxo

O *template* importado requer a configuração de dois nós de credenciais (`Credentials`) para autenticação no Power Omni.

1. Ajuste o Fluxo: Dentro do fluxo importado, você deve personalizar o fluxo para adicionar sua lógica de negócios (ex: nó de HTTP Request, nó de integração com um CRM, etc.).

<figure><img src="/files/tt3xNovwebP99oRjnzPn" alt=""><figcaption></figcaption></figure>

2. Configure o Nó de Credenciais: Localize o nó responsável pelas credenciais de autenticação do N8N.

<figure><img src="/files/fJgNno0qsYQCqpZLiDuG" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/4t05TlVkQwRu0mKtPZBO" alt=""><figcaption></figcaption></figure>

* Preencha o campo com sua credencial do N8N, ou crie uma nova.<br>

3. Configure o Webhook com a credencial para o Omni ter acesso ao fluxo.

<figure><img src="/files/cHJ9eOr5NE7eXJGKavO8" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/UnAbZr6MXU48jlr84aBz" alt=""><figcaption></figcaption></figure>

* O *Webhook* deve ser configurado com Header Auth para que o Omni tenha acesso seguro ao fluxo.

4. Salve o Fluxo: Salve as alterações do seu fluxo personalizado.

### Parte 2: Ativação do Fluxo e Coleta da URL

O N8N expõe um *endpoint* para que o Power Omni possa enviar a solicitação.

<figure><img src="/files/rcrdi6niz65ymPMaWGma" alt=""><figcaption></figcaption></figure>

1. Localize o nó de Get OpenApi dentro do seu fluxo N8N.

<figure><img src="/files/Ert9ruUMhyKCcsfnJb8E" alt=""><figcaption></figcaption></figure>

2. Dentro das configurações do nó, localize e clique na opção para visualizar o URL de Produção. \
   (Esta é a URL que o Power Omni utilizará para invocar o fluxo.)
3. Copie o URL.
4. Ative o Fluxo: Certifique-se de que o *toggle* na parte superior do seu fluxo esteja ATIVADO para que ele possa receber requisições externas.&#x20;

<figure><img src="/files/3HNMNKkafCDi6W9oQYug" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/MLTGjBG5bf1yICxizDlT" alt=""><figcaption></figcaption></figure>

5. Salve o Fluxo e acesse o Power Omni.

### Parte 3: Criação do Conector no Power Omni

Com o fluxo N8N ativo e a URL de produção em mãos, o último passo é configurar o conector no Power Omni.

#### 3.1 Criação do Conector N8N

1. Acesse o **Portal de Administração** do Power Omni e navegue até **Conectores**.
2. Clique em **"Criar"** e selecione o tipo "Conector N8N".

<figure><img src="/files/PRSZOEeZrZjOcMMWHJPA" alt=""><figcaption></figcaption></figure>

* **Projeto**: Escolha o projeto onde este conector será registrado.
* **Nome**: Para identificação no Portal de Administração (Ex: "Automação Criação de Ticket").
* **Descrição**: Descreva a função do fluxo N8N para o Agente de IA (Ex: "Use para criar enviar um comunicado no Telegram.").

<figure><img src="/files/FvzPAMts6moeIhOjuQW5" alt=""><figcaption></figcaption></figure>

* **Importar conexão existente**: Utilize esta opção caso já tenha criado a conexão com este fluxo em outro momento e deseje reutilizá-la.
* **Criar Nova Conexão**: Utilize caso seja a primeira vez configurando este fluxo. Preencha os detalhes de autenticação abaixo:
* **Nome da Conexão**: Nome interno para a conexão.
* **API Key**: Insira a chave de autenticação (Key) que foi cadastrada no N8N.

<figure><img src="/files/TTIdUg7XXIPRmSTt4fM3" alt=""><figcaption></figcaption></figure>

* **URL Base**: Cole o URL de Produção que você copiou do nó `Get OpenApi` no N8N.
* **Salve o Conector** após preencher todos os campos.

#### 3.2 Conectando ao Agente

1. Acesse **Artefatos > Agentes** no Portal de Administração.
2. Selecione o Agente de IA que deve usar a automação do N8N.
3. Navegue até a aba **Relacionamentos>Conectores**.
4. Localize e adicione o Conector N8N recém-criado.
5. Clique em **"Salvar"**.

#### ✅ Resultado Final

O Agente está pronto para usar a automação. Quando o usuário fizer uma solicitação que corresponda à Descrição da Ferramenta (Ex: "Crie um novo ticket para o cliente X"), o Agente irá acionar o fluxo N8N via WebHook, executando a automação desejada.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.poweromni.ai/administracao-e-configuracao/artefatos/conectores/n8n.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.