WhatsApp (Twilio)

Descripcion

El modulo WhatsApp - Twilio permite enviar mensajes de WhatsApp utilizando la API de Twilio. Soporta envio de mensajes de texto y mensajes con contenido multimedia (imagenes, documentos, etc.) mediante URL de media. El mensaje se puede personalizar con variables dinamicas del workflow. Es ideal para notificaciones a clientes, confirmaciones de pedido, alertas y cualquier comunicacion automatizada via WhatsApp.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credenciales de Twilio
phoneNumber	text	Si	Numero de telefono destino
message	textarea	Si	Mensaje a enviar (soporta variables {{variable}})

Credenciales

La credencial debe contener los campos (configurados en la instancia del modulo):

• accountSid: SID de la cuenta de Twilio
• authToken: Token de autenticacion de Twilio
• from: Numero de WhatsApp de origen (registrado en Twilio, formato: +1234567890)

Para configurar las credenciales, se necesita una cuenta de Twilio con WhatsApp Business habilitado. El numero de origen debe estar aprobado en la sandbox o en produccion de Twilio.

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "messageId": "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "cred_twilio_01",
  "phoneNumber": "+34612345678",
  "message": "Hola {{nombreCliente}}, tu pedido {{orderId}} ha sido enviado."
}

API Utilizada

• Twilio Messages API: Envio de mensajes via client.messages.create()
• Documentacion: https://www.twilio.com/docs/whatsapp/api

Notas

• Soporta variables dinamicas {{variable}} en el campo de mensaje
• Si data.mediaUrl esta presente, se envia un mensaje multimedia con la URL del archivo
• El numero de destino se prefija automaticamente con whatsapp: para la API de Twilio
• El numero de origen se toma de config.from y tambien se prefija con whatsapp:
• El messageId retornado es el SID del mensaje en Twilio, util para tracking
• Requiere una cuenta de Twilio activa con WhatsApp habilitado

Nodos Relacionados

• telegram (mensajeria via Telegram)
• slack (mensajeria via Slack)