SMS 통합 참조
메시지 context 오브젝트에 조치 명령을 추가하여 전화를 통해 SMS 메시지를 제출하여 어시스턴트와 상호 작용하는 고객과의 대화 흐름을 관리하십시오.
SMS 연동 서비스에서 사용되는 지원되는 명령과 예약된 컨텍스트 변수에 대해 알아보세요.
지원되는 명령
각 조치는 command 특성 다음에 매개변수가 필요한 명령의 매개변수를 정의하는 선택적 parameter 특성으로 구성됩니다. 다음 표에 설명된 명령은 SMS 통합에서 지원됩니다.
| 조치 명령 | 설명 | 매개변수 |
|---|---|---|
terminateSession |
현재 SMS 세션을 종료합니다. 이 명령을 사용하여 후속 문자 메시지가 현재 세션의 컨텍스트 값을 보유하지 않는 새 어시스턴트 레벨 세션을 | |
| 시작하는지 확인하십시오. | 없음 | |
smsActSendMedia |
MMS 메시징을 사용으로 설정합니다. | mediaURL: 사용자에게 전송된 공개적으로 액세스 가능한 매체 URL의 JSON 배열을 지정합니다. |
smsActSetDisambiguationConfig |
모호성 제거 목록에 표시되는 선택사항을 처리하는 방법을 구성합니다. | prefixText: 각 옵션 앞에 포함할 텍스트입니다. 예를 들어 Press %s for입니다. 여기서 %s 는 목록 선택사항에 해당하는 숫자를 나타냅니다. |
| 이 변수는 런타임 시 실제 숫자로 대체됩니다. | ||
smsActSetOptionsConfig |
옵션 응답 유형을 처리하는 방법을 구성합니다. | prefixText: 각 옵션 앞에 포함할 텍스트입니다. 예를 들어 Press %s for입니다. 여기서 %s 는 목록 선택사항에 해당하는 숫자를 나타냅니다. |
| 이 변수는 런타임 시 실제 숫자로 대체됩니다. |
예약된 컨텍스트 변수
다음 표에서는 SMS 통합의 맥락에서 특별한 의미를 갖는 컨텍스트 변수에 대해 설명합니다. 문서화된 용도 이외의 용도로는 사용하지 않아야 합니다.
표 2에는 사용자의 조치로 설정된 컨텍스트 변수가 설명되어 있습니다. 표 3에서는 SMS 연동으로 설정할 수 있는 컨텍스트 변수에 대해 설명합니다.
표 2. 조치로 설정된 컨텍스트 변수
| 컨텍스트 변수 이름 | 예상 값 | 설명 |
|---|---|---|
smsConversationResponseTimeout |
시간(ms) | 통합이 조치로부터 응답을 수신하기 위해 대기하는 시간(밀리초)입니다. 시간 한계를 초과하면 통합이 조치에 대한 연결을 다시 시도합니다. 서비스에 여전히 연결할 수 없으면 SMS 응답에 실패합니다. |
표 3. 통합에 의해 설정되는 컨텍스트 변수
| 컨텍스트 변수 이름 | 설명 |
|---|---|
smsTenantPhoneNumber |
사용자가 메시징 중인 통합 테넌트 전화번호입니다. |
smsUserPhoneNumber |
통합과 메시지를 교환하는 사용자의 전화번호입니다. |
smsUserData |
서비스 오케스트레이션 엔진 또는 watsonx Assistant 서비스에 그대로 전달할 JSON 형식의 데이터입니다. 이 변수는 세션이 통합 테넌트에서 시작되고 데이터가 REST API를 통해 전송되는 경우에만 전송됩니다. |
smsSessionTimeoutCount |
세션 제한시간 값입니다. 이 변수는 제한시간 값이 REST API를 통해 정의된 경우에만 전송됩니다. |
smsError |
통합에서 SMS 메시지를 보내는 데 실패하면 이 변수에는 발생한 오류에 대한 세부사항이 포함됩니다. |
smsSessionID |
관련 SMS 게이트웨이 세션의 GUID(Globally Unique Identifier)입니다. |
smsMedia |
arraylist의 mediaURL 및 해당 mediaContentType입니다. 이 컨텍스트 변수는 각 대화 턴(turn) 종료 시 지워집니다. |