Referencia de integración de SMS
Añada mandatos de acción al objeto de mensaje context para gestionar el flujo de conversaciones con clientes que interactúan con el asistente enviando mensajes SMS a través del teléfono.
Infórmate sobre los comandos compatibles y las variables de contexto reservadas que utiliza la integración de SMS.
Mandatos soportados
Cada acción consta de una propiedad command, seguida de una propiedad opcional parameter para definir parámetros para mandatos que los necesitan. Los comandos que se describen en la siguiente tabla son compatibles con
la integración de SMS.
| Mandato de acción | Descripción | Parámetros |
|---|---|---|
terminateSession |
Finaliza la sesión SMS actual. Utilice este mandato para asegurarse de que el siguiente mensaje de texto inicia una nueva sesión de nivel de asistente que no conserva ningún valor de contexto de la sesión actual. | Ninguna |
smsActSendMedia |
Habilita la mensajería MMS. | mediaURL: especifica una matriz JSON de los URL de soporte de acceso público que se envían al usuario. |
smsActSetDisambiguationConfig |
Configura cómo manejar las opciones que se muestran en una lista de desambiguación. | prefixText: texto que se debe incluir antes de cada opción. Por ejemplo, Press %s for donde %s representa el número correspondiente a una opción de lista; esto se sustituye por el número real en tiempo
de ejecución. |
smsActSetOptionsConfig |
Configura cómo manejar tipos de respuesta de opciones. | prefixText: texto que se debe incluir antes de cada opción. Por ejemplo, Press %s for donde %s representa el número correspondiente a una opción de lista; esto se sustituye por el número real en tiempo
de ejecución. |
Variables de contexto reservadas
La siguiente tabla describe las variables de contexto que tienen un significado especial en el contexto de la integración de SMS. No se deben utilizar para ninguna otra finalidad que no sea el uso documentado.
La Tabla 2 describe las variables de contexto establecidas por la acción. En la Tabla 3 se describen las variables de contexto que puede establecer la integración de SMS.
Tabla 2. Variables de contexto establecidas por la acción
| Nombre de variable de contexto | Valor previsto | Descripción |
|---|---|---|
smsConversationResponseTimeout |
Tiempo en ms | Tiempo en milisegundos que la integración espera la recepción de una respuesta de la acción. Si se supera el límite de tiempo, la integración intenta volver a ponerse en contacto con la acción. Si sigue sin poderse acceder al servicio, la respuesta de SMS falla. |
Tabla 3. Variables de contexto establecidas por la integración
| Nombre de variable de contexto | Descripción |
|---|---|
smsTenantPhoneNumber |
El número de teléfono del arrendatario de integración al que el usuario envía mensajes. |
smsUserPhoneNumber |
Número de teléfono del usuario que está intercambiando mensajes con la integración. |
smsUserData |
Datos en formato JSON que se pasarán textualmente al motor de orquestación de servicios o al servicio watsonx Assistant. Esta variable sólo se envía si la sesión se inicia desde el arrendatario de la integración y los datos se envían a través de la API REST. |
smsSessionTimeoutCount |
Valor de tiempo de espera de sesión. Esta variable sólo se envía si el valor de tiempo de espera se define a través de la API REST. |
smsError |
Cuando la integración no puede enviar un mensaje SMS, esta variable contiene detalles sobre el error que se ha producido. |
smsSessionID |
El identificador exclusivo global (GUID) de la sesión SMS Gateway relacionada. |
smsMedia |
La arraylist de mediaURL y la mediaContentType correspondiente. Esta variable de contexto se borra al final de cada turno de conversación. |