Ir para a navegação

n8n

Execute workflows do n8n durante chamadas com uma ferramenta de webhook.

Conecte um workflow do n8n a uma ferramenta de webhook. 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

1

Adicione um gatilho Webhook

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

2

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.

3

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.

4

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.

CampoValor
NameO que o workflow faz, por exemplo, check_service_area
DescriptionQuando usá-la, por exemplo, “Verifique se atendemos o CEP de quem ligou. Use-a antes de agendar uma visita no local.”
MethodPOST
URLA URL de produção do workflow
Request HeadersO nome e o valor do cabeçalho da credencial do n8n
Body ParametersUm 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 agentsReceptionist

Selecione Enable e, depois, teste seu recepcionista com uma conversa que deve acionar o workflow. Cada execução aparece na lista Executions do n8n.

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 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

ProblemaO que verificar
Nenhuma execução aparece no n8nO workflow deve estar ativo e a ferramenta deve usar a URL de produção.
O workflow retorna 403O nome e o valor do cabeçalho no Reception.ai devem corresponder exatamente à credencial do n8n.
O recepcionista informa que a ferramenta falhouO workflow deve terminar dentro do Response timeout da ferramenta. O padrão é 20 segundos e o máximo é 120.
O recepcionista nunca chama a ferramentaFaça a descrição da ferramenta indicar as situações em que ela deve ser usada. Você também pode adicionar um procedimento.