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

# Freshdesk

[웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)를 사용하면 발신자가 문제를 신고하거나 도움을 요청할 때 리셉셔니스트가 Freshdesk 티켓을 열어 팀에서 처리할 수 있습니다. Growth, Pro, Enterprise 플랜에서는 Freshdesk의 [MCP 서버](#look-up-tickets-with-the-mcp-server)를 연결해 기존 티켓을 조회할 수도 있습니다.

## 티켓 만들기

### API 키 가져오기

Freshdesk에서 프로필 사진을 선택하고 **Profile settings**를 연 다음 **View API key**를 선택합니다. 키를 복사하세요. 이 키는 에이전트 계정 역할을 하므로, 티켓이 해당 권한으로 생성됩니다.

### 인증 헤더 만들기

Freshdesk는 API 키를 사용자 이름으로, `X`를 비밀번호로 사용합니다. 터미널에서 `YOUR_API_KEY`를 키로 바꿔 인코딩하세요.

```bash
printf 'YOUR_API_KEY:X' | base64
```

헤더 값은 `Basic ` 뒤에 출력값을 붙인 형태입니다.

> **Warning**
>
> 온라인 인코더에 API 키를 붙여 넣지 마세요. 키 또는 인코딩된 헤더를 가진 사람은 누구나
> 티켓을 읽고 변경할 수 있습니다.

### 웹훅 도구 만들기

**Integrations**로 이동해 **Add integration**을 선택한 다음 **Webhook Tool**을 선택합니다.

| 필드           | 값                                                                                                                                                                                                                                                                                                    |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **이름**       | `create_freshdesk_ticket`                                                                                                                                                                                                                                                                            |
| **설명**       | "발신자가 문제를 신고하거나 팀의 도움이 필요할 때 지원 티켓을 엽니다."                                                                                                                                                                                                                                                            |
| **메서드**      | POST                                                                                                                                                                                                                                                                                                 |
| **URL**      | `https://YOURDOMAIN.freshdesk.com/api/v2/tickets`                                                                                                                                                                                                                                                    |
| **요청 헤더**    | `Authorization`: `Basic ` 뒤에 인코딩된 키                                                                                                                                                                                                                                                                  |
| **본문 매개변수**  | `name` (문자열, 필수): "발신자의 성명."  `phone` (문자열): "발신자의 전화번호."  `email` (문자열): "발신자가 제공한 경우 이메일 주소."  `subject` (문자열, 필수): "문제의 간단한 요약."  `description` (문자열, 필수): "발신자가 말한 내용과 제공한 세부 정보."  `status` (숫자, 필수): "항상 정확히 `2` 값."  `priority` (숫자, 필수): "항상 정확히 `1` 값."  `source` (숫자, 필수): "항상 정확히 `3` 값." |
| **에이전트에 할당** | **Receptionist**                                                                                                                                                                                                                                                                                     |

`YOURDOMAIN`을 Freshdesk 하위 도메인으로 바꾸세요. **Enable**을 선택합니다.

### 테스트하기

문제를 신고하여 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. Freshdesk에 티켓이 표시됩니다.

고정값은 티켓을 **Open**(상태 `2`)으로 만들고 **Low** 우선순위(우선순위 `1`)로 설정하며, **Phone**(소스 `3`)에서 온 것으로 표시합니다. 리셉셔니스트가 우선순위를 설정하도록 하려면 대신 값을 설명하세요. 예: "낮음은 1, 보통은 2, 높음은 3, 긴급은 4."

Freshdesk에서 요청자를 찾거나 만들려면 전화번호 또는 이메일이 필요합니다. 리셉셔니스트가 항상 발신자의 전화번호를 수집하도록 안내하세요.

## MCP 서버로 티켓 조회하기

Freshdesk의 [MCP 서버](/docs/ko/reception-ai/integrations/mcp-server)는 Growth, Pro, Enterprise 플랜에서 사용할 수 있습니다. 이를 사용하면 리셉셔니스트가 발신자의 기존 티켓을 조회할 수 있습니다. MCP 작업은 플랜에 따라 정해지는 연간 할당량에 포함됩니다.

Reception.ai에서 **Integrations**로 이동해 **Add integration**을 선택한 다음 **MCP Server**를 선택합니다.

| 필드          | 값                                      |
| ----------- | -------------------------------------- |
| **이름**      | Freshdesk                              |
| **서버 유형**   | Streamable HTTP                        |
| **서버 URL**  | `https://YOURDOMAIN.freshdesk.com/mcp` |
| **HTTP 헤더** | `Authorization`: 접두사 없는 API 키          |

Reception.ai가 `Authorization` 헤더를 입력한 그대로 전송하도록 **Secret Token**은 비워 두세요. 사용자 지정 도메인이 있어도 `freshdesk.com` 하위 도메인을 사용하세요. **Enable**을 선택합니다.

**Tools** 탭을 열고 `fetchSearchTickets`, `fetchTicket` 등의 티켓 조회 도구를 **Client**(리셉셔니스트)에 할당하세요. 티켓, 에이전트, 그룹 또는 문서를 업데이트하는 도구는 할당하지 마세요.

## 문제 해결

| 문제                   | 확인할 사항                                                                                    |
| -------------------- | ----------------------------------------------------------------------------------------- |
| Freshdesk에서 401 발생   | 키 뒤에 `:X`를 붙여 인코딩하고, 헤더 값은 `Basic ` 뒤에 공백을 포함해 시작하세요.                                     |
| 요청자 관련 400 발생        | 티켓에는 이름과 함께 전화번호 또는 이메일이 필요합니다. 리셉셔니스트가 이를 수집하는지 확인하세요.                                   |
| 상태 또는 우선순위 관련 400 발생 | `status`, `priority`, `source`는 문자열이 아닌 숫자 매개변수여야 합니다.                                    |
| MCP 서버에 도구가 표시되지 않음  | `freshdesk.com` 하위 도메인을 사용하고, `Authorization` 헤더에는 `Basic`이나 `Bearer` 없이 원본 API 키를 입력하세요. |