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.
Operaciones
Sección titulada «Operaciones»| Operación | Qué hace | ¿Cuándo se puede usar? |
|---|---|---|
| Enviar plantilla | Envía una plantilla aprobada por Meta (se abre en una pestaña nueva) con sus variables | Siempre. Es lo único que puedes enviar a alguien que no te ha escrito en las últimas 24 horas |
| Enviar texto | Mensaje de texto libre | Solo dentro de la ventana de 24 horas |
| Enviar media | Imagen, video, documento o audio desde una URL pública | Solo dentro de la ventana de 24 horas |
| Enviar interactivo | Mensaje con hasta 3 botones de respuesta o una lista de opciones | Solo dentro de la ventana de 24 horas |
| Asignar conversación | Asigna la conversación a un miembro del equipo | — |
| Cerrar conversación | La marca como resuelta | — |
| Agregar nota interna | Deja una nota para tu equipo en la conversación | — |
| Cambiar estado | La pasa a abierta, en espera o resuelta | — |
Plantilla de respaldo
Sección titulada «Plantilla de respaldo»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.
Enviar media
Sección titulada «Enviar media»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.
| Tipo | Formatos | Peso máximo |
|---|---|---|
| Imagen | JPG, PNG | 5 MB |
| Video | MP4, 3GP | 10 MB |
| Documento | PDF y otros | 100 MB |
| Audio | MP3, OGG, AAC, AMR | 16 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.
A quién se le envía
Sección titulada «A quién se le envía»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.
Enviar plantilla
Sección titulada «Enviar plantilla»- Elige la plantilla. Solo aparecen las aprobadas por Meta; debajo ves cómo le llegará al contacto y en qué cuenta de WhatsApp vive.
- Rellena lo que la plantilla pida. El panel solo muestra los bloques que aplican:
| Bloque | Cuándo aparece | Qué poner |
|---|---|---|
| Variables del encabezado | El encabezado es de texto y tiene variables | Un valor por variable |
| Imagen, video o documento del encabezado | El encabezado lleva un archivo | Nada: 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 cuerpo | El mensaje tiene variables | Un valor por variable |
| Botones con enlace variable | Un botón de enlace tiene una variable | Solo 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.
Enviar desde
Sección titulada «Enviar desde»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.
Si el envío falla
Sección titulada «Si el envío falla»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):
errorCodevaleWA_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.
Operaciones de conversación
Sección titulada «Operaciones de conversación»Asignar, cerrar, agregar nota y cambiar estado actúan sobre una conversación, que el nodo encuentra en este orden:
- El ID de conversación que indiques, o el que traiga un nodo anterior.
- La conversación del disparador, si el flujo arranca desde WhatsApp. No tienes que llenar nada.
- 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).
Salidas
Sección titulada «Salidas»Envíos
| Campo | Tipo | Descripción |
|---|---|---|
sent | Booleano | true si el mensaje salió |
status | Texto | sent, failed o skipped (el contacto pidió no recibir mensajes) |
messageId | Texto | ID del mensaje en WhatsApp |
to | Texto | Teléfono o usuario de WhatsApp al que se envió |
error | Texto | Motivo del fallo, si lo hubo |
errorCode | Texto | Código del fallo, si lo hubo |
conversationId | Texto | Conversación en la que quedó el mensaje |
templateId, conversationCreated, conversationMessageId | — | Solo en Enviar plantilla |
mediaType / interactive | Texto | Solo en Enviar media / Enviar interactivo |
Conversación
| Campo | Tipo | Descripción |
|---|---|---|
success | Booleano | true si la operación se hizo |
conversationId | Texto | Conversación afectada |
assignedTo, status, noteId | Texto | Segú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ó»- Trigger: Evento CRM o Webhook con los datos de la cita.
- WhatsApp → Enviar plantilla:
- Teléfono:
{{trigger.contact.phone}} - Plantilla:
confirmacion_de_cita - Variables del cuerpo:
nombre→{{trigger.contact.name}},fecha→{{trigger.fecha}}
- Teléfono:
- Condición:
{{nodes.whatsapp.sent}}es verdadero.- Rama falsa → notifica a tu equipo con
{{nodes.whatsapp.error}}.
- Rama falsa → notifica a tu equipo con
Solución de problemas
Sección titulada «Solución de problemas»- La plantilla no aparece en el selector: todavía no está aprobada. Revísala en WhatsApp > Plantillas.
sent: falsecon «La ventana de 24 horas de WhatsApp está cerrada»: el contacto no ha escrito en las últimas 24 horas. Usa Enviar plantilla.sent: falsecon «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.
