AI 상담사에서 매개변수 사용하기

모든 Suite

Team, Growth, Professional, Enterprise 또는 Enterprise Plus

Support

Team, Professional 또는 Enterprise

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

매개변수는 AI 상담사 워크플로우를 조정하기 위해 수집하고 사용할 수 있는 정보입니다. 특히 조건부 블록 , 세그먼트 및 API 연동 에서 매개변수를 활용할 수 있습니다.

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

사용 가능한 매개변수

매개변수는 다음 3가지 소스에서 가져올 수 있습니다.

CRM 플랫폼은 일반적으로 이름 및 이메일 주소와 같은 고객 정보를 저장합니다. CRM 플랫폼에서 이 정보를 가져와 조건부 블록에서 사용하기 위해 저장할 수 있습니다.

CRM 플랫폼에서 정보를 가져오려면 “대화 시작됨” 이벤트 와 연결된 작업을 추가하여 대화가 시작될 때 CRM 에서 데이터를 수집합니다. 모든 새 대화에 대해 정보가 수집되어 AI 상담사 내의 모든 대화에 적용됩니다.

세션 데이터는 AI 상담사 와의 메시징 세션 중 고객이 제공하는 정보를 나타냅니다. 대화 플로우에 블록 수준 작업을 추가하여 세션 데이터를 가져와 매개변수 값으로 저장합니다.

기본적으로 수집되는 세션 매개변수는 다음과 같습니다.

매개변수	사용 사례 예
{{lastDetectedLanguage}}	사용자의 언어로 지원되지 않는 언어 시스템 답장을 제공합니다.
{{active_language}}	언어별 답장을 만듭니다. 매개변수 값으로 이름이 아닌 언어의 ID를 사용해야 합니다. 설정 으로 이동하여 ID를 찾을 수 있습니다.> AI 상담사 설정> 언어 및 언어 선택하기를 참조하세요.
{{chatTranscript}}	이메일을 통해 에스컬레이션할 수 있도록 대화 내용을 티켓에 첨부합니다.
{{lastVisitorMessage}}	다음과 같이 종종 기본 답장에서 고객의 말을 반복합니다. “제가 에 대해 아무것도 모릅니다.{{lastVisitorMessage}} 아직입니다.”
{{integrationId}}	소스 (`integrationId` )의 수신 메시지입니다. 전체 크기 보기
{{confidence_score}}	의도 인식 신뢰도 임계값을 기준으로 답장합니다.`Confidence_score` 정수(정수)로 반올림되거나 내림됩니다. 전체 크기 보기
{{lastResolution}}	마지막 사용자 지정 해결 상태에 따라 다른 대화 플로우를 설정합니다.`Undefined` ,`Informed` ,`Resolved` ,`Not Resolved` ,`Escalated To Agent` , 또는`Escalated via Email` , 에스컬레이션 시 태그로 CRM 에 보냅니다.

작업으로 자체 세션 매개변수를 만들 때 이러한 시스템 매개변수 중 하나와 동일한 이름을 사용하지 마세요. 오류가 발생하고 데이터가 검색되지 않습니다.

엔터티 는 세션 데이터 매개변수로도 간주됩니다. 엔터티의 이름은 매개변수의 이름입니다. 엔터티를 통해 캡처된 모든 정보는 대화 비활성 후 2시간까지 세션 데이터로 저장됩니다.

AI 상담사 사용자 지정 API 연동 서비스 에서 정보를 가져와 개인화된 대화 플로우를 만들 수도 있습니다.

아래 표에는 다음 유형 중 하나에 해당하는 사용 가능한 연산자가 나열되어 있습니다.

연산자	에 사용	예	필요한 매개변수 유형	조건 값 유형
`is / Is not`	단일 값	`country` `is` `Germany`	문자열	문자열
`Is (boolean)`	참 또는 거짓 문	`loggedIn` `Is` `True`	부울	부울
`Is (number)`	단일 값	`timeout is 30`	정수	정수
`Is in / Is not in`	쉼표로 구분된 여러 값이 있는 OR 조건	`country` `In` `Germany, Japan, Finland`	문자열	배열
`Array includes item / Array does not include item`	세션에서 배열로 저장된 값 목록 내에서 특정 값 확인하기	`tags_Array` `Array` `Includes item` `VIP`	배열	문자열
`Text includes / Text does not include`	세션의 텍스트 기반 데이터를 기반으로 URL의 국가 코드와 같은 하위 문자열 확인하기	`URL text` `Includes` `fr`	문자열	문자열
`Is present / Is not present`	특정 값 없이 세션에 매개변수가 있는지 확인하기	`email` `Exists` `country: ''` ,`null` , 또는 완전히 정의되지 않음	아무	해당 사항 없음
`Starts with / Does not start with`	단일 문자열 값	`country` `Starts with` `united`	문자열	문자열
`Greater than` `Greater than or equal` `Less than` `Less than or equal`	모든 숫자 유형(정수 및 부동 소수점), 값이 설정된 값 초과 초과하거나 설정된 값과 같음 설정된 값보다 작음 설정된 값보다 작거나 같음	`Number` `Greater than or equal` `9`	정수 또는 부동 소수점	정수 또는 부동 소수점

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

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