Saltearse al contenido
Nappai Documentation

WhatsApp Message

WhatsApp Message envía mensajes de WhatsApp desde tu número de Twilio: un texto, una o varias imágenes, audios, documentos o vídeos, o una mezcla de ellos. También consulta en qué estado está un mensaje que ya has enviado.

Cuándo usarlo

  • Confirmar a un cliente su cita o su pedido por WhatsApp.
  • Enviar a un cliente la factura en PDF que ha generado el flujo.
  • Comprobar si un mensaje enviado antes ha llegado o se ha leído.

Configuración

El componente se conecta con los datos de tu cuenta de Twilio, que encuentras en tu panel de Twilio.

CampoQué hace
Twilio Account SID (obligatorio)El identificador de tu cuenta de Twilio.
Twilio Auth Token (obligatorio)La clave de tu cuenta de Twilio.
Twilio WhatsApp Number (obligatorio)Tu número de WhatsApp en Twilio, en formato internacional, por ejemplo +34600000000.
Recipient Phone Number (obligatorio)El teléfono del destinatario en formato internacional.
OperationLo que hace el componente: Send Text Message, Send Image, Send Audio, Send Document, Send Video, Send Mixed Media (varios tipos de archivo en el mismo envío) o Get Message Status. Por defecto: Send Text Message. Según la operación, el panel muestra solo los campos que necesita.

Campos según la operación

CampoCuándo aparece y qué hace
Message TextEn las operaciones de envío. El texto del mensaje o, si envías archivos, el texto que los acompaña. Hasta 1600 caracteres. Es obligatorio en Send Text Message.
Media FilesEn las operaciones de archivos. Las direcciones web de los archivos que se envían, separadas por comas. Hasta 10 archivos por mensaje.
Validate MediaEn las operaciones de archivos. Pensado para comprobar el tipo y el tamaño de los archivos. Por defecto: activado. Ahora mismo los archivos se comprueban siempre antes de enviarse, esté activado o no.
Status Callback URLEn las operaciones de envío. Opcional. Una dirección web a la que Twilio avisa de los cambios de estado del mensaje (enviado, entregado, leído…).
Input MessageEn las operaciones de envío. Opcional. Conecta aquí un mensaje, por ejemplo la respuesta de un agente: su texto se usa cuando Message Text está vacío.
Message SIDEn Get Message Status. El identificador del mensaje que quieres consultar, el que devuelve el componente al enviarlo.

Resultado

WhatsApp Message Response entrega un mensaje que dice si la operación ha ido bien. Al enviar, incluye el destinatario, el número de origen, el texto, los archivos enviados, el estado y el identificador del mensaje en Twilio (message_sid). Al consultar el estado, incluye la información que devuelve Twilio. Si algo falla, el mensaje explica el motivo.

Ejemplo

Una clínica dental confirma las citas por WhatsApp:

  1. El flujo recibe la cita reservada con el nombre, el teléfono y la hora del paciente.
  2. Un agente redacta un mensaje de confirmación breve.
  3. WhatsApp Message, con Operation en Send Text Message, recibe el teléfono en Recipient Phone Number y el mensaje del agente en Input Message, y lo envía al paciente.

Buenas prácticas

  • Escribe siempre los teléfonos en formato internacional, con el prefijo del país.
  • Guarda el message_sid de cada envío si quieres consultar después su estado.
  • Para flujos nuevos, Twilio WhatsApp ofrece más acciones, como el envío de plantillas.

Componentes relacionados