사용 중인 플랜
모든 Suite Team, Growth, Professional, Enterprise 또는 Enterprise Plus
Support Team, Professional 또는 Enterprise
이 문서에서 설명된 기능은 2026년 5월 11일부터 6월 12일까지 모든 Suite 및 Support 플랜에 배포됩니다. 계정에 아직 이 기능이 표시되지 않을 수도 있습니다. 참조 자세한 내용은 이 공지 사항을 참조하세요.

연동 서비스 빌더 에서 요청 매개변수를 사용하면 AI 상담사 대화에서 데이터(대화 매개변수)를 가져와 외부 엔드포인트로 전달할 수 있습니다. 경우에 따라 API 요청에서 URL 쿼리나 요청 본문으로 보내기 전에 이 데이터를 변환하거나 다시 서식을 지정해야 할 수도 있습니다. 이를 위해 강력한 쿼리 및 변환 언어인 JSONata를 사용할 수 있습니다.

이 문서에서는 다음과 같은 주제를 다룹니다.

  • 요청 매개변수의 값 다시 형식 지정하기
  • 값 서식을 다시 지정하기 위한 일반적인 사용 사례 예

관련 문서:

  • 연동 빌더 리소스

요청 매개변수의 값 다시 형식 지정하기

JSONata를 사용하여 요청 매개변수의 값을 다시 형식화할 수 있습니다.

요청 매개변수의 값을 다시 형식화하려면 다음과 같이 하세요.

  1. AI 상담사 워크스페이스 의 오른쪽 위에 있는 AI 상담사 드롭다운 필드를 사용하여 AI 상담사 선택합니다.
  2. 왼쪽의 주 메뉴에서 API 연동을 클릭합니다.
  3. 연동 서비스를 선택하거나 만듭니다.
  4. 요청 매개변수 페이지에서 값의 서식을 다시 지정하려는 요청 매개변수를 선택하거나 만듭니다.
  5. 테스트 값 필드에서 값 다시 서식 아이콘( ).
  6. 값 다시 서식 지정 대화 상자의 JSONata 다시 서식 지정 필드에서 JSONata를 사용하여 선택한 요청 매개변수 키와 연결된 값을 변환하거나 서식을 다시 지정합니다.
    JSONata 쿼리에서 '$'를 사용하여 값을 다시 형식화하려는 키를 나타냅니다.
    테스트 값 미리 보기 필드를 통해 쿼리 결과를 실시간으로 확인할 수 있습니다.
  7. 완료를 클릭합니다.
  8. (선택 사항) API 요청의 본문에 request 매개변수를 추가하는 경우:
    1. 왼쪽의 환경 헤더 아래에서 적절한 환경을 선택합니다.
    2. 본문 탭을 선택합니다.
    3. 요청 매개변수를 이중 중괄호 안의 값으로 사용하여 JSON 개체를 추가합니다.

값 서식을 다시 지정하는 일반적인 사용 사례

연동 빌더 내에서 요청 매개변수를 특정 키에 배정하여 정의할 수 있습니다. 이러한 값은 그대로 작동할 수 있지만 외부 시스템의 요구 사항에 맞게 변환하거나 다시 형식을 지정해야 하는 시나리오가 있습니다.

예를 들어, 다음과 같은 작업을 수행하고자 할 수 있습니다.

  • 날짜 다시 서식 지정 : API 요구 사항에 맞게 날짜 형식을 MM/DD/YYYY에서 YYYY-MM-DD 또는 ISO 8601로 변경합니다.
  • 문자열 연산 수행 : 문자를 추가 또는 제거하거나, 여러 필드를 결합하거나, HTML을 포함하도록 문자열을 변환하는 등 문자열을 처리합니다.
  • 조건부 논리 적용 : 필드가 비어 있는지 확인하거나 필요한 경우 기본값을 배정하는 등의 조건을 적용합니다.

이 섹션에는 다음 예가 포함되어 있습니다.

  • 시나리오: 날짜 다시 서식 지정
  • 시나리오: 링크를 클릭할 수 있도록 URL 서식 다시 지정하기
  • 시나리오: 가독성을 높이기 위해 채팅 대화 내용 다시 서식 지정하기

시나리오: 날짜 다시 서식 지정

이 시나리오에서는 엔드포인트가 YYYY-MM-DD 또는 ISO 8601 형식의 날짜를 확인해야 합니다. 하지만 대화의 경우 날짜를 DD/MM/YYYY와 같은 사용자 친화적인 형식으로 표시하고자 합니다.

다음은 이 시나리오에서 사용할 JSONata 쿼리입니다.

$substring($, 6, 10) & "-" & $substring($, 3, 2) & "-" & $substring($, 0, 2)

시나리오: 링크를 클릭할 수 있도록 URL 서식 다시 지정하기

이 시나리오에서는 http:// 또는 https://로 시작하고 그 뒤에 공백이 아닌 여러 문자가 오는 텍스트(하위 문자열)를 검색하여 URL을 클릭 가능한 링크로 변환하고자 합니다. 그런 다음 JSONata $replace 함수를 사용하여 해당 하위 문자열을 HTML에서 일치하는 URL을 래핑하는 문자열로 바꾸고자 합니다.< a> 태그를 추가하여 클릭 가능한 링크를 만듭니다.

다음은 이 시나리오에서 사용할 JSONata 쿼리입니다.

(
$text := "Chat transcript unavailable. Here is a link:https://www.zendesk.com. Here is another link: https://www.w3schools.com.";

$replace($text, /(https?:\/\/[^\s]+)/, '<a href="$1">$1</a>'
)

시나리오: 가독성을 높이기 위해 채팅 대화 내용 다시 서식 지정하기

이 시나리오에서는 티켓에 채팅 대화 내용을 추가하려고 합니다. 하지만 기본 양식에서는 채팅 대화 내용을 잘 읽을 수 없습니다.

  • 채팅 대화 내용 - 2024-10-12 (13:04:10) AI 상담사: 고객 엔지니어링 AI 상담사 에 오신 것을 환영합니다! (13:04:10) AI 상담사: 테스트할 연동 서비스 선택: (13:04:10) 방문자: test c.id: d501304d-da09-4485-a4c7-1c708ec0005d 모든 시간(UTC 기준)

각 메시지를 새 줄로 나누어 더욱 사용자 친화적인 형식으로 변환하고자 합니다. 각 새 메시지는 여는 괄호( ( )로 시작하므로 JSONata를 사용하여 ( )가 나타날 때마다 줄 바꿈과 (.

다시 서식이 지정된 대화는 다음과 같이 표시됩니다.

  • 채팅 대화 내용 - 2024-10-12
    (13:04:10) AI 상담사: 연동 빌더 AI 상담사 에 오신 것을 환영합니다!
    (13:04:10) AI 상담사: 테스트할 연동 서비스 선택:
    (13:04:10) 방문자: test c.id: d501304d-da09-4485-a4c7-1c708ec0005d 모든 시간(UTC 기준)

다음은 이 시나리오에서 사용할 JSONata 쿼리입니다.

$replace($, “(“, “\n(“)

또한 요청과 함께 전송되도록 환경의 본문 섹션에 이 매개변수를 추가해야 합니다.

{
"chatTranscript": "{{chatTranscript}}"
}

 

번역 고지 사항: 본 문서는 콘텐츠에 대한 기본적인 이해를 제공하기 위해 자동 번역 소프트웨어를 사용하여 번역되었습니다. 정확한 번역을 제공하고자 합당한 노력을 기울였으나 Zendesk는 번역의 정확성을 보장하지 않습니다.

번역된 문서에 포함된 정보의 정확성과 관련하여 질문이 있으시면 문서의 공식 버전인 영문 버전을 참조하시기 바랍니다.

Zendesk 제공