Enviar Mensaje de WhatsApp

📱 Nodo: Enviar Mensaje de WhatsApp¶

Este nodo te permite enviar mensajes de WhatsApp automáticamente desde tus automatizaciones. Utiliza el servicio de Twilio para conectarse con WhatsApp.

🔧 Configuración Inicial: Registro en Twilio¶

Antes de poder usar este nodo, necesitas registrar tu número de WhatsApp en el entorno de producción de Twilio. Tienes dos formas de hacerlo:

Opción 1: Escanear Código QR¶

Abre WhatsApp en tu teléfono móvil.
Escanea el siguiente código QR:

Código QR para registro en Twilio

El código QR te llevará directamente al chat de Twilio con el mensaje "join neighbor-use" ya escrito.
Envía el mensaje y recibirás una confirmación indicando que tu número ha sido registrado exitosamente en el entorno de producción de Twilio.

Opción 2: Enviar Mensaje de Texto¶

Si prefieres no usar el código QR, puedes registrar tu número enviando un mensaje de texto:

Abre WhatsApp en tu teléfono móvil.
Envía el siguiente mensaje al número +14155238886:
```
join neighbor-use
```
Recibirás una confirmación indicando que tu número ha sido registrado exitosamente.

⚙️ Configuración del Nodo¶

Una vez que hayas registrado tu número, puedes configurar el nodo. A continuación te explicamos cada campo del formulario:

Formulario de configuración del nodo WhatsApp

📋 Campos del Formulario¶

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

¿Qué es?
El número de teléfono desde el cual se enviará el mensaje. Este debe ser el número de Twilio que tienes configurado.

¿Qué debo poner?
En el entorno de pruebas (sandbox), usa: +14155238886

Ejemplo:

+14155238886

2. Phone Numbers (Receivers) - Números de Teléfono (Destinatarios) ⚠️¶

¿Qué es?
Los números de teléfono que recibirán el mensaje de WhatsApp. Puedes agregar uno o varios destinatarios.

¿Qué debo poner?

Ingresa el número completo con código de país, incluyendo el signo + al inicio.
Ejemplo: +13313210156 (donde +1 es el código de Estados Unidos y 3313210156 es el número local).
Si necesitas enviar a varios números, haz clic en "+ Add Phone Number" para agregar más destinatarios.
Puedes eliminar un número haciendo clic en el botón de eliminar (🗑️) junto a cada número.

Ejemplo:

+13313123456

Importante: En el entorno de producción de Twilio, solo puedes enviar mensajes a números que hayan sido previamente registrados siguiendo los pasos de la sección "Configuración Inicial" arriba.

3. Message Body - Cuerpo del Mensaje ⚠️¶

¿Qué es?
El texto del mensaje que se enviará por WhatsApp.

¿Qué debo poner?
Escribe el mensaje que quieres enviar. Puede ser cualquier texto, emojis, o incluso variables de tu automatización.

Ejemplo:

Hola, desde automatizacion

Con variables (ejemplo avanzado):

Hola {{nombre}}, tu sensor de temperatura registró {{temperatura}}°C

4. Account ID - ID de Cuenta ⚠️¶

¿Qué es?
El identificador único de tu cuenta de Twilio. Es como un "nombre de usuario" para tu cuenta.

¿Dónde lo encuentro?

Inicia sesión en tu cuenta de Twilio: https://www.twilio.com/console
En el panel principal verás tu Account SID (también llamado Account ID).
Copia este valor y pégalo en este campo.

Ejemplo:

ACfXXXbbcf51123f1eXXX25af164484bXXXXXXX

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 ver o ocultar el texto.

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

¿Qué es?
Una contraseña especial que permite al sistema verificar que eres el dueño de la cuenta de Twilio. Es como una "llave secreta" para acceder a tu cuenta.

¿Dónde lo encuentro?

Inicia sesión en tu cuenta de Twilio: https://www.twilio.com/console
En el panel principal, verás tu Auth Token.
Haz clic en el ícono del ojo 👁️ para revelar el token (está oculto por seguridad).
Copia este valor y pégalo en este campo.

Ejemplo:

f312791bac4515d70dabcaca9885aXX5XX

⚠️ Importante de Seguridad:

Nunca compartas tu Auth Token con nadie.

Si alguien tiene acceso a tu Account ID y Auth Token, puede usar tu cuenta de Twilio.

Este campo está oculto por defecto. Puedes hacer clic en el ícono del ojo 👁️ para ver o ocultar el texto.

6. Latitude - Latitud (Opcional)¶

¿Qué es?
La coordenada de latitud de la ubicación que quieres enviar en el mensaje de WhatsApp.

¿Qué debo poner?

Ingresa un valor numérico que representa la latitud (coordenada norte-sur).
El valor debe estar entre -90 y 90.
Este campo es opcional. Si lo dejas vacío, no se enviará una ubicación.

Ejemplo:

11.054295271183525

Nota: Si quieres enviar una ubicación, debes completar tanto la latitud como la longitud. También puedes agregar una etiqueta (label) para identificar la ubicación.

7. Longitude - Longitud (Opcional)¶

¿Qué es?
La coordenada de longitud de la ubicación que quieres enviar en el mensaje de WhatsApp.

¿Qué debo poner?

Ingresa un valor numérico que representa la longitud (coordenada este-oeste).
El valor debe estar entre -180 y 180.
Este campo es opcional. Si lo dejas vacío, no se enviará una ubicación.

Ejemplo:

-63.827733899456035

Nota: Si quieres enviar una ubicación, debes completar tanto la latitud como la longitud. También puedes agregar una etiqueta (label) para identificar la ubicación.

8. Label - Etiqueta de Ubicación (Opcional)¶

¿Qué es?
Un nombre o etiqueta descriptiva para la ubicación que estás enviando.

¿Qué debo poner?

Ingresa un texto descriptivo que identifique la ubicación (ej. "Oficina Central", "Almacén 1", "Twilio HQ").
Este campo es opcional, pero recomendado si estás enviando una ubicación para que el destinatario sepa qué lugar representa.

Ejemplo:

Point A Warehouse

Nota: Este campo solo tiene sentido si también estás enviando coordenadas de latitud y longitud.

9. Media URLs (Optional) - URLs de Medios (Opcional)¶

¿Qué es?
Enlaces a imágenes, videos o documentos que quieres enviar junto con el mensaje de texto.

¿Qué debo poner?

Ingresa la URL completa (dirección web) de la imagen, video o documento que quieres enviar.
La URL debe ser accesible públicamente en internet (no puede ser un archivo local de tu computadora).
Si quieres enviar varios archivos, separa las URLs con comas.

Ejemplo de una imagen:

https://images.ctfassets.net/ihx0a8chifpc/gPyHKDGI0md4NkRDjs4k8/36be1e73008a0181c1980f727f29d002/avatar-placeholder-generator-500x500.jpg

Ejemplo de múltiples archivos:

https://ejemplo.com/imagen1.jpg, https://ejemplo.com/video1.mp4, https://ejemplo.com/documento.pdf

Nota: Este campo es opcional. Si no quieres enviar ningún archivo adjunto, puedes dejarlo vacío.

✅ Resumen de Campos Requeridos¶

Los campos marcados con ⚠️ son obligatorios y deben completarse para que el nodo funcione:

✅ Phone Number (Sender) - Número remitente
✅ Phone Numbers (Receivers) - Números destinatarios
✅ Message Body - Texto del mensaje
✅ Account ID - ID de tu cuenta Twilio
✅ Auth Token - Token de autenticación de Twilio
⭕ Latitude - Latitud (opcional, para enviar ubicación)
⭕ Longitude - Longitud (opcional, para enviar ubicación)
⭕ Label - Etiqueta de ubicación (opcional, recomendado si envías ubicación)
⭕ Media URLs - Archivos adjuntos (opcional)

🎯 Ejemplo Completo de Configuración¶

Aquí tienes un ejemplo de cómo quedaría el nodo configurado:

Phone Number (Sender): +14155238886
Phone Numbers (Receivers): +123445435
Message Body: Test message from automation backend, HI
Account ID: xxxxxxxxxx
Auth Token: xxxxxxxxxxxx
Latitude: 11.054295271183525
Longitude: -63.827733899456035
Label: Twilio HQ

🔍 Solución de Problemas¶

El mensaje no se envía¶

Verifica que tu número esté registrado en el sandbox:
Asegúrate de haber completado el paso de registro (QR o mensaje de texto).
Verifica que el número destinatario esté registrado:
En el entorno de producción, solo puedes enviar mensajes a números que también estén registrados.
Revisa tus credenciales:
Confirma que el Account ID y Auth Token sean correctos.
Puedes verificar estos valores en tu consola de Twilio.
Verifica el formato de los números:
Todos los números deben incluir el código de país con el signo + al inicio.
Ejemplo correcto: +13313123456
Ejemplo incorrecto: 3313123456 (falta el +1)

No encuentro mi Account ID o Auth Token¶

Ve a https://www.twilio.com/console
Inicia sesión en tu cuenta
En el panel principal verás ambos valores
Para ver el Auth Token, haz clic en el ícono del ojo 👁️

📚 Información Adicional¶

Sandbox de Twilio: El entorno de pruebas permite enviar mensajes solo a números registrados. Para enviar a cualquier número, necesitarás una cuenta de Twilio aprobada para producción.
Límites: El sandbox tiene límites en la cantidad de mensajes que puedes enviar. Consulta la documentación de Twilio para más detalles.
Soporte: Si tienes problemas con tu cuenta de Twilio, contacta al soporte de Twilio directamente.