Enviar Mensaje SMS

📱 Nodo: Enviar Mensaje SMS¶

Este nodo te permite enviar mensajes de texto SMS automáticamente desde tus automatizaciones. Utiliza el servicio de Twilio para entregar mensajes a cualquier número de teléfono móvil en todo el mundo.

🔧 Configuración Inicial: Crear una Cuenta en Twilio¶

Antes de poder usar este nodo, necesitas crear una cuenta en Twilio y obtener tus credenciales (Account ID y Auth Token). Sigue estos pasos:

Paso 1: Registrarse en Twilio¶

Ve al sitio web de Twilio: https://www.twilio.com/try-twilio
Haz clic en "Sign up" o "Start for free" (Registrarse o Comenzar gratis).
Completa el formulario de registro con tu información:
Dirección de correo electrónico
Contraseña
Nombre y apellido
Verifica tu dirección de correo electrónico haciendo clic en el enlace que te enviarán a tu bandeja de entrada.

Paso 2: Completar la Configuración de la Cuenta¶

Después de verificar tu correo, Twilio te pedirá que verifiques tu número de teléfono.
Ingresa tu número de teléfono y verifica con el código que te enviarán por SMS.
Responde algunas preguntas sobre para qué planeas usar Twilio (puedes seleccionar "Alerts & Notifications" y "Other" / "Alertas y Notificaciones" y "Otro").

Paso 3: Obtener un Número de Teléfono de Twilio¶

Después de completar la configuración, Twilio te asignará un número de teléfono de prueba.
Este número se usará como el número emisor para tus mensajes SMS.
Toma nota de este número (formato de ejemplo: +12294593674).

Nota: Con una cuenta de prueba, solo puedes enviar mensajes a números de teléfono que hayas verificado en Twilio. Para enviar a cualquier número, necesitarás actualizar a una cuenta de pago.

Paso 4: Encontrar tus Credenciales de Cuenta¶

Inicia sesión en tu Consola de Twilio: https://www.twilio.com/console
En el panel principal, verás la sección Account Info (Información de Cuenta) con:
Account SID (este es tu Account ID / ID de Cuenta)
Auth Token (Token de Autenticación) (haz clic en el ícono del ojo 👁️ para revelarlo)
Copia ambos valores - los necesitarás para configurar el nodo.

Ejemplo de lo que verás: - Account SID: AC1234567890abcdef1234567890abcdef - Auth Token: 1234567890abcdef1234567890abcdef

⚠️ Seguridad: Nunca compartas tu Auth Token con nadie. Es como una contraseña para tu cuenta de Twilio.

⚙️ Configuración del Nodo¶

Una vez que tengas tu cuenta de Twilio configurada, puedes configurar el nodo SMS. A continuación, explicamos cada campo del formulario:

Formulario de configuración del nodo SMS

📋 Campos del Formulario¶

El nodo tiene cinco campos principales que debes completar:

1. Phone Number (Sender) / Número de Teléfono (Emisor) ⚠️¶

¿Qué es?
El número de teléfono desde el cual se enviará el SMS. Este debe ser tu número de teléfono de Twilio.

¿Qué debo ingresar?
El número de teléfono que Twilio te asignó cuando creaste tu cuenta.

Formato:
- Debe incluir el código de país con el signo + al principio. - Ejemplo: +12294593674 (donde +1 es el código de país de EE.UU. y 2294593674 es el número de teléfono)

¿Dónde lo encuentro? 1. Inicia sesión en la Consola de Twilio: https://www.twilio.com/console 2. Haz clic en "Phone Numbers" (Números de Teléfono) en el menú izquierdo. 3. Haz clic en "Manage" (Administrar) → "Active numbers" (Números activos). 4. Verás tu número de teléfono de Twilio listado allí.

Ejemplo:

+12294593674

Nota: No puedes usar cualquier otro número aquí. Debe ser un número que hayas comprado o que te hayan asignado a través de Twilio.

2. Phone Number (Receiver) / Número de Teléfono (Receptor) ⚠️¶

¿Qué es?
El número de teléfono que recibirá el mensaje SMS. Este es el número de teléfono de tu destinatario.

¿Qué debo ingresar?
El número de teléfono completo de la persona o dispositivo al que quieres enviar el mensaje.

Formato:
- Debe incluir el código de país con el signo + al principio. - Ejemplo: +5804123590206 (donde +58 es el código de país de Venezuela y 04123590206 es el número local)

Ejemplos para diferentes países:

+13135551234  (EE.UU.)
+5215512345678  (México)
+5804123590206  (Venezuela)
+34612345678  (España)

⚠️ Importante - Limitación de Cuenta de Prueba:

Si estás usando una cuenta de prueba, solo puedes enviar SMS a números de teléfono que hayas verificado en Twilio.

Para verificar un número, ve a: Consola de Twilio → "Phone Numbers" → "Manage" → "Verified Caller IDs" (Números de Teléfono → Administrar → IDs de Llamante Verificados).

Para enviar a cualquier número sin verificación, necesitarás actualizar a una cuenta de pago de Twilio.

3. SMS Body / Cuerpo del SMS ⚠️¶

¿Qué es?
El contenido de texto del mensaje SMS que se enviará.

¿Qué debo ingresar?
El mensaje que quieres enviar. Puede ser cualquier texto de hasta 160 caracteres (longitud estándar de SMS).

Formato:
Cadena de texto plano.

Ejemplo:

Alerta: Movimiento detectado en la entrada principal a las 14:30

Con variables (avanzado):

Hola {{userName}}, tu código de acceso es {{accessCode}}

Nota: - Los mensajes SMS estándar tienen un límite de 160 caracteres. - Si tu mensaje es más largo, se dividirá en múltiples mensajes SMS (y se cobrará en consecuencia). - Los caracteres especiales (emojis, acentos) pueden reducir el límite de caracteres.

4. Account ID / ID de Cuenta ⚠️¶

¿Qué es?
Tu Twilio Account SID (Identificador de Seguridad). Este es un identificador único para tu cuenta de Twilio.

¿Dónde lo encuentro?

Inicia sesión en la Consola de Twilio: https://www.twilio.com/console
En el panel principal, busca la sección "Account Info" (Información de Cuenta).
Verás "Account SID" - este es tu Account ID.
Copia toda la cadena (comienza con "AC").

Formato:
Una cadena que comienza con "AC" seguida de 32 caracteres (letras y números).

Ejemplo:

AC1234567890abcdef1234567890abcdef

Seguridad: Este campo está oculto por defecto (se muestra como puntos •••) para proteger tu información. Puedes hacer clic en el ícono del ojo 👁️ para mostrar u ocultar el texto.

5. Auth Token / Token de Autenticación ⚠️¶

¿Qué es?
Tu token de autenticación de Twilio. Esta es una contraseña secreta que demuestra que eres el propietario de la cuenta de Twilio y autoriza al sistema a enviar SMS en tu nombre.

¿Dónde lo encuentro?

Inicia sesión en la Consola de Twilio: https://www.twilio.com/console
En el panel principal, busca la sección "Account Info" (Información de Cuenta).
Verás "Auth Token" (está oculto por defecto).
Haz clic en el ícono del ojo 👁️ junto a "Auth Token" para revelarlo.
Copia todo el token.

Formato:
Una cadena de 32 caracteres de letras y números.

Ejemplo:

1234567890abcdef1234567890abcdef

⚠️ Advertencia Crítica de Seguridad:

Nunca compartas tu Auth Token con nadie.

Cualquier persona con tu Account ID y Auth Token puede enviar mensajes SMS usando tu cuenta de Twilio (y cobrártelo a ti).

Si sospechas que tu token ha sido comprometido, puedes regenerarlo en la Consola de Twilio.

Este campo está oculto por defecto para tu protección. Haz clic en el ícono del ojo 👁️ para mostrarlo u ocultarlo.

✅ Resumen de Campos Requeridos¶

Todos los campos son obligatorios y deben completarse para que el nodo funcione:

✅ Phone Number (Sender) - Tu número de teléfono de Twilio
✅ Phone Number (Receiver) - Número de teléfono del destinatario
✅ SMS Body - El texto del mensaje
✅ Account ID - Tu Twilio Account SID
✅ Auth Token - Tu token de autenticación de Twilio

🎯 Ejemplo de Configuración Completa¶

Aquí hay un ejemplo de cómo se configuraría el nodo:

Vista del Formulario:

Phone Number (Sender): +12294593674
Phone Number (Receiver): +5804123590206
SMS Body: Alerta: Movimiento detectado en la entrada principal
Account ID: AC1234567890abcdef1234567890abcdef
Auth Token: 1234567890abcdef1234567890abcdef

Estructura JSON (backend):

{
  "accountId": "AC1234567890abcdef1234567890abcdef",
  "authToken": "1234567890abcdef1234567890abcdef",
  "body": "Alerta: Movimiento detectado en la entrada principal",
  "from": "+12294593674",
  "to": "+5804123590206"
}

🔍 Solución de Problemas¶

El mensaje no se está enviando¶

Verifica tus credenciales:
Asegúrate de que tu Account ID y Auth Token sean correctos.
Puedes verificarlos en tu Consola de Twilio.
Asegúrate de haber copiado las cadenas completas sin espacios extra.
Verifica el estado de tu cuenta de Twilio:
Inicia sesión en la Consola de Twilio y verifica que tu cuenta esté activa.
Si estás usando una cuenta de prueba, verifica que tengas crédito de prueba disponible.
Verifica el formato del número de teléfono:
Todos los números de teléfono deben incluir el signo + y el código de país.
Correcto: +12294593674
Incorrecto: 12294593674 o 2294593674
Verifica el número emisor:
El número emisor debe ser un número válido de Twilio asignado a tu cuenta.
No puedes usar cualquier número de teléfono aleatorio como emisor.

Error: "The number is unverified" / "El número no está verificado" (Cuenta de prueba)¶

Causa: Estás intentando enviar a un número de teléfono que no ha sido verificado en tu cuenta de prueba.

Solución:

Inicia sesión en la Consola de Twilio: https://www.twilio.com/console
Ve a "Phone Numbers" → "Manage" → "Verified Caller IDs".
Haz clic en "Add a new Caller ID" (Agregar un nuevo ID de Llamante).
Ingresa el número de teléfono al que quieres enviar SMS.
Twilio te llamará o enviará un SMS con un código de verificación.
Ingresa el código para verificar el número.

Alternativa: Actualiza a una cuenta de pago de Twilio para enviar a cualquier número sin verificación.

Error: "Authenticate" o "Invalid credentials" / "Autenticar" o "Credenciales inválidas"¶

Causa: El Account ID o el Auth Token son incorrectos.

Solución:

Inicia sesión en la Consola de Twilio: https://www.twilio.com/console
Verifica tu Account SID y Auth Token.
Asegúrate de estar copiando las cadenas completas.
Intenta revelar el Auth Token (haz clic en el ícono del ojo 👁️) y copiarlo nuevamente.
Si el problema persiste, puedes regenerar tu Auth Token (nota: esto invalidará el anterior).

Error: "Insufficient funds" o "Insufficient credit" / "Fondos insuficientes" o "Crédito insuficiente"¶

Causa: Tu cuenta de Twilio no tiene suficiente crédito para enviar el SMS.

Solución:

Para cuentas de prueba: Recibes crédito gratuito limitado. Si lo has usado todo, necesitarás actualizar a una cuenta de pago.
Para cuentas de pago: Agrega más fondos a tu cuenta de Twilio a través de la sección de facturación.

El mensaje se envía pero no se recibe¶

Verifica el número de teléfono del destinatario:
Verifica que el número de teléfono sea correcto.
Asegúrate de que incluya el código de país correcto.
Verifica el teléfono del destinatario:
Asegúrate de que el teléfono esté encendido y tenga señal.
Verifica si el teléfono tiene el bloqueo de SMS habilitado.
Algunos operadores pueden bloquear mensajes SMS automatizados.
Verifica los registros de Twilio:
Ve a Consola de Twilio → "Monitor" → "Logs" → "Messaging" (Monitor → Registros → Mensajería).
Busca tu mensaje enviado y verifica su estado de entrega.
Twilio te mostrará si el mensaje fue entregado, falló o está pendiente.

💰 Información de Precios de Twilio¶

Cuenta de Prueba¶

Crédito gratuito: Twilio te da una pequeña cantidad de crédito gratuito cuando te registras.
Limitaciones:
Solo puedes enviar a números de teléfono verificados.
Los mensajes incluyen el prefijo "Sent from your Twilio trial account" (Enviado desde tu cuenta de prueba de Twilio).
Bueno para: Pruebas y desarrollo.

Cuenta de Pago¶

Sin restricciones: Envía a cualquier número de teléfono en todo el mundo.
Pago por uso: Solo pagas por los mensajes SMS que envías.
Los precios varían por país:
EE.UU./Canadá: ~$0.0075 por SMS
América Latina: ~$0.04-$0.08 por SMS
Europa: ~$0.05-$0.10 por SMS
(Los precios varían; consulta la página oficial de precios de Twilio)

Consejo: Puedes configurar alertas de facturación en Twilio para evitar cargos inesperados.

📚 Información Adicional¶

Países Soportados¶

Twilio admite el envío de SMS a más de 180 países. Puedes verificar si un país específico está soportado en la documentación de Twilio.

Longitud del Mensaje¶

SMS estándar: 160 caracteres (para alfabeto latino básico).
SMS Unicode: 70 caracteres (si usas caracteres especiales, emojis o alfabetos no latinos).
Mensajes largos: Se dividen automáticamente en múltiples partes de SMS (cada parte se cobra por separado).

Informes de Entrega¶

Twilio proporciona informes de entrega detallados. Puedes verificar si tu mensaje fue: - Delivered (Entregado): Recibido con éxito por el destinatario. - Failed (Fallido): No pudo ser entregado (número incorrecto, teléfono apagado, etc.). - Pending (Pendiente): Aún se está procesando.

Accede a los informes de entrega en: Consola de Twilio → "Monitor" → "Logs" → "Messaging".

Mejores Prácticas¶

Prueba primero: Siempre prueba con números verificados antes de pasar a producción.
Monitorea el uso: Mantén un seguimiento de tu uso de SMS para evitar costos inesperados.
Formatea los números correctamente: Siempre usa el formato internacional con código de país.
Mantén los mensajes concisos: Los mensajes más cortos son más efectivos y económicos.
Respeta las regulaciones: Sigue las regulaciones locales con respecto a SMS automatizados (requisitos de opt-in, restricciones de tiempo, etc.).

🔒 Mejores Prácticas de Seguridad¶

Protege tus credenciales:
Nunca confirmes tu Account ID y Auth Token en el control de versiones (Git).
Guárdalos de forma segura en variables de entorno o archivos de configuración encriptados.
Rota los tokens regularmente:
Considera regenerar tu Auth Token periódicamente por seguridad.
Monitorea tu cuenta:
Revisa regularmente tus registros de Twilio para detectar cualquier actividad sospechosa.
Configura alertas de facturación para detectar uso no autorizado.
Limita el acceso:
Solo comparte tus credenciales de Twilio con miembros de confianza del equipo.
Considera usar las API Keys de Twilio para un mejor control de acceso.

🆘 Obtener Ayuda¶

Si necesitas más ayuda:

Documentación de Twilio: https://www.twilio.com/docs/sms
Soporte de Twilio: Disponible a través de tu Consola de Twilio (las cuentas de pago obtienen soporte prioritario)
Comunidad de Twilio: https://support.twilio.com/hc/en-us/community/topics