상담원

Freshdesk API 상담원

Freshdesk에서 고객 문의를 처리하는 사용자를 **상담원(Agent)**이라고 불러요. Freshdesk API의 상담원 엔드포인트를 이용하면 상담원을 만들고, 목록을 조회하고, 정보를 수정하거나 삭제하고, 소속된 그룹·역할·스킬까지 API로 관리할 수 있어요.

상담원은 '상근(full-time)'과 '임시(occasional)' 두 종류로 나뉘어요. 상근 상담원은 매일 헬프데스크에 로그인하는 핵심 지원 팀이고, 임시 상담원은 CEO나 현장 담당자처럼 한 달에 몇 번만 로그인하는 경우를 말해요. 이 둘은 occasional 속성으로 구분하죠. 참고로 me(인증된 본인) API를 제외한 모든 상담원 API는 관리자(admin) 권한이 있어야 호출할 수 있어요.

출처: 문서

본문

상담원(Agents) 개요

상담원 API에서 주고받는 주요 속성은 다음과 같아요. id는 상담원의 사용자 ID이고, 소속 그룹·역할·스킬은 각각 group_ids, role_ids, skill_ids 배열로 표현돼요. ticket_scope는 상담원이 볼 수 있는 티켓 범위, type은 상담원 유형을 나타내요.

속성	타입	설명
available	boolean	"자동 티켓 배정(Automatic Ticket Assignment)"이 켜진 그룹에 속한 상담원이 새 티켓을 받고 있으면 true
available_since	datetime	상담원이 available/unavailable 상태가 된 시각(available 값에 따라 달라져요)
id	number	상담원의 사용자 ID
occasional	boolean	임시 상담원이면 true (true → occasional, false → full-time)
signature	string	HTML 형식의 상담원 서명
ticket_scope	number	상담원의 티켓 권한 (1 → 전체 접근, 2 → 그룹 접근, 3 → 제한 접근)
type	string	상담원 유형 (support_agent → 지원 상담원, field_agent → 현장 상담원, collaborator → 협력자)
skill_ids	array of numbers	상담원과 연결된 스킬 ID
group_ids	array of numbers	상담원과 연결된 그룹 ID
role_ids	array of numbers	상담원과 연결된 역할 ID
created_at	datetime	상담원 생성 시각
updated_at	datetime	상담원 수정 시각
contact[active]	string	상담원이 검증(verified)되었으면 true
contact[email]	string	상담원의 이메일 주소
contact[job_title]	string	상담원의 직함
contact[language]	string	상담원의 언어. 기본값은 "en"
contact[last_login_at]	timestamp	상담원의 마지막 성공 로그인 시각
contact[mobile]	string	상담원의 휴대폰 번호
contact[name]	string	상담원의 이름
contact[phone]	number	상담원의 전화번호
contact[time_zone]	string	상담원의 시간대
contact[created_at]	datetime	생성 시각
contact[updated_at]	datetime	마지막 수정 시각
focus_mode	boolean	상담원의 집중 모드(focus mode) 여부

상담원 조회 (View an Agent)

상담원 ID로 한 명의 상담원 정보를 조회해요.

GET /api/v2/agents/[id]

curl -v -u yourapikey:X -X GET 'https://domain.freshdesk.com/api/v2/agents/432'

응답은 아래처럼 상담원 속성과 contact 객체가 함께 담겨요.

{
  "available":true,
  "occasional":false,
  "signature":null,
  "group_ids" : [
    4
  ],
  "role_ids" : [
    1
  ],
  "skill_ids" : [
    2
  ],
  "id":432,
  "ticket_scope":1,
  "created_at":"2015-08-28T11:47:58Z",
  "updated_at":"2015-08-28T11:47:58Z",
  "available_since":null,
  "type": "support_agent",
  "contact":{
    "active":false,
    "email":"[email protected]",
    "job_title":"Journalist",
    "language":"en",
    "last_login_at":null,
    "mobile":null,
    "name":"Clark Kent",
    "phone":null,
    "time_zone":"Chennai",
    "created_at":"2015-08-28T09:08:16Z",
    "updated_at":"2015-08-28T11:47:58Z"
  },
  "focus_mode": true
}

상담원 목록 (List All Agents)

필터를 적용해 조건에 맞는 상담원 목록을 조회할 수 있어요. 아래 필터들은 서로 조합할 수도 있어요.

GET /api/v2/agents

필터를 쓸 때는 쿼리 문자열을 URL 인코딩해야 해요.

필터	처리 방식
email, mobile, phone	/api/v2/agents?= 예: /api/v2/[email protected] /api/v2/agents?mobile=7654367287 /api/v2/agents?phone=4352789885
state	/api/v2/agents?state=[fulltime/occasional]

curl -v -u yourapikey:X -X GET 'https://domain.freshdesk.com/api/v2/agents'

응답은 상담원 배열로 돌아와요.

[
   {
      "available":true,
      "occasional":false,
      "signature":null,
      "id":1,
      "ticket_scope":1,
      "created_at":"2015-08-18T16:18:05Z",
      "updated_at":"2015-08-18T16:18:05Z",
      "available_since":null,
      "type": "support_agent",
      "contact":{
         "active":true,
         "email":"[email protected]",
         "job_title":null,
         "language":"en",
         "last_login_at":"2015-08-21T14:54:46+05:30",
         "mobile":null,
         "name":"Support",
         "phone":null,
         "time_zone":"Chennai",
         "created_at":"2015-08-18T16:18:05Z",
         "updated_at":"2015-08-25T08:50:20Z"
      },
      "focus_mode": true
   },
   {
      "available":true,
      "occasional":false,
      "signature":null,
      "signature":null,
      "id":432,
      "ticket_scope":1,
      "created_at":"2015-08-28T11:47:58Z",
      "updated_at":"2015-08-28T11:47:58Z",
      "available_since":null,
      "type": "support_agent",
      "contact":{
         "active":false,
         "email":"[email protected]",
         "job_title":"Journalist",
         "language":"en",
         "last_login_at":null,
         "mobile":null,
         "name":"Clark Kent",
         "phone":null,
         "time_zone":"Chennai",
         "created_at":"2015-08-28T09:08:16Z",
         "updated_at":"2015-08-28T11:47:58Z"
      },
      "focus_mode": true
   },
   ...
]

추가 예시 (Additional Examples)

이메일 주소로 필터링한 목록이에요. 이메일은 고유하므로 목록에 상담원이 한 명만 돌아와요.

curl -v -u yourapikey:X -X GET 'https://domain.freshdesk.com/api/v2/[email protected]'

처음 20명의 상근(fulltime) 상담원을 조회해요. 기본적으로 상담원은 알파벳 순서로 돌아와요.

curl -v -u yourapikey:X -X GET 'https://domain.freshdesk.com/api/v2/agents?state=fulltime&per_page=20'

상담원 생성 (Create an Agent)

새 상담원을 만들 때는 email과 ticket_scope가 **필수(MANDATORY)**예요. role_ids에는 상담원 유형에 맞는 역할을 하나 이상 연결해야 해요.

POST /api/v2/agents/

속성	타입	설명
occasional	boolean	임시 상담원이면 true (true → occasional, false → full-time)
signature	string	HTML 형식의 상담원 서명
ticket_scope 필수	number	상담원의 티켓 권한 (1 → 전체 접근, 2 → 그룹 접근, 3 → 제한 접근). 현재 로그인된 본인은 자신의 ticket_scope를 수정할 수 없어요
skill_ids	array of numbers	상담원과 연결된 스킬 ID
group_ids	array of numbers	상담원과 연결된 그룹 ID
contribution_group_ids	array of numbers	ticket_scope가 2일 때 상담원이 보기 전용으로 접근할 수 있는 그룹 ID
role_ids	array of numbers	상담원과 연결된 역할 ID. 상담원에 역할이 하나 이상 연결되어야 해요. 현재 로그인된 본인은 자신의 role_ids를 수정할 수 없어요 (역할 ID는 상담원 유형에 맞아야 해요. 예: 협력자 상담원에는 티켓 협력자, 지원 상담원에는 상담원 또는 관리자)
agent_type	number	상담원 유형 (1 → 지원 상담원, 2 → 현장 상담원, 3 → 협력자). 기본값은 지원 상담원
email 필수	string	상담원의 이메일 주소
language	string	상담원의 언어. 기본값은 "en"
time_zone	string	상담원의 시간대. 기본값은 도메인의 시간대
focus_mode	boolean	상담원의 집중 모드. 기본값은 true

curl -v -u yourapikey:X -H "Content-Type: application/json" -X POST -d '{ "email":"[email protected]", "name": "Super man", "ticket_scope":1, "occasional": true, "language": "en", "group_ids": [1], "role_ids": [2], "skill_ids": [3] }'https://domain.freshdesk.com/api/v2/agents'

{
    "available": false,
    "occasional": true,
    "id": 1,
    "ticket_scope": 1,
    "signature": "<div dir=\"ltr\"><p><br></p>\n</div>",
    "group_ids": [
        1
    ],
    "role_ids": [
        2
    ],
    "skill_ids": [
        3
    ],
    "created_at": "2019-12-19T04:07:53Z",
    "updated_at": "2019-12-19T04:07:53Z",
    "available_since": null,
    "type": "support_agent",
    "contact": {
        "active": false,
        "email": "[email protected]",
        "job_title": null,
        "language": "en",
        "last_login_at": null,
        "mobile": null,
        "name": "Super man",
        "phone": null,
        "time_zone": "Chennai",
        "created_at": "2019-12-19T04:07:53Z",
        "updated_at": "2019-12-19T04:07:53Z"
    },
    "focus_mode": true
}

focus_mode를 끄고 상담원 생성

focus_mode를 false로 지정하면 집중 모드가 꺼진 상태로 만들어요. 협력자 상담원을 만들려면 agent_type을 3으로 주면 되죠.

curl -v -u yourapikey:X -H "Content-Type: application/json" -X POST -d '{ "email":"[email protected]", "name": "Super man", "ticket_scope":1, "occasional": true, "language": "en", "group_ids": [1], "role_ids": [2], "skill_ids": [3], "agent_type": 3, "focus_mode": false }'https://domain.freshdesk.com/api/v2/agents'

{
    "available": false,
    "occasional": true,
    "id": 1,
    "ticket_scope": 1,
    "signature": "<div dir=\"ltr\"><p><br></p>\n</div>",
    "group_ids": [
        1
    ],
    "role_ids": [
        2
    ],
    "skill_ids": [
        3
    ],
    "created_at": "2019-12-19T04:07:53Z",
    "updated_at": "2019-12-19T04:07:53Z",
    "available_since": null,
    "type": "support_agent",
    "contact": {
        "active": false,
        "email": "[email protected]",
        "job_title": null,
        "language": "en",
        "last_login_at": null,
        "mobile": null,
        "name": "Super man",
        "phone": null,
        "time_zone": "Chennai",
        "created_at": "2019-12-19T04:07:53Z",
        "updated_at": "2019-12-19T04:07:53Z"
    },
    "focus_mode": false
}

추가 예시 (Additional Examples)

협력자(Collaborator) 상담원을 만들어요. 이 기능을 쓰려면 Collaborators 기능이 필요해요.

curl -v -u yourapikey:X -H "Content-Type: application/json" -X POST -d '{ "email":"[email protected]", "name": "Super man", "ticket_scope":1,
      "occasional": true, "language": "en", "group_ids": [1],
      "role_ids": [2], "skill_ids": [3], "agent_type": 3 }'https://domain.freshdesk.com/api/v2/agents'

상담원 수정 (Update an Agent)

기존 상담원 정보를 갱신할 때 써요. 다만 상담원의 이름, 전화, 휴대폰 번호, 직함은 API로 수정할 수 없어요. 이 값들은 Neo Admin Center에서 수정해야 해요.

PUT /api/v2/agents/[id]

속성	타입	설명
occasional	boolean	임시 상담원이면 true (true → occasional, false → full-time)
signature	string	HTML 형식의 상담원 서명
ticket_scope	number	상담원의 티켓 권한 (1 → 전체 접근, 2 → 그룹 접근, 3 → 제한 접근). 현재 로그인된 본인은 자신의 ticket_scope를 수정할 수 없어요
skill_ids	array of numbers	상담원과 연결된 스킬 ID
group_ids	array of numbers	상담원과 연결된 그룹 ID
contribution_group_ids	array of numbers	ticket_scope가 2일 때 상담원이 보기 전용으로 접근할 수 있는 그룹 ID
role_ids	array of numbers	상담원과 연결된 역할 ID. 상담원에 역할이 하나 이상 연결되어야 해요. 현재 로그인된 본인은 자신의 role_ids를 수정할 수 없어요 (역할 ID는 상담원 유형에 맞아야 해요. 예: 협력자 상담원에는 티켓 협력자, 지원 상담원에는 상담원 또는 관리자)
email	string	상담원의 이메일 주소
language	string	상담원의 언어. 기본값은 "en"
time_zone	string	상담원의 시간대. 기본값은 도메인의 시간대
focus_mode	boolean	상담원의 집중 모드. 기본값은 true

curl -v -u yourapikey:X -H 'Content-Type: application/json' -X PUT -d '{ "ticket_scope":1, "name":"Super Agent" }' 'https://domain.freshdesk.com/api/v2/agents/1'

{
  "available" : true,
  "occasional" : false,
  "id" : 1,
  "ticket_scope" : 1,
  "signature" : "Super Agent",
  "group_ids" : [
    4
  ],
  "role_ids" : [
    1
  ],
  "skill_ids" : [
    1
  ],
  "created_at" : "2016-05-25T11:36:14Z",
  "updated_at" : "2016-07-06T12:25:57Z",
  "available_since" : null,
  "type": "support_agent",
  "contact" : {
    "active" : true,
    "email" : "[email protected]",
    "language" : "en",
    "last_login_at" : "2016-06-14T11:07:52Z",
    "time_zone" : "Chennai",
    "created_at" : "2016-02-29T06:32:29Z",
    "updated_at" : "2016-06-24T14:30:20Z"
  }
}

상담원 삭제 (Delete an Agent)

상담원을 삭제하면 해당 사용자는 상담원에서 연락처(contact)로 강등돼요. 그리고 수정과 마찬가지로 상담원의 이름·전화·휴대폰 번호·직함은 API로 바꿀 수 없어요.

DELETE /api/v2/agents/[id]

curl -v -u yourapikey:X -X DELETE 'https://domain.freshdesk.com/api/v2/agents/2'

성공하면 응답 본문 없이 204 No Content가 돌아와요.

HTTP Status: 204 No Content

현재 인증된 상담원 (Currently Authenticated Agent)

API를 호출한 본인(현재 인증된 상담원)의 정보를 조회해요. 관리자 권한 없이도 호출할 수 있는 유일한 상담원 API죠.

GET /api/v2/agents/me

curl -v -u yourapikey:X -X GET 'https://domain.freshdesk.com/api/v2/agents/me'

{
  "available":true,
  "occasional":false,
  "signature":null,
  "group_ids" : [
    4
  ],
  "role_ids" : [
    1
  ],
  "skill_ids": [
  1
  ],
  "id":432,
  "ticket_scope":1,
  "created_at":"2015-08-28T11:47:58Z",
  "updated_at":"2015-08-28T11:47:58Z",
  "available_since":null,
  "type": "support_agent",
  "contact":{
    "active":false,
    "email":"[email protected]",
    "job_title":"Journalist",
    "language":"en",
    "last_login_at":null,
    "mobile":null,
    "name":"Clark Kent",
    "phone":null,
    "time_zone":"Chennai",
    "created_at":"2015-08-28T09:08:16Z",
    "updated_at":"2015-08-28T11:47:58Z"
  }
}

상담원 일괄 생성 (Create Multiple Agents)

여러 상담원을 한 번에 만들 수 있어요. email과 ticket_scope가 필수이고, 요청 본문의 agents 배열에 상담원들을 담아 보내요.

POST /api/v2/agents/bulk

속성	타입	설명
occasional	boolean	임시 상담원이면 true (true → occasional, false → full-time)
signature	string	HTML 형식의 상담원 서명
ticket_scope 필수	number	상담원의 티켓 권한 (1 → 전체 접근, 2 → 그룹 접근, 3 → 제한 접근). 현재 로그인된 본인은 자신의 ticket_scope를 수정할 수 없어요
skill_ids	array of numbers	상담원과 연결된 스킬 ID
group_ids	array of numbers	상담원과 연결된 그룹 ID
contribution_group_ids	array of numbers	ticket_scope가 2일 때 상담원이 보기 전용으로 접근할 수 있는 그룹 ID
role_ids	array of numbers	상담원과 연결된 역할 ID. 상담원에 역할이 하나 이상 연결되어야 해요. 현재 로그인된 본인은 자신의 role_ids를 수정할 수 없어요
name	string	상담원의 이름
email 필수	string	상담원의 이메일 주소
phone	string	상담원의 전화번호
mobile	string	상담원의 휴대폰 번호
job_title	string	상담원의 직함
language	string	상담원의 언어. 기본값은 "en"
time_zone	string	상담원의 시간대. 기본값은 도메인의 시간대
focus_mode	boolean	상담원의 집중 모드. 기본값은 true

curl -v -u yourapikey:X -H "Content-Type: application/json" -X POST -d '{ "agents": [{"email":"[email protected]", "name": "Super man", "ticket_scope":1, "occasional": true, "language": "en", "group_ids": [1], "role_ids": [2], "skill_ids": [3] },{"email":"[email protected]", "name": "Support agent", "ticket_scope":1, "occasional": false, "language": "de", "group_ids": [10], "role_ids": [12], "skill_ids": [3] }] }' https://domain.freshdesk.com/api/v2/agents/bulk'

일괄 생성은 비동기로 처리돼요. 응답으로 작업 ID(job_id)와 진행 상황을 확인할 수 있는 href가 돌아와요.

{ 
"job_id": 100,
 "href": "https://domain.freshdesk.com/api/v2/jobs/100" 
}

상담원 검색 (Search Agents)

상담원을 이름이나 이메일로 검색할 수 있어요. 검색은 대소문자를 구분하지 않지만, 문자열 일부(substring)로는 검색되지 않는다는 점을 기억해 두세요. 예를 들어 "John Jonz" 상담원은 "john", "Joh", "Jonz", "jon"으로 찾을 수 있지만 "hn"이나 "th"로는 검색되지 않아요.

GET /api/v2/agents/autocomplete?term=[keyword]

curl -v -u yourapikey:X -X GET 'https://domain.freshdesk.com/api/v2/agents/autocomplete?term=John'

[
   {
     "id": 33,
     "name": "John Jonz",
     "email": "[email protected]",
     "avatar": null
   },
   {
      "id": 456,
      "name": "John Steven Jonz",
      "email": "[email protected]",
      "avatar": null
   }
 ]

상담원 가용성 (Availability)

상담원의 가용성(availability)은 담당 가능한 티켓 수, 로그인 여부, 라운드 로빈 배정, 상태 ID 등을 포함해요. 가용성 관련 JSON 매개변수는 다음과 같아요.

매개변수	설명
assignment_limit	상담원이 처리할 수 있는 최대 티켓 수
current_assignment_load	상담원이 현재 처리 중인 티켓 수
available	티켓을 처리할 수 있으면 true, 아니면 false
channel	Freshdesk 계정의 채널 이름. 예: Email queue, Messaging queue, Freshdesk. 큐(queue)는 새 FD Omni SKU에서 제공되고, 그 외에는 Freshdesk로 표시돼요
logged_in	Freshdesk에 로그인되어 있으면 true, 아니면 false
round_robin_enabled	자동 티켓 배정이 켜진 그룹에 속해 있으면 true, 아니면 false
availability_updated_at	가용성이 마지막으로 갱신된 시각
status_id	상담원의 상태 ID. 예: 1294529
pause_assignment	true면 통화 중에 해당 상담원의 티켓 배정을 일시 중지하고, false면 통화 중에도 배정을 중지하지 않아요
status_updated_at	상태가 마지막으로 갱신된 시각
idle_enabled	일정 시간 활동이 없으면 상담원 상태를 "Idle"로 설정하는 기능. 활성화되면 true. 켜져 있고 그룹 설정에서 새 라우팅 유형(고급 자동 라우팅)이 선택되고 티켓 재배정 옵션이 켜져 있으면, 상담원이 idle 상태일 때 티켓이 다른 가용 상담원에게 재배정돼요
availability_control	상담원의 가용성 제어 방식. 예: agent_controlled, admin_controlled. agent_controlled면 상담원이 자신의 가용성을 제어하고, supervized_controlled면 관리자가 제어해요
legacy_routing	상담원이 레거시 라우팅 유형으로 설정된 그룹에 속해 있으면 true, 아니면 false
deactivated	상담원이 비활성화되었으면 true, 아니면 false
contact_type	모든 상담원에서 "contact" 값
other_phone_numbers	상담원의 기타 전화번호. 예: ["+1234567890", "+0987654321"]

모든 상담원 가용성 목록 (List All Agents Availability)

only=availability를 붙이면 상담원 목록과 함께 가용성 데이터를 돌려줘요.

GET /api/v2/agents?page=1&per_page=10&only=availability

속성	타입	설명
page	number	반환할 페이지 번호
per_page	number	페이지당 반환할 상담원 수
only	string	이 값이 "availability"일 때만 가용성 데이터가 추가돼요

curl -v -u yourapikey:X -X GET 'https://domain.freshdesk.com/api/v2/agents?page=1&per_page=10&only=availability'

[
   {
      "id": 446114,
      "user_data": {
         "user": {
           "id": 446114,
           "name": "Akash",
           "email": "[email protected]",
           "created_at": "2025-10-07T12:10:20Z",
           "updated_at": "2025-10-07T12:12:03Z",
           "account_id": 11011318525,
           "active": true,
           "customer_id": null,
           "job_title": null,
           "phone": null,
           "mobile": null,
           "twitter_id": null,
           "description": null,
           "time_zone": "Eastern Time (US & Canada)",
           "deleted": false,
           "fb_profile_id": null,
           "language": "en",
           "address": null,
           "external_id": null,
           "helpdesk_agent": true,
           "unique_external_id": null,
           "company_id": null,
           "contact_type": "contact",
           "other_phone_numbers": null
         }
      },
         "contact": {
         "name": "Akash",
         "email": "[email protected]",
         "avatar": null
         },
         "availability": {
         "agent_ref": "#{base_url}/api/v2agents/432",
         "channel_availability": [
         {
             "assignment_limit": 3,
             "current_assignment_load": 0,
             "available": false,
             "channel": "Messaging queue",
             "logged_in": true,
             "round_robin_enabled": true,
             "availability_updated_at": "2025-10-09T11:30:26Z",
             "status_id": 1302477
         },
         {
            "assignment_limit": 10,
            "current_assignment_load": 0,
            "available": false,
            "channel": "Email queue",
            "logged_in": true,
            "round_robin_enabled": true,
            "availability_updated_at": "2025-10-09T11:30:26Z",
            "status_id": 1302477
         }
         ],
         "availability_control": "agent_controlled"
         }
   },
   ...
]

상담원 가용성 조회 (View Agent Availability)

한 상담원의 가용성만 조회하고 싶을 때 써요.

GET /api/v2/agents/[id]/availability

curl -v -u yourapikey:X -X GET 'https://domain.freshdesk.com/api/v2/agents/432/availability'

{
    "agent_ref": "#{base_url}/agents/432",
    "channel_availability": [
        {
            "assignment_limit": 10,
            "current_assignment_load": 0,
            "available": true,
            "channel": "Email queue",
            "logged_in": true,
            "round_robin_enabled": true,
            "availability_updated_at": "2025-08-19T20:05:35Z",
            "status_id": 1294529,
            "pause_assignment": false,
        },
        {
            "assignment_limit": 3,
            "current_assignment_load": 0,
            "available": false,
            "channel": "Messaging queue",
            "logged_in": true,
            "round_robin_enabled": true,
            "availability_updated_at": "2025-08-19T20:05:15Z",
            "status_id": 1294529,
            "pause_assignment": false
        },
        {
            "assignment_limit": 10,
            "current_assignment_load": 0,
            "available": false,
            "channel": "freshdesk",
            "logged_in": true,
            "round_robin_enabled": true,
            "availability_updated_at": "2025-08-19T20:05:15Z",
            "status_id": 1294529,
            "pause_assignment": false
        }
    ],
    "idle_enabled": false,
    "status_updated_at": "2025-08-19T20:05:15Z",
    "availability_control": "agent_controlled"
}

상담원 부하 설정 갱신 (Update Agent load settings)

상담원의 배정 한도(assignment limit)나 가용성 제어 방식을 갱신할 때 써요.

PUT /api/v2/agents/[id]/availability

curl -v -u yourapikey:X -H 'Content-Type: application/json' -X PATCH -d '{ "channel_availability": [ { "assignment_limit": 20, "channel": "Email queue" } ], "availability_control": "agent_controlled" }''https://domain.freshdesk.com/api/v2/agents/1/availability'

{
    "channel_availability": [
        {
            "channel": "Messaging queue",
            "assignment_limit": 30
        },
        {
            "channel": "freshdesk",
            "assignment_limit": 10
        },
        {
            "channel": "Email queue",
            "assignment_limit": 20
        }
    ],
    "availability_control": "agent_controlled"
}

배정 한도만 바꾸려면 channel_availability만 보내면 돼요.

curl -v -u yourapikey:X -H 'Content-Type: application/json' -X PATCH -d '{ "channel_availability": [ { "assignment_limit": 20, "channel": "Email queue" }, { "assignment_limit": 20, "channel": "Messaging queue" }, ] }''https://domain.freshdesk.com/api/v2/agents/1/availability'

{
    "channel_availability": [
        {
            "channel": "Messaging queue",
            "assignment_limit": 20
        },
        {
            "channel": "freshdesk",
            "assignment_limit": 10
        },
        {
            "channel": "Email queue",
            "assignment_limit": 20
        }
    ]
}

더 알아보기

• 공식 문서