탐색으로 건너뛰기
통합설정 가이드지원

Freshdesk

웹훅 도구로 통화에서 Freshdesk 티켓을 만듭니다.

웹훅 도구를 사용하면 발신자가 문제를 신고하거나 도움을 요청할 때 리셉셔니스트가 Freshdesk 티켓을 열어 팀에서 처리할 수 있습니다. Growth, Pro, Enterprise 플랜에서는 Freshdesk의 MCP 서버를 연결해 기존 티켓을 조회할 수도 있습니다.

티켓 만들기

1

API 키 가져오기

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

2

인증 헤더 만들기

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

printf 'YOUR_API_KEY:X' | base64

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

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

3

웹훅 도구 만들기

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

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

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

4

테스트하기

문제를 신고하여 리셉셔니스트를 테스트하세요. Freshdesk에 티켓이 표시됩니다.

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

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

MCP 서버로 티켓 조회하기

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

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

필드값
이름Freshdesk
서버 유형Streamable HTTP
서버 URLhttps://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 키를 입력하세요.