> 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

n8n 워크플로를 [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)에 연결하세요. 대화가 도구 설명과 일치하면 리셉셔니스트가 세부 정보를 수집하고 워크플로를 호출한 뒤, 응답을 발신자에게 읽어 줍니다. n8n을 통해 리셉셔니스트는 n8n이 연결하는 모든 앱에 접근할 수 있습니다.

## 워크플로 만들기

### Webhook 트리거 추가

n8n에서 워크플로를 만들고 **Webhook** 노드를 추가하세요. **HTTP Method**를 `POST`로 설정하세요.

### 웹훅 보호

**Authentication**을 **Header Auth**로 설정하고, `X-Reception-Key`와 같은 헤더 이름과 긴 무작위 값으로 자격 증명을 만드세요. Reception.ai는 모든 통화에 이 헤더를 전송합니다.

### 응답 반환

**Respond**를 **Using 'Respond to Webhook' Node**로 설정하세요. 워크플로 단계를 추가한 후 JSON을 반환하는 **Respond to Webhook** 노드로 마무리하세요. 예: `{"available": true, "next_slot": "Tuesday 10am"}`. 리셉셔니스트는 이 응답을 읽고 말할 내용을 결정합니다.

### 워크플로 활성화

워크플로를 활성화하고 Webhook 노드에서 **Production URL**을 복사하세요. 테스트 URL은 편집기가 수신 대기 중일 때만 작동합니다.

## 웹훅 도구 만들기

**Integrations**로 이동해 **Add integration**을 선택한 다음 **Webhook Tool**을 선택하세요.

| 필드           | 값                                                                            |
| ------------ | ---------------------------------------------------------------------------- |
| **이름**       | 워크플로가 수행하는 작업(예: `check_service_area`)                                       |
| **설명**       | 사용 시점(예: "발신자의 우편번호 지역에 서비스를 제공하는지 확인합니다. 현장 방문을 예약하기 전에 사용하세요.")            |
| **메서드**      | POST                                                                         |
| **URL**      | 워크플로의 프로덕션 URL                                                               |
| **요청 헤더**    | n8n 자격 증명의 헤더 이름과 값                                                          |
| **본문 매개변수**  | 워크플로에 필요한 값마다 하나의 매개변수(예: `zip_code`(문자열, 필수)). n8n은 `body.zip_code`에서 읽습니다. |
| **에이전트에 할당** | **Receptionist**                                                             |

**Enable**을 선택한 다음 워크플로를 트리거해야 하는 대화로 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 각 실행은 n8n의 **Executions** 목록에 표시됩니다.

> **Note**
>
> 본문 매개변수는 리셉셔니스트가 대화에서 채우는 단일 값입니다. 고정 값을 전송하려면
> 대신 워크플로 내부에서 설정하세요.

## MCP를 통해 여러 워크플로 노출하기

리셉셔니스트에 여러 n8n 워크플로를 한 번에 제공하려면 n8n의 **MCP Server Trigger** 노드를 사용하세요. 노출할 워크플로 또는 도구 노드를 연결하고, 트리거의 인증을 bearer로 설정한 다음 활성화하세요. Reception.ai에서 트리거의 프로덕션 URL과 bearer 토큰을 **Secret Token**으로 사용해 [MCP 서버](/docs/ko/reception-ai/integrations/mcp-server)를 추가한 다음, **Tools** 탭에서 도구를 할당하세요.

## 문제 해결

| 문제                     | 확인할 사항                                                                                                |
| ---------------------- | ----------------------------------------------------------------------------------------------------- |
| n8n에 실행이 표시되지 않음       | 워크플로가 활성화되어 있어야 하며 도구는 프로덕션 URL을 사용해야 합니다.                                                            |
| 워크플로가 403을 반환함         | Reception.ai의 헤더 이름과 값은 n8n 자격 증명과 정확히 일치해야 합니다.                                                      |
| 리셉셔니스트가 도구에 실패했다고 말함   | 워크플로는 도구의 **Response timeout** 내에 완료되어야 합니다. 기본값은 20초이며 최대 120초까지 설정할 수 있습니다.                         |
| 리셉셔니스트가 도구를 전혀 호출하지 않음 | 도구 설명에 사용해야 하는 상황을 명시하세요. [절차](/docs/ko/reception-ai/receptionist/rules-and-procedures)를 추가할 수도 있습니다. |