Enviar SMS por correo electrónico

Con la Mail API envía SMS directamente desde su programa de correo o desde cualquier aplicación que pueda enviar correos electrónicos. El requisito es una configuración de Mail API. Cómo crearla se describe en el artículo Configurar la Mail API.

Dirección

Cada configuración tiene una dirección fija, que encontrará en el dashboard en Desarrollador -> Accesos API:

TOKEN@gateway.seven.io
PREFIX.TOKEN@gateway.seven.io

El token lo genera seven y no cambia. El prefijo lo elige libremente en cada correo: todo lo que está antes del último punto de la dirección es el prefijo y se evalúa mediante el patrón del prefijo de dirección.

Si el patrón del prefijo de dirección es {{to}}, un correo a 4917612345678.a1b2c3d4e5f6g7h8@gateway.seven.io va al número de teléfono 4917612345678. En lugar de un número de teléfono también puede indicar un contacto o un grupo de su agenda.

Si en la configuración ha activado la opción Permitir además la dirección sin token, basta con el prefijo solo: 4917612345678@gateway.seven.io.

Destinatario, texto y remitente

En qué parte del correo están el destinatario, el texto del mensaje y el remitente lo define con los patrones de la configuración:

• Destinatario: mediante {{to}} en el prefijo, en el asunto o en el cuerpo. Si ningún patrón captura el destinatario, el SMS va al destinatario fijo de la configuración.
• Texto: con el ajuste por defecto (patrón del cuerpo {{text}}), todo el texto del correo se convierte en el SMS. Con texto literal en el patrón delimita el texto, p. ej. (({{text}})), para que no se envíen las firmas.
• Remitente: mediante {{from}} en un patrón o mediante el remitente del mensaje de la configuración. Si ambos están vacíos, se aplica el remitente predeterminado de su cuenta.

Otras opciones como la hora de envío ({{delay}}), una etiqueta ({{label}}) o un SMS flash ({{flash}}) también se controlan mediante variables en los patrones. Los parámetros de control en el asunto como from= o key= no se evalúan en las configuraciones con dirección fija. Encontrará la lista completa de variables en la documentación de la Mail API.

Un ejemplo: Una herramienta de monitorización envía su aviso en el asunto a a1b2c3d4e5f6g7h8@gateway.seven.io. En la configuración, el patrón del asunto es {{text}}, el patrón del cuerpo está vacío y como destinatario fijo figura su número de guardia. El asunto Carga de CPU crítica en srv-07 se convierte entonces en un SMS con exactamente ese texto al número de guardia.

Dirección del remitente

Envíe siempre desde uno de los remitentes permitidos de la configuración. Los correos de otras direcciones no se procesan. Si la comprobación DMARC está activa para la configuración, su correo debe superarla además. Verá los correos rechazados con el código 904 en el Depurador.

Formato clásico (configuraciones Legacy)

Las configuraciones creadas antes de la introducción de la dirección fija están marcadas en el dashboard con Legacy y siguen funcionando sin cambios. En ellas controla el envío mediante la línea de destinatario y el asunto:

• Destinatario: número de teléfono delante de @gateway.seven.io, p. ej. 01761234567890@gateway.seven.io.
• Asunto: comandos con el formato parámetro=valor, separados por espacios, p. ej. from=Floreria key=123456789. Los valores con espacios se ponen entre comillas: from="Flower Shop". Un to= en el asunto sobrescribe la línea de destinatario; así puede llegar también, por ejemplo, a grupos.
• Texto: el texto del correo. Si lo encierra entre dobles almohadillas (##Este es su texto##), solo se envía la parte intermedia.

Encontrará todos los parámetros del formato clásico en la documentación de la Mail API.