봇 빌더 변수를 사용하면 대화와 관련된 데이터를 기반으로 메시징 봇의 답변을 사용자 지정할 수 있습니다. 메시징 메타데이터 변수는 현재 고객의 신원 및 인증 상태에 대한 정보를 포함하는 봇 빌더에서 사용되는 변수의 유형입니다.
메시징 메타데이터 변수는 메시징 인증에 사용되는 서명된 JSON 웹 토큰(JWT)에서 값을 가져옵니다. 대화 중 메시징 봇은 이 데이터를 사용하여 응답을 사용자 지정하거나, 해당 고객에 대한 정보를 표시하거나, 대화의 플로우를 분기할 수 있습니다.
봇 변수의 광범위한 개요와 이를 답변에서 사용할 수 있는 방법은 변수를 사용하여 봇 답변 개인화하기를 참조하세요.
메시징 메타데이터 변수 사용 설정하기
메시징 메타데이터 변수는 기본적으로 사용 설정되지 않습니다. 메시징 메타데이터 변수를 사용 설정하려면 관리자가 메시징 인증을 위한 JWT 생성에 사용되는 서명 키를 만들어야 합니다. 메시징 인증 및 메시징 메타데이터 변수는 웹 위젯 및 모바일 SDK 채널에서만 사용할 수 있습니다.
메시징 인증 설정에 대한 자세한 내용은 웹 위젯 및 모바일 SDK용 메시징에서 최종 사용자 인증하기를 참조하세요.
지원되는 메시징 메타데이터 변수
| 메시징 메타데이터 변수 이름 | Description |
|---|---|
| 제공된 이메일 | 고객의 이메일 주소입니다. 이 이메일 주소는 메시징 인증에 사용되는 JWT에서 가져옵니다. |
| 제공된 이름 | 고객의 이름입니다. 이 이름은 메시징 인증에 사용되는 JWT에서 가져옵니다. |
| 인증된 외부 ID | 고객을 식별하는 고유한 영숫자 문자열입니다. 이 ID는 메시징 인증에 사용되는 JWT에서 가져옵니다. |
| 인증 상태 | true이면 고객이 인증됩니다. 그렇지 않으면 false입니다. 이 변수는 항상 true 또는 fals이며 비워둘 수 없습니다. 조건별 브랜치 단계에서 인증 상태 변수를 사용할 때에는 다음과 같음 연산자만 지원됩니다. |
제공된 이름과 제공된 이메일 변수 사용하기
제공된 이름 및 제공된 이메일 변수를 사용할 때 다음 고려 사항을 염두에 두세요.
- 메시징 봇은 세부 정보 묻기 단계에서 인증된 고객의 이름 및 이메일 변수 수집을 자동으로 건너뜁니다. 인증된 고객의 경우에는 이러한 변수가 비어 있고 대화의 나중 단계에서 건너뜁니다. 대신 제공된 이름과 제공된 이메일 변수를 사용하세요.
세부 정보 묻기 단계에서 건너뛴 이름 및 이메일 변수 수집 제공된 이름 및 제공된 이메일 변수 
- 메시징 인증에 사용되는 JWT에는 고객의 이름이나 이메일 주소가 필요하지 않습니다. 조직에서 JWT에 이름이나 이메일 주소를 포함하지 않으면 각각의 제공된 이름 및 제공된 이메일 변수가 비어 있으며 대화 중에 건너뜁니다.
그런 경우에는 이름 및 이메일 주소를 포함하도록 JWT를 업데이트하는 것이 좋습니다.
- 인증되지 않은 고객의 경우에는 제공된 이름 및 제공된 이메일 변수가 비어 있습니다. 인증되지 않은 고객에 대한 답변 단계에서 이러한 변수를 사용하지 마세요.
인증되지 않은 고객에게 메시징 메타데이터 변수 사용하기
고객이 인증되지 않은 경우에는 인증 상태 변수의 값이 false입니다. 인증되지 않은 고객에 대한 다른 메시징 메타데이터 변수는 비어 있으며 대화 중에 건너뜁니다.
메시징 메타데이터 변수 사용을 위한 성공 사례
메시징 메타데이터 변수를 사용하는 답변을 만들 때 다음 성공 사례를 염두에 두세요.
- 메시징 인증에 사용되는 JWT에 고객의 이름이나 이메일 주소를 포함하지 않는 경우에는 제공된 이름 및 제공된 이메일 변수를 사용하지 마세요.
- 인증된 고객과 인증되지 않은 고객 모두에게 제공되는 답변 플로우를 만들려면 조건별 브랜치 단계를 사용하여 고객의 인증 상태 변수를 확인하세요. 인증 상태가 true인 브랜치에만 메시징 메타데이터 변수를 포함하세요.
- 인증된 고객에게만 제공되는 답변을 만드는 중이며 조직의 JWT에 이름과 이메일 주소가 포함되어 있는 경우에는 고객의 이름 및 이메일 주소에 제공된 이름 및 제공된 이메일 변수를 사용하세요. 그러한 경우에는 세부 정보 묻기 단계를 사용하여 이 정보를 다시 수집하지 않아도 됩니다.