# 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FtWQR3Se4Lhup9539Zo5a%2Fimage.png?alt=media&#x26;token=1e6574bb-aeba-495e-9e15-4e21e38a0688" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F1mrPRDk8keR0XZMhUPlG%2Fimage.png?alt=media&#x26;token=2058ed0e-e027-45b6-8df7-488fb18ab749" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F6fXdS5kivtMCDCEjVDTl%2Fimage.png?alt=media&#x26;token=9b39e692-cc8a-4f3f-a944-3f81671842fc" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FTzgJsRprWCjRYSqcyYLG%2Fimage.png?alt=media&#x26;token=6f6879cc-3489-446e-a734-0f01007042cb" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F0efs8xXCWxMd6oLQHxqn%2Fimage.png?alt=media&#x26;token=25b6e0e7-5fed-42ed-8166-a70dbec71813" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F30PvIYCTQsYrPAGYIcS9%2Fimage.png?alt=media&#x26;token=48f3b2c3-ab28-4a93-9559-4d6f4151b265" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FMYR3pkWJHRZJonFHh11J%2Fimage.png?alt=media&#x26;token=44a5392b-7f74-4175-b904-1659392bd34d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F0lEJYWNPYAv9zfBQ0w0X%2Fimage.png?alt=media&#x26;token=ecc18ff5-bd07-4fde-90db-20eff3cd9dff" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FjHbafjML6O0irKxNO34B%2Fimage.png?alt=media&#x26;token=1a3846e6-d4c0-4f61-8adf-ccac0ae0f4cb" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FVxLlbd8uEuJNR2zp8mra%2Fimage.png?alt=media&#x26;token=5d83fd50-2163-4023-a03c-c62dffdb9e1e" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FNm0edvdMXKVZPdpsszxU%2Fimage.png?alt=media&#x26;token=78b13731-703c-4e58-8718-abc8df5a9564" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FRdtVP9rnCIChDN1IfKps%2Fimage.png?alt=media&#x26;token=7efb763f-066a-4e42-bf71-cc516d85f523" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FTa7KpMgmBhMWwg0SnVld%2Fimage.png?alt=media&#x26;token=a23d54ca-70b1-408c-b251-38d3b8d2e661" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2F1EZI6rCn4whp4oCyu4Sv%2Fimage.png?alt=media&#x26;token=81bf6875-9298-4456-bcdb-b8c489a81177" 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="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FzMemAab4Gj0t9EtGd4rk%2Fimage.png?alt=media&#x26;token=dd3c698a-c5f5-49ec-8188-1a589dd0c1ff" 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.