n8n | ElevenLabs Documentation

n8n 워크플로를 웹훅 도구에 연결하세요. 대화가 도구 설명과 일치하면 리셉셔니스트가 세부 정보를 수집하고 워크플로를 호출한 뒤, 응답을 발신자에게 읽어 줍니다. 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을 선택한 다음 워크플로를 트리거해야 하는 대화로 리셉셔니스트를 테스트하세요. 각 실행은 n8n의 Executions 목록에 표시됩니다.

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

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

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

문제 해결

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