Nodos de integración
Nodo Waiify
El nodo Waiify envía SMS y gestiona códigos de un solo uso (OTP) usando la infraestructura propia de la plataforma.
Diferencia con el nodo Twilio
Sección titulada «Diferencia con el nodo Twilio»Ambos nodos ofrecen las mismas tres operaciones (enviar SMS, enviar OTP, verificar OTP), pero el modelo es distinto:
- Twilio (se abre en una pestaña nueva) admite BYOK (conectas tu propia cuenta de Twilio con su credencial (se abre en una pestaña nueva)) o el modo gestionado por Waiify.
- Waiify solo existe en modo gestionado: no hay
credentialIdni selector de credencial en el panel — no hay nada que conectar. Siempre consume créditos del workspace.
Usa Twilio con tu propia cuenta si ya tienes un número o un Verify Service configurado y quieres controlar el proveedor y su facturación directamente. Usa Waiify si prefieres no gestionar ninguna cuenta externa y que el envío salga con la infraestructura ya lista de la plataforma.
Operaciones
Sección titulada «Operaciones»Enviar SMS
Sección titulada «Enviar SMS»Envía un mensaje SMS a un número de teléfono.
| Campo | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
Número de destino (to) | Texto / variable | Sí | — | Teléfono al que se envía el SMS. |
Mensaje (message) | Texto largo / variable | Sí | — | Contenido del SMS. Cada 160 caracteres cuenta como un segmento (un SMS); tildes y emojis bajan ese límite a 70 caracteres por segmento, y cada segmento adicional se cobra aparte. |
Salidas:
| Campo | Tipo | Descripción |
|---|---|---|
to | Texto | Número de destino normalizado, con el prefijo del país y sin el + |
country | Texto | País del destino en formato ISO (MX, CO). null si el prefijo no permite determinarlo |
segments | Número | Segmentos en que se dividió el mensaje. Cada uno se cobra como un SMS |
credits | Número | Créditos consumidos por el envío |
messageId | Texto | Identificador del envío en el proveedor |
delivery | Texto | Siempre accepted: el proveedor aceptó el mensaje, pero la entrega aún no está confirmada |
note | Texto | Aviso corto que acompaña a delivery |
Enviar código OTP
Sección titulada «Enviar código OTP»Genera un código de un solo uso y lo envía por SMS. El código se guarda cifrado y vence solo.
| Campo | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
Número de destino (to) | Texto / variable | Sí | — | Teléfono al que se envía el código. |
Mensaje del código (template) | Texto largo / variable | No | Mensaje por defecto del sistema | Si lo escribes, debe incluir el marcador {{code}}; también puedes usar {{minutes}}. Estos dos marcadores se resuelven en el servicio de OTP, no como variables normales del flujo — se dejan intactos aunque el resto del texto sí sustituya {{...}} del flujo. |
Salidas:
| Campo | Tipo | Descripción |
|---|---|---|
to | Texto | Número al que se envió el código |
expiresAt | Texto | Fecha y hora en que vence el código |
resendAvailableInSeconds | Número | Segundos que hay que esperar para poder reenviarlo |
Verificar código OTP
Sección titulada «Verificar código OTP»Comprueba el código que ingresó el usuario contra el que se envió.
| Campo | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
Número de teléfono (to) | Texto / variable | Sí | — | Debe ser el mismo número al que se envió el OTP. |
Código ingresado por el usuario (otpCode) | Texto / variable | Sí | — | Típicamente {{trigger.code}} u otra variable con lo que escribió el usuario. |
Salidas:
| Campo | Tipo | Descripción |
|---|---|---|
valid | Booleano | true si el código es correcto y no ha vencido |
reason | Texto | Motivo cuando no es válido: not_found, expired, too_many_attempts o mismatch |
attemptsLeft | Número | Intentos que le quedan al código antes de quedar inutilizado |
Un código incorrecto no detiene el flujo: es el resultado normal de la operación. Ramifica con un nodo Condición (se abre en una pestaña nueva) sobre {{nodes.waiify.valid}}.
Ejemplo — verificar un teléfono
Sección titulada «Ejemplo — verificar un teléfono»- Enviar código OTP a
{{trigger.phone}}. - (El usuario ingresa el código en tu formulario o canal.)
- Verificar código OTP con
{{trigger.code}}→ revisa{{nodes.waiify.valid}}. - Condición (se abre en una pestaña nueva): si
valides verdadero, continúa; si no, muestra{{nodes.waiify.reason}}al usuario.
Problemas comunes
Sección titulada «Problemas comunes»- “Waiify: el campo… es requerido” — falta
to/message(SMS),to(OTP) uotpCode(verificación); revisa que la variable que alimenta el campo no llegue vacía. - El SMS sale más caro de lo esperado — revisa
segmentsen la salida: tildes, emojis o un mensaje largo dividen el envío en varios segmentos, y cada uno se cobra por separado. reason: expired— el código venció antes de que el usuario lo ingresara. Genera uno nuevo con Enviar código OTP.reason: too_many_attempts— se agotaron los intentos permitidos (verattemptsLeften los envíos previos). Hay que generar un código nuevo.
Relacionado
Sección titulada «Relacionado»- Nodo Twilio (se abre en una pestaña nueva) — misma funcionalidad, con opción BYOK
- Créditos (se abre en una pestaña nueva)
