> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrow no n8n

> Conecte a API da Enrow ao n8n com Header Auth e crie seu primeiro fluxo de busca de e-mail com webhooks

Este guia mostra como conectar a API da Enrow ao n8n e criar seu primeiro fluxo de trabalho: uma busca de e-mail individual que retorna o resultado automaticamente por meio de um webhook. O n8n é uma ferramenta de automação de fluxos de trabalho que permite conectar a Enrow a centenas de outros serviços, e pode ser auto-hospedado ou executado no n8n Cloud.

<Note>
  **Não tem o n8n?** [Instale o n8n](https://docs.n8n.io/hosting/) ou use o [n8n Cloud](https://n8n.io/cloud/) para começar em poucos minutos.
</Note>

## O que eu preciso antes de começar?

Para seguir este guia, você precisa de duas coisas:

* n8n instalado (auto-hospedado ou na nuvem)
* Uma chave de API da Enrow ([obtenha uma aqui](https://app.enrow.io/settings/api-keys))

Toda requisição à Enrow é autenticada com a chave de API no cabeçalho `x-api-key` — não há fluxos OAuth nem bearer tokens. Para os detalhes completos, consulte [Authentication](/pt/authentication).

## Como armazeno minha chave de API da Enrow no n8n?

Armazene a chave de API uma única vez como uma credencial **Header Auth** reutilizável, para não precisar colá-la em cada node:

1. No n8n, abra **Credentials** → **New**
2. Escolha **Header Auth**
3. Defina **Name** como `x-api-key`
4. Defina **Value** como sua chave de API da Enrow
5. Salve a credencial (por exemplo, nomeie-a como "Enrow API")

Agora você pode referenciar essa credencial em qualquer node HTTP Request em seus fluxos de trabalho.

## Como crio um fluxo de trabalho que encontra um único e-mail?

O fluxo de trabalho tem três partes: um gatilho para iniciá-lo, um node HTTP Request que chama o endpoint [Find Single Email](/pt/api-reference/email-finder/find-single) e um node Webhook que recebe o resultado quando a busca é concluída.

### Passo 1: Crie um novo fluxo de trabalho

1. Abra o n8n
2. Clique em **"New Workflow"**
3. Nomeie-o como "Enrow - Find Email"

### Passo 2: Adicione um Manual Trigger

1. Clique no botão **"+"**
2. Pesquise por **"Manual Trigger"**
3. Adicione-o ao seu canvas

O Manual Trigger permite executar o fluxo de trabalho sob demanda enquanto você o testa.

### Passo 3: Adicione um node HTTP Request

1. Clique em **"+"** após o Manual Trigger
2. Pesquise por **"HTTP Request"**
3. Configure-o:

**Authentication:**

* Authentication: `Generic Credential Type`
* Generic Auth Type: `Header Auth`
* Name: `x-api-key`
* Value: `YOUR_ENROW_API_KEY`

**Request:**

* Method: `POST`
* URL: `https://api.enrow.io/email/find/single`
* Body Content Type: `JSON`
* JSON Body:

```json theme={null}
{
  "company_domain": "apple.com",
  "fullname": "Tim Cook"
}
```

### Passo 4: Teste o fluxo de trabalho

1. Clique em **"Execute Workflow"** no topo
2. Você deve ver uma resposta com um `id` de busca
3. A busca é processada de forma assíncrona — o `id` é o que você usará para recuperar o resultado

### Passo 5: Receba os resultados com um webhook

A Enrow executa buscas de forma assíncrona, portanto, em vez de fazer polling, deixe o n8n receber o resultado automaticamente. A API da Enrow fará um POST do resultado para a URL do seu webhook assim que a busca terminar. Consulte [How webhooks work](/pt/how-webhooks-work) para o fluxo completo.

1. Adicione um node **"Webhook"** ao seu canvas

2. Defina:
   * HTTP Method: `POST`
   * Path: `enrow-email-result`

3. Copie a **Production URL** (por exemplo, `https://your-n8n.com/webhook/enrow-email-result`)

4. Atualize o JSON do seu node HTTP Request para incluir o webhook em `settings`:

```json theme={null}
{
  "company_domain": "apple.com",
  "fullname": "Tim Cook",
  "settings": {
    "webhook": "https://your-n8n.com/webhook/enrow-email-result"
  }
}
```

5. Salve e ative o fluxo de trabalho

Agora, quando a busca for concluída, a Enrow fará um POST do resultado para o seu node de webhook.

## Posso importar um fluxo de trabalho pronto?

Sim. Copie o JSON abaixo para começar rapidamente e depois importe-o no n8n.

```json theme={null}
{
  "name": "Enrow - Find Email with Webhook",
  "nodes": [
    {
      "parameters": {},
      "name": "Manual Trigger",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [250, 300]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.enrow.io/email/find/single",
        "authentication": "headerAuth",
        "sendBody": true,
        "bodyContentType": "json",
        "jsonBody": "={\n  \"company_domain\": \"apple.com\",\n  \"fullname\": \"Tim Cook\",\n  \"settings\": {\n    \"webhook\": \"{{$node[\"Webhook\"].json[\"webhookUrl\"]}}\"\n  }\n}",
        "options": {}
      },
      "name": "Find Email",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 3,
      "position": [450, 300],
      "credentials": {
        "headerAuth": {
          "name": "Enrow API"
        }
      }
    },
    {
      "parameters": {
        "httpMethod": "POST",
        "path": "enrow-email-result",
        "responseMode": "onReceived",
        "options": {}
      },
      "name": "Webhook",
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 1,
      "position": [650, 300],
      "webhookId": "your-webhook-id"
    }
  ],
  "connections": {
    "Manual Trigger": {
      "main": [[{"node": "Find Email", "type": "main", "index": 0}]]
    },
    "Find Email": {
      "main": [[{"node": "Process Result", "type": "main", "index": 0}]]
    }
  }
}
```

Para importar o fluxo de trabalho:

1. Copie o JSON acima
2. No n8n, clique em **"..."** → **"Import from File/URL/String"**
3. Cole o JSON
4. Atualize a chave de API nas credenciais
5. Ative!

## Quais são as boas práticas para n8n + Enrow?

<AccordionGroup>
  <Accordion title="Armazene a chave de API como credencial">
    Crie uma credencial **Header Auth** com:

    * Name: `x-api-key`
    * Value: sua chave de API da Enrow

    Reutilize essa credencial em todos os fluxos de trabalho em vez de colar a chave de API em cada node.
  </Accordion>

  <Accordion title="Use webhooks, não nodes Wait">
    Webhooks são mais confiáveis do que fazer polling com nodes Wait. Sempre passe o parâmetro `settings.webhook` para que a Enrow entregue o resultado assim que a busca for concluída.
  </Accordion>

  <Accordion title="Trate os erros com elegância">
    Adicione um node **"Error Trigger"** para capturar e tratar erros da API. Consulte [Error handling](/pt/error-handling) e [Status codes](/pt/status-codes) para os formatos de resposta esperados.
  </Accordion>

  <Accordion title="Use endpoints em lote para várias buscas">
    Se você estiver processando muitos contatos, use o endpoint [Find Bulk Emails](/pt/api-reference/email-finder/find-bulk) (até 5.000 buscas por lote) em vez de iterar requisições individuais.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Por que recebo um erro Unauthorized?">
    Um `401 Unauthorized` significa que a chave de API está ausente ou inválida. Verifique se a credencial **Header Auth** tem `x-api-key` como **Name** e sua chave de API válida da Enrow como **Value**. Consulte [Authentication](/pt/authentication) para mais detalhes.
  </Accordion>

  <Accordion title="Por que meu webhook não está recebendo dados?">
    Primeiro, certifique-se de que o fluxo de trabalho esteja **ativado**, não apenas salvo. Em seguida, confirme se a URL do webhook no parâmetro `settings.webhook` corresponde à **Production URL** do node Webhook. Você pode testar a URL diretamente com uma ferramenta como o Postman. Consulte [How webhooks work](/pt/how-webhooks-work) para o fluxo de entrega.
  </Accordion>

  <Accordion title="Por que recebo um erro Rate Limit Exceeded?">
    Um erro de limite de taxa significa que você enviou requisições demais rápido demais. Adicione um node **"Wait"** entre operações em lote, ou use os endpoints em lote em vez de iterar. Consulte [Rate limits](/pt/rate-limits) para os limites atuais.
  </Accordion>

  <Accordion title="Onde posso obter ajuda?">
    Para dúvidas sobre fluxos de trabalho, use o [n8n Community Forum](https://community.n8n.io). Para dúvidas sobre a API, entre em contato com o [Enrow Support](https://help.enrow.io).
  </Accordion>
</AccordionGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Email Enrichment" icon="table" href="/pt/playbooks/n8n/email-enrichment-workflow">
    Enriqueça contatos a partir de uma planilha no n8n.
  </Card>

  <Card title="Email Verification" icon="shield-check" href="/pt/playbooks/n8n/lead-verification-workflow">
    Verifique listas de e-mails de leads em um fluxo de trabalho do n8n.
  </Card>

  <Card title="Find Single Email" icon="envelope" href="/pt/api-reference/email-finder/find-single">
    Veja os parâmetros do endpoint e o formato da resposta.
  </Card>

  <Card title="How webhooks work" icon="bell" href="/pt/how-webhooks-work">
    Seja notificado automaticamente quando uma busca for concluída.
  </Card>
</CardGroup>