> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# n8n

Conecte um workflow do n8n a uma [ferramenta de webhook](/docs/pt/reception-ai/integrations/webhooks). Quando uma conversa corresponder à descrição da ferramenta, seu recepcionista coleta os detalhes, chama o workflow e lê a resposta para quem ligou. Pelo n8n, o recepcionista pode acessar qualquer app ao qual o n8n se conecta.

## Crie o workflow

### Adicione um gatilho Webhook

No n8n, crie um workflow e adicione um nó **Webhook**. Defina **HTTP Method** como `POST`.

### Proteja o webhook

Defina **Authentication** como **Header Auth** e crie uma credencial com um nome de cabeçalho, como `X-Reception-Key`, e um valor aleatório longo. O Reception.ai envia esse cabeçalho a cada chamada.

### Retorne uma resposta

Defina **Respond** como **Using 'Respond to Webhook' Node**. Adicione as etapas do workflow e finalize com um nó **Respond to Webhook** que retorne JSON, por exemplo `{"available": true, "next_slot": "Tuesday 10am"}`. Seu recepcionista lê essa resposta para decidir o que dizer.

### Ative o workflow

Ative o workflow e copie a **Production URL** do nó Webhook. A URL de teste funciona apenas enquanto o editor está em escuta.

## Crie a ferramenta de webhook

Acesse **Integrations**, selecione **Add integration** e escolha **Webhook Tool**.

| Campo                | Valor                                                                                                                                  |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | O que o workflow faz, por exemplo, `check_service_area`                                                                                |
| **Description**      | Quando usá-la, por exemplo, "Verifique se atendemos o CEP de quem ligou. Use-a antes de agendar uma visita no local."                  |
| **Method**           | POST                                                                                                                                   |
| **URL**              | A URL de produção do workflow                                                                                                          |
| **Request Headers**  | O nome e o valor do cabeçalho da credencial do n8n                                                                                     |
| **Body Parameters**  | Um parâmetro para cada valor de que o workflow precisa, por exemplo, `zip_code` (string, obrigatório). O n8n os lê de `body.zip_code`. |
| **Assign to agents** | **Receptionist**                                                                                                                       |

Selecione **Enable** e, depois, [teste seu recepcionista](/docs/pt/reception-ai/receptionist/testing) com uma conversa que deve acionar o workflow. Cada execução aparece na lista **Executions** do n8n.

> **Note**
>
> Os parâmetros do corpo são valores simples que seu recepcionista preenche com base na conversa. Para enviar um
> valor fixo, defina-o dentro do workflow.

## Exponha vários workflows via MCP

Para disponibilizar muitos workflows do n8n ao seu recepcionista de uma só vez, use o nó **MCP Server Trigger** do n8n. Conecte os workflows ou nós de ferramentas que quiser expor, defina a autenticação do gatilho como bearer e ative-o. No Reception.ai, adicione um [servidor MCP](/docs/pt/reception-ai/integrations/mcp-server) com a URL de produção do gatilho e o token bearer como **Secret Token**; depois, atribua as ferramentas na aba **Tools**.

## Solução de problemas

| Problema                                        | O que verificar                                                                                                                                                                       |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nenhuma execução aparece no n8n                 | O workflow deve estar ativo e a ferramenta deve usar a URL de produção.                                                                                                               |
| O workflow retorna 403                          | O nome e o valor do cabeçalho no Reception.ai devem corresponder exatamente à credencial do n8n.                                                                                      |
| O recepcionista informa que a ferramenta falhou | O workflow deve terminar dentro do **Response timeout** da ferramenta. O padrão é 20 segundos e o máximo é 120.                                                                       |
| O recepcionista nunca chama a ferramenta        | Faça a descrição da ferramenta indicar as situações em que ela deve ser usada. Você também pode adicionar um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures). |