작업은 구성된 자동화된 작업입니다. 상담사 코파일럿의 일부인 자동 지원 및 미리 정의된 일련의 자동화된 작업을 수행하는 작업 플로우에 의해 수행될 수 있습니다.
이 문서에서는 다음과 같은 주제를 다룹니다.
관련 문서:
작업을 만들기 위한 성공 사례
작업을 만들 때 다음 성공 사례를 따르세요.
- 인증에 연결을 사용하세요. 작업 구성에 인증 자격 증명을 포함하지 마세요. 대신 민감한 세부 정보를 안전하게 유지하기 위한 목적으로 만들어진 연결을 사용하세요.
- 액세스 권한에 유의하세요. 연결이 상담사와 최종 사용자보다 더 높은 액세스 권한을 가질 수 있다는 사실에 유념하세요. 민감한 데이터를 잘못된 대상과 공유하지 않도록 작업, 절차 및 상담사 교육을 구성하세요.
- 데이터를 가능한 한 비공개로 유지하세요. 작업 응답의 일부를 출력으로 캡처할 때 필요한 특정 데이터 포인트만 캡처하도록 유의하세요. 수행 중인 작업과 직접적으로 관련이 없는 데이터를 캡처하는 것은 좋은 개인정보 보호 관행이 아니며, 자동 지원에 혼동을 줄 수도 있습니다.
-
작업, 입력 및 출력에 좋은 이름과 설명을 쓰세요. 자동 지원은 이름과 설명의 도움을 받아 작업(입력과 출력을 포함하여)이 언제 고객 요청과 관련되는지를 판단합니다. 또한 기존 작업을 변경하는 경우에는 이름과 설명이 정확한지 확인하세요.
이름과 설명은 작업의 의미와 출력을 명확하게 설명해야 합니다. 예:
- 작업 이름: 장바구니에 책 추가
- 작업 설명: 고객의 장바구니에 책을 추가합니다.
자동 지원 절차에서 작업을 칭할 때 비슷한 언어를 사용하여 특정 작업을 시작하세요.
- 예: “고객이 구매하려는 책을 확정한 후 책을 장바구니에 추가합니다.”
- 누락된 입력에 대한 계획을 세우세요. 입력이 가끔씩만 가능하다면 그러한 상황을 어떻게 처리해야 하는지에 대한 설명을 반드시 제공하세요. 예를 들어 모든 요청자에게 이메일 주소가 있는 것은 아닙니다. 따라서 requester_email_address라는 입력에 대한 설명은 "티켓을 시작한 최종 사용자의 이메일 주소입니다. 없으면 '사용할 수 없음'을 사용하세요."라고 할 수 있습니다.
-
작업과 작업 플로우의 이름 및 설명을 명확하게 구분하세요. 작업과 작업 플로우를 모두 사용하는 경우, 각각 사용하는 이름을 명확하게 구분하는 것이 중요합니다. 작업과 작업 플로우가 관리 센터의 별도 부분에서 관리되지만, 자동 지원에서는 둘 다 인식하고 동일한 것으로 간주합니다.
예를 들어 "주문 환불"이라는 작업과 "환불 주문"이라는 작업 플로우가 있는 경우, 이를 구분하기 위해 보다 자세한 설명이 필요합니다. 두 개의 설명이 모두 모호하면 자동 지원이 잘못된 것을 추천하거나 둘 다 선택할 수 있습니다.
작업에 대한 제한
다음과 같은 제한이 작업에 적용됩니다.
- 계정당 최대 100개의 작업을 수행할 수 있습니다.
- 각 작업에는 최대 100개의 입력과 100개의 출력이 있습니다.
- 외부 작업의 시간 제한은 10초입니다. 외부 시스템이 응답하는 데 10초 이상 걸리거나 Zendesk 계정에서 응답을 받지 못하면 해당 작업은 수행되지 않습니다.
- 외부 작업의 최대 응답 크기는 2MB입니다.
- 2025년 3월 13일 전에 만든 작업은 업데이트하고 저장하기 전까지 작업 플로우의 단계로 사용할 수 없습니다.
외부 작업 만들기
관리자는 관리 센터에서 새 외부 작업을 만들 수 있습니다. 외부 작업에는 입력, API 호출, 출력이 필요합니다.
-
입력은 작업이 실행되기 위해 사용하는 정보입니다. 정의하는 각 입력은 작업의 URL, 본문, 쿼리 매개변수 또는 헤더에 삽입될 수 있는 입력 자리 표시자를 만듭니다.
자동 지원은 작업을 실행할 때 이러한 자리 표시자를 데이터로 바꿉니다. 작업 플로우에서 자리 표시자는 작업 플로우 단계의 다양한 특성에 사용할 수 있습니다.
- API 호출은 정보가 API에 전송될 때 정확하게 구성되어야 하는 방법입니다.
- 출력은 API가 리턴한 데이터를 Zendesk가 어떻게 해석해야 하는지를 결정합니다. 정의한 출력은 작업이 실행될 때 자동 지원으로 다시 보낼 API 응답의 일부를 작업에 알려줍니다.
외부 작업을 만들려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서
앱 및 연동 서비스를 클릭한 다음 작업 > 작업을 선택합니다.
- 작업 만들기를 클릭합니다.
-
이름 필드에 작업을 설명하는 이름을 입력합니다.
이 이름이 상담사와 이벤트 로그에 나타납니다.
-
설명 필드에 작업의 설명을 입력합니다.
시스템은 이 설명을 사용하여 언제 자동 지원으로 작업을 사용해야 하는지를 결정합니다. 훌륭한 설명을 쓰는 데 도움이 되도록 작업을 만들기 위한 성공 사례를 참조하세요.
-
입력 섹션에서 입력 추가를 클릭합니다.
-
입력 추가 창에서 다음 필드를 작성합니다.
- 이름: 입력을 설명하는 이름을 입력합니다.
- 설명: 입력에 대한 설명을 입력합니다.
-
유형: 다음 옵션 중에서 선택합니다. 문자열, 정수, 소수, 부울입력 유형은 엄격하게 적용됩니다. 예를 들어 3.0은 정수로 허용되지 않으며, 문자열 “true”는 부울로 허용되지 않으며, 부울 값 false는 문자열로 허용되지 않습니다.
- 입력 추가를 클릭합니다.
-
입력 추가 창에서 다음 필드를 작성합니다.
-
API 구성 창에서 다음 필드를 작성합니다.
- 요청 방법: 수행할 작업에 따라 GET, POST, PATCH, PUT 또는 DELETE를 선택합니다.
-
엔드포인트 URL: 외부 서비스의 URL을 입력합니다.
https:// URL만 허용됩니다.
- 인증: 기존 API 연결을 선택합니다.
-
본문: 이 API 호출에서 요청하는 정보를 입력합니다.
만든 입력에 대한 자리 표시자를 삽입하려면 {+}를 클릭하고 적절한 입력을 선택합니다.
- 쿼리 매개변수: 매개변수 추가를 클릭하고 API 호출에 적용하는 모든 매개변수에 대한 키와 값을 추가합니다.
-
헤더: 헤더 추가를 클릭하고 API 호출에 적용하는 모든 헤더에 대한 이름과 값을 추가합니다.
content-type 헤더는 추가하지 않아도 됩니다. application/json 값만 지원되며, API 호출을 할 때 이 헤더가 자동으로 추가됩니다.
-
출력 섹션에서 출력 추가를 클릭합니다.
- 출력 추가 창에서 구성한 각 입력에 대한 테스트 데이터를 입력합니다.
-
API 호출하기를 클릭합니다.
이 정보가 대표 응답을 리턴하는 외부 서비스에 전송됩니다.
참고: 외부 작업이 실행될 때 응답은 JSON이어야 하며 적절한 JSON 헤더(content-type: application/json)를 가져야 합니다. 다른 JSON 호환 콘텐츠 유형(예: vnd.oracle.resource+json 또는 vnd.api+json)은 현재 지원되지 않습니다. -
출력 탭의 응답에서 적절한 출력을 찾아 추가를 클릭합니다.
응답 본문 탭을 클릭하여 실제 응답이 어떤 형식인지 볼 수 있습니다.
- 출력에 대한 이름과 설명을 입력한 다음 출력 추가를 클릭합니다.
- 필요에 따라 반복하여 자동 지원에 리턴하려는 모든 출력을 캡처합니다.
-
완료를 클릭합니다.
작업이 실행될 때 맵핑된 출력이 응답에 포함되지 않은 경우에도 작업은 계속 성공하지만 자동 지원으로 다시 보낸 응답에는 출력의 키가 생략됩니다.
- 저장을 클릭합니다.
작업 테스트하기
작업을 만들 때 예상대로 작동하는지 반드시 테스트하세요. 필요하면 다양한 응답을 산출하는 다양한 입력 값으로 여러 번 테스트를 실행하여 모든 가능한 출력을 테스트하세요.
작업을 테스트하려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서
앱 및 연동 서비스를 클릭한 다음 작업 > 작업을 선택합니다.
- 편집하려는 작업에 대해 옵션 메뉴(
)를 클릭하고 테스트를 선택합니다.
- 테스트 탭의 입력 섹션에서 구성한 각 입력에 대한 테스트 데이터를 입력합니다.
-
API 호출하기를 클릭합니다.
이 정보가 대표 응답을 리턴하는 외부 서비스에 전송됩니다.
- 출력 섹션에서 응답에 예상되는 정보가 포함되어 있는지 확인합니다
다음은 테스트 중 문제가 발생할 경우 몇 가지 문제 해결 권장 사항입니다.
- 외부 작업을 사용하여 외부 시스템과 상호작용하는 경우에는 해당 제품의 설명서를 참조하여 자세한 문제 해결 정보를 확인하는 것이 가장 좋습니다.
- 테스트 중 발생할 수 있는 HTTP 오류 코드의 개요는 HTTP 응답 상태 코드를 참조하세요.
- 모든 입력과 출력이 사용 사례에 맞는 올바른 데이터 유형(정수, 소수, 문자열 또는 부울)인지 확인합니다.
- 연동 로그에서 작업 실행에 대한 자세한 정보를 볼 수 있습니다.