Ir al contenido

Nodos de acción

Nodo WhatsApp

El nodo WhatsApp envía mensajes por los números de WhatsApp conectados a tu espacio de trabajo y gestiona la conversación del contacto. Necesita al menos un número de WhatsApp conectado (se abre en una pestaña nueva); no usa credenciales aparte.

OperaciónQué hace¿Cuándo se puede usar?
Enviar plantillaEnvía una plantilla aprobada por Meta (se abre en una pestaña nueva) con sus variablesSiempre. Es lo único que puedes enviar a alguien que no te ha escrito en las últimas 24 horas
Enviar textoMensaje de texto libreSolo dentro de la ventana de 24 horas
Enviar mediaImagen, video, documento o audio desde una URL públicaSolo dentro de la ventana de 24 horas
Enviar interactivoMensaje con hasta 3 botones de respuesta o una lista de opcionesSolo dentro de la ventana de 24 horas
Asignar conversaciónAsigna la conversación a un miembro del equipo—
Cerrar conversaciónLa marca como resuelta—
Agregar nota internaDeja una nota para tu equipo en la conversación—
Cambiar estadoLa pasa a abierta, en espera o resuelta—

En Enviar texto, Enviar media y Enviar interactivo puedes elegir, en la sección Si pasaron más de 24 horas, una plantilla aprobada con sus variables. Si la ventana está abierta sale tu mensaje; si está cerrada, sale la plantilla (y la salida trae fallbackTemplateUsed: true). No consume créditos de Waiify; Meta cobra las plantillas directamente a tu cuenta de WhatsApp.

Úsala siempre que el flujo arranque por algo distinto de un mensaje del contacto: un evento del CRM, un webhook, una hora programada, el final de una llamada o un seguimiento. En esos casos el contacto casi nunca escribió en las últimas 24 horas, y el panel del nodo te lo advierte en ámbar si falta el respaldo.

Respetar el horario de contacto (apagado por defecto) evita enviar fuera del horario configurado para el workspace; el envío devuelve errorCode: outside_contact_hours.

Indica el tipo y la URL pública del archivo. La imagen, el video y el documento admiten una descripción; el documento, además, el nombre con el que le llega al contacto.

TipoFormatosPeso máximo
ImagenJPG, PNG5 MB
VideoMP4, 3GP10 MB
DocumentoPDF y otros100 MB
AudioMP3, OGG, AAC, AMR16 MB

El video sigue la misma regla que el del encabezado de una plantilla. El nodo lo comprueba antes de enviar: si el archivo no es MP4 o 3GP, o pesa más de 10 MB, no lo envía y devuelve el motivo en error. En la bandeja (se abre en una pestaña nueva) el video queda con su reproductor.

El campo Teléfono lleva solo dígitos, empezando por el código de país (573001112233), sin +, espacios ni guiones. Lo normal es usar una variable del flujo, como {{trigger.phone}}.

  • Contactos sin teléfono. WhatsApp permite escribir con un nombre de usuario sin compartir el número. Si el flujo arranca desde WhatsApp y quien escribió es uno de esos contactos, deja el teléfono del disparador en el campo: el nodo le responde igual, por su usuario de WhatsApp.
  • Contactos que pidieron no recibir mensajes. Si el contacto respondió BAJA, el nodo no le envía nada y devuelve status: skipped. La excepción es cuando ese mismo contacto disparó el flujo escribiendo: ahí sí se le responde.
  1. Elige la plantilla. Solo aparecen las aprobadas por Meta; debajo ves cómo le llegará al contacto y en qué cuenta de WhatsApp vive.
  2. Rellena lo que la plantilla pida. El panel solo muestra los bloques que aplican:
BloqueCuándo apareceQué poner
Variables del encabezadoEl encabezado es de texto y tiene variablesUn valor por variable
Imagen, video o documento del encabezadoEl encabezado lleva un archivoNada: sale el archivo que la plantilla tiene guardado. Indica una URL pública solo si en este flujo quieres enviar otro. Es obligatorio únicamente en plantillas importadas de Meta, que no traen su archivo
Variables del cuerpoEl mensaje tiene variablesUn valor por variable
Botones con enlace variableUn botón de enlace tiene una variableSolo el valor que reemplaza a la variable, no la URL completa

Cada valor puede ser un texto fijo o una variable del flujo. Si al ejecutarse una variable queda vacía, la plantilla no se envía y el nodo devuelve el motivo: WhatsApp rechazaría el mensaje entero.

El envío queda en la bandeja (se abre en una pestaña nueva), en la conversación del contacto. Si es la primera vez que le escribes, el nodo crea el contacto y la conversación.

Si tienes más de un número conectado, aparece el campo Enviar desde. Si lo dejas en automático, el mensaje sale por el número de la conversación. El envío queda en el chat del contacto en ese número: si el contacto aún no tiene chat en él, se crea uno, porque en su teléfono cada número es un chat aparte.

Una plantilla solo puede salir por un número de su misma cuenta de WhatsApp Business: en esa operación el selector lista únicamente los números de la cuenta de la plantilla, y en automático el nodo elige uno de ellos.

Por defecto el flujo continúa aunque el mensaje no salga, y decides qué hacer con la salida sent (por ejemplo, con un nodo Condición (se abre en una pestaña nueva)). Marca Detener el flujo si el envío falla si prefieres que el nodo corte la ejecución.

Un envío puede no salir porque:

  • La ventana de 24 horas está cerrada (texto, media e interactivo).
  • El contacto pidió no recibir mensajes (contact_opted_out) o está bloqueado (contact_blocked). A un contacto bloqueado no se le envía nada nunca.
  • Tu cuenta llegó a su límite de mensajería (se abre en una pestaña nueva): errorCode vale WA_MESSAGING_LIMIT.
  • La plantilla dejó de estar aprobada, o su cuenta ya no tiene un número conectado.
  • WhatsApp rechazó el mensaje. El motivo llega en error.

El paso queda en ámbar en el historial de ejecución con el motivo, y un asistente que ejecutó el flujo como acción nunca le confirma al cliente un envío que no salió. Si WhatsApp rechaza el mensaje después de aceptarlo, la bandeja muestra el motivo y quien creó el flujo recibe una notificación (como máximo una por hora por flujo).

Los mensajes que el flujo envía a otro número (por ejemplo, avisar a un vendedor) quedan en la conversación de ese número, no en la del cliente que disparó el flujo.

Asignar, cerrar, agregar nota y cambiar estado actúan sobre una conversación, que el nodo encuentra en este orden:

  1. El ID de conversación que indiques, o el que traiga un nodo anterior.
  2. La conversación del disparador, si el flujo arranca desde WhatsApp. No tienes que llenar nada.
  3. La última conversación de WhatsApp del teléfono que indiques.

En un flujo manual o programado no hay disparador de WhatsApp: indica el ID o el teléfono, o el nodo fallará.

  • Cerrar conversación (y cambiar el estado a resuelta) devuelve la conversación al asistente: si el contacto vuelve a escribir, el asistente lo atiende.
  • Agregar nota interna solo la ve tu equipo en la bandeja. No se le envía al contacto.
  • Para repartir una conversación entre varios miembros según su carga, usa el nodo Asignar a un humano (se abre en una pestaña nueva).

Envíos

CampoTipoDescripción
sentBooleanotrue si el mensaje salió
statusTextosent, failed o skipped (el contacto pidió no recibir mensajes)
messageIdTextoID del mensaje en WhatsApp
toTextoTeléfono o usuario de WhatsApp al que se envió
errorTextoMotivo del fallo, si lo hubo
errorCodeTextoCódigo del fallo, si lo hubo
conversationIdTextoConversación en la que quedó el mensaje
templateId, conversationCreated, conversationMessageId—Solo en Enviar plantilla
mediaType / interactiveTextoSolo en Enviar media / Enviar interactivo

Conversación

CampoTipoDescripción
successBooleanotrue si la operación se hizo
conversationIdTextoConversación afectada
assignedTo, status, noteIdTextoSegún la operación

Este nodo no consume créditos de Waiify, en ninguna de sus operaciones. Meta te cobra directamente las plantillas que envías, según su categoría y el país del destinatario.

Ejemplo: confirmar una cita y avisar si no salió

Sección titulada «Ejemplo: confirmar una cita y avisar si no salió»
  1. Trigger: Evento CRM o Webhook con los datos de la cita.
  2. WhatsApp → Enviar plantilla:
    • Teléfono: {{trigger.contact.phone}}
    • Plantilla: confirmacion_de_cita
    • Variables del cuerpo: nombre → {{trigger.contact.name}}, fecha → {{trigger.fecha}}
  3. Condición: {{nodes.whatsapp.sent}} es verdadero.
    • Rama falsa → notifica a tu equipo con {{nodes.whatsapp.error}}.
  • La plantilla no aparece en el selector: todavía no está aprobada. Revísala en WhatsApp > Plantillas.
  • sent: false con «La ventana de 24 horas de WhatsApp está cerrada»: el contacto no ha escrito en las últimas 24 horas. Usa Enviar plantilla.
  • sent: false con «Falta el valor de…»: una variable de la plantilla quedó vacía al ejecutarse. Revisa de dónde sale ese dato.
  • errorCode: WA_MESSAGING_LIMIT: tu cuenta ya les escribió primero a todos los contactos que WhatsApp le permite en 24 horas. Ver límite de mensajería (se abre en una pestaña nueva).
  • El número de «Enviar desde» sale como no disponible: se desconectó, está en pausa o es de otra cuenta que la plantilla. Elige otro.
  • El nodo queda marcado incompleto: falta el teléfono, la plantilla o el valor de alguna de sus variables.