Saltearse al contenido
Nappai Documentation

WhatsApp Message

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

Este componente permite enviar mensajes de WhatsApp a través de la API de Twilio, incluyendo texto, imágenes, audio, documentos, videos y combinaciones de medios. También permite consultar el estado de un mensaje enviado.

¿Cómo funciona?

El componente se conecta a la API de Twilio usando las credenciales proporcionadas (Account SID, Auth Token y el número de WhatsApp de Twilio). Cuando seleccionas una operación, el componente construye la solicitud adecuada y la envía a Twilio. Si la operación es de envío, Twilio devuelve un SID y la información del mensaje; si es de consulta de estado, se devuelve el estado actual del mensaje. Los resultados se empaquetan en un objeto Message que puede ser usado en el flujo de trabajo de Nappai.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

  • Send Text Message: Envía un mensaje de texto simple a un número de WhatsApp.
  • Send Image: Envía una o varias imágenes con un pie de foto opcional.
  • Send Audio: Envía archivos de audio con un pie de foto opcional.
  • Send Document: Envía documentos (PDF, DOCX, etc.) con un pie de foto opcional.
  • Send Video: Envía videos con un pie de foto opcional.
  • Send Mixed Media: Envía una combinación de imágenes, audio, documentos y videos en un solo mensaje.
  • Get Message Status: Consulta el estado de un mensaje previamente enviado usando su SID.

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

Entradas

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Input Message: Optional input message to process and extract content from.

    • Visible en: Send Text Message, Send Image, Send Audio, Send Document, Send Video, Send Mixed Media

  • Operation: WhatsApp operation to perform.

    • Visible en: Send Text Message, Send Image, Send Audio, Send Document, Send Video, Send Mixed Media, Get Message Status

  • Twilio Account SID: Your Twilio Account SID for authentication.

    • Visible en: Send Text Message, Send Image, Send Audio, Send Document, Send Video, Send Mixed Media, Get Message Status

  • Twilio Auth Token: Your Twilio Auth Token for authentication.

    • Visible en: Send Text Message, Send Image, Send Audio, Send Document, Send Video, Send Mixed Media, Get Message Status

  • Media Files: Comma-separated list of media file URLs or paths to send (up to 10 files).

    • Visible en: Send Image, Send Audio, Send Document, Send Video, Send Mixed Media

  • Message SID: Twilio message SID to check status for.

    • Visible en: Get Message Status

  • Message Text: The text message to send or caption for media (max 1600 characters).

    • Visible en: Send Text Message, Send Image, Send Audio, Send Document, Send Video, Send Mixed Media

  • Status Callback URL: Optional URL for receiving message status callbacks from Twilio.

    • Visible en: Send Text Message, Send Image, Send Audio, Send Document, Send Video, Send Mixed Media

  • Recipient Phone Number: Recipient’s phone number in international format.

    • Visible en: Send Text Message, Send Image, Send Audio, Send Document, Send Video, Send Mixed Media, Get Message Status

  • Validate Media: Enable media validation for file type and size limits.

    • Visible en: Send Image, Send Audio, Send Document, Send Video, Send Mixed Media

  • Twilio WhatsApp Number: Your Twilio WhatsApp number in E.164 format.

    • Visible en: Send Text Message, Send Image, Send Audio, Send Document, Send Video, Send Mixed Media, Get Message Status

Salidas

  • WhatsApp Message Response: Un objeto Message que contiene la respuesta de Twilio, incluyendo el SID, estado, URLs de medios y otros metadatos. Este objeto puede ser conectado a otros componentes para continuar el flujo de trabajo.

Ejemplo de Uso

Enviar un mensaje de texto

  1. Arrastra el componente WhatsApp Message al lienzo.
  2. Completa los campos obligatorios:
    • Twilio Account SID
    • Twilio Auth Token
    • Twilio WhatsApp Number
    • Recipient Phone Number
  3. Selecciona Operation = Send Text Message.
  4. Escribe el texto en Message Text.
  5. Haz clic en Run.
  6. El resultado aparecerá en la salida WhatsApp Message Response con el SID y el estado.

Enviar una imagen con pie de foto

  1. Selecciona Operation = Send Image.
  2. En Media Files escribe la URL pública de la imagen (por ejemplo, https://example.com/photo.jpg).
  3. En Message Text escribe el pie de foto.
  4. Ejecuta el flujo.
  5. La salida mostrará la URL del medio enviado y el SID del mensaje.

Componentes Relacionados

  • WhatsApp Manager: Clase subyacente que maneja la comunicación con la API de Twilio.
  • Message: Tipo de dato que se utiliza para pasar información entre componentes en Nappai.

Consejos y Mejores Prácticas

  • Mantén tus credenciales seguras: Usa el gestor de secretos de Nappai para almacenar el Account SID y Auth Token.
  • Valida los medios: Activa la opción Validate Media para evitar errores de tamaño o tipo de archivo.
  • Limita el número de medios: La API permite hasta 10 archivos por mensaje; asegúrate de no exceder este límite.
  • Usa URLs públicas: Los archivos deben ser accesibles públicamente o estar alojados en un bucket con permisos adecuados.
  • Monitorea los callbacks: Si necesitas saber cuándo se entrega el mensaje, configura un Status Callback URL y procesa los eventos en tu aplicación.

Consideraciones de Seguridad

  • Credenciales: Nunca expongas el Account SID ni el Auth Token en el código fuente. Utiliza variables de entorno o el sistema de secretos de Nappai.
  • Datos sensibles: Si envías información confidencial en el mensaje, asegúrate de que el canal de WhatsApp esté cifrado (WhatsApp ya ofrece cifrado de extremo a extremo).
  • Validación de medios: Habilita la validación de medios para evitar la carga de archivos potencialmente maliciosos.
  • Control de acceso: Limita quién puede usar este componente en tu dashboard para evitar abusos.