SMS-Siptel
- Tipo de canal: Texto.
- Visibilidad del canal: Privado.
- Complejidad de integración: Media — requiere cuenta activa con Siptel, clave de acceso (token) y número remitente autorizado; se completa con un formulario directo (sin flujo OAuth ni aprobación externa).
- Chat general o solo Kyubo: Chat general.
- Sandbox disponible: No.
Definición
El envío de SMS se realiza a través del proveedor Siptel, y existen dos piezas de configuración relacionadas pero distintas:
- La acción Siptel SMS del diseñador de flujos: permite enviar un SMS individual (estático o con datos dinámicos del flujo) desde dentro de un flujo de atención o como acción independiente en respuestas automatizadas, para automatizar notificaciones, confirmaciones o alertas personalizadas.
- El canal SMS Siptel (Configurar Canal): debe existir configurado en el tenant cuando el envío de SMS se hace como parte de una campaña. Ambas configuraciones son similares en los datos que piden, pero una es la configuración de la acción y la otra la del canal — ver ambas más abajo.
Requisitos previos
- Cuenta activa con Siptel, con permisos habilitados para el envío de mensajes SMS.
- Clave de acceso al servicio (API Key), obtenida desde el portal de administración de Siptel.
- Número remitente autorizado y validado por Siptel, en formato internacional sin el signo "+" (ej.
569XXXXXXXX). - Campaña registrada (opcional): solo si se usan mensajes asociados a campañas, con una plantilla de SMS válida configurada.
Método de integración (configuración de la acción Siptel SMS)
Important
Para enviar un único mensaje, defina el contenido directamente en el campo correspondiente. Si desea enviar SMS vinculados a una campaña, utilice una campaña que contenga una plantilla de SMS.
| Campo | Tipo | Descripción |
|---|---|---|
| Clave de acceso al servicio | Text | Clave asociada a la cuenta de Siptel, para que Lynn se autentique y use el módulo. |
| Número del remitente del SMS | String | Número desde el cual se envía el mensaje; debe estar autorizado por Siptel, con código de país y sin el signo "+". Puede ser estático o dinámico (desde una entidad del flujo). |
| Contenido del mensaje a enviar | String | Texto del SMS; estático o con variables del flujo vía entidad. Se recomienda validar longitud y legibilidad antes de enviar. |
| Número del destinatario | String | Número de teléfono destino, con código de país y sin el signo "+". Puede ser estático o dinámico. |
| Hora desde la cual se pueden enviar los SMS | Text (HH:MM:SS) |
Hora de inicio del rango permitido para el envío; no se envían mensajes antes de esta hora. |
| Hora límite para el envío | String (HH:MM:SS) |
Hora máxima hasta la cual se permite enviar; los mensajes posteriores se bloquean automáticamente. |
| Permite envío los lunes … domingos | Radio button (x7) | Habilita o deshabilita el envío de SMS para cada día de la semana individualmente. |
| Nombre de la campaña | String | Nombre de la campaña de Siptel a ejecutar, cuando el módulo se configura para enviar SMS como parte de una campaña. |
| RUT para clientes que NO TENGAN IPs designadas | String | Identificador (RUT) asociado a la cuenta, usado cuando no se ha registrado previamente la IP de Lynn como aplicación autorizada. Puede ser estático o dinámico (desde una entidad del flujo). |
| Intención en caso de error | String | Intención que se activa si se alcanza el máximo de intentos fallidos al enviar un SMS; el flujo se interrumpe y la descripción del error se pasa a la intención indicada (ej. SendSMS_SiptelSMS_ErrorError). |
Consideraciones generales
- El número remitente y el número destinatario deben incluir el código de país y omitir el signo "+".
- La intención de error definida debe estar previamente configurada para recibir el contexto del error y manejarlo adecuadamente.
Configuración del canal (requerida para campañas de SMS)
Para enviar SMS como parte de una campaña, el canal Siptel SMS Channel debe estar configurado en el tenant (menú Configurar Canal):
Además de los campos generales de cualquier canal (Ambiente, Channel Id, Proveedor, División, Habilitar canal, Verificación de salud — ej. nivel Básico —, Habilitar la depuración — con tiempo de vigencia, ej. 30 minutos —, No enviar mensajes en blanco y Deshabilitar eventos de escritura), la sección "Configuración asociada a SMS (Requerido)" trae los siguientes campos:
| Campo | Variable | Descripción |
|---|---|---|
| Clave de acceso al servicio | SMS_TOKEN * |
Token de autenticación de la cuenta de Siptel. |
| Número del remitente del SMS | SMS_SENDER * |
Número desde el cual se envían los mensajes de la campaña. |
| Hora desde la cual se pueden enviar los SMS | SMS_START_TIME * |
Hora de inicio del rango permitido para el envío (HH:MM:SS). |
| Hora límite para el envío | SMS_END_TIME * |
Hora máxima hasta la cual se permite enviar (HH:MM:SS). |
| Permite envío los lunes … domingos | SMS_ENABLE_MONDAY … SMS_ENABLE_SUNDAY * |
Radio button Sí/No por cada día de la semana, para habilitar o deshabilitar el envío ese día. |
| Nombre de la campaña | SMS_CAMPAIGN_NAME |
Nombre de la campaña de Siptel a ejecutar. |
| RUT para clientes que NO TENGAN IP's designadas | SMS_RUT |
Identificador (RUT) de la cuenta, para cuando no se ha registrado previamente la IP de Lynn como aplicación autorizada. |
(*) Campo obligatorio.
Estos campos son equivalentes a los de la acción Siptel SMS documentados arriba, pero a nivel de canal en vez de a nivel de acción — ambas configuraciones deben mantenerse consistentes. Tras completar el formulario, el botón Verificar valida los parámetros antes de guardar el canal.
Casos de uso
Ejemplo: intención de error configurada como SendSMS_SiptelSMS_ErrorError — si se alcanza el número máximo de intentos fallidos al enviar un SMS, el flujo se interrumpe y transfiere la descripción del error a esa intención.
Esta página documenta el canal SMS con el detalle completo de la acción Siptel SMS. Para la ficha original del catálogo de Acciones (con metadata de versión y desarrollador), ver Siptel SMS.