Ir al contenido

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.

Ambos nodos ofrecen las mismas tres operaciones (enviar SMS, enviar OTP, verificar OTP), pero el modelo es distinto:

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.

Envía un mensaje SMS a un número de teléfono.

CampoTipoRequeridoDefaultDescripción
Número de destino (to)Texto / variableSí—Teléfono al que se envía el SMS.
Mensaje (message)Texto largo / variableSí—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:

CampoTipoDescripción
toTextoNúmero de destino normalizado, con el prefijo del país y sin el +
countryTextoPaís del destino en formato ISO (MX, CO). null si el prefijo no permite determinarlo
segmentsNúmeroSegmentos en que se dividió el mensaje. Cada uno se cobra como un SMS
creditsNúmeroCréditos consumidos por el envío
messageIdTextoIdentificador del envío en el proveedor
deliveryTextoSiempre accepted: el proveedor aceptó el mensaje, pero la entrega aún no está confirmada
noteTextoAviso corto que acompaña a delivery

Genera un código de un solo uso y lo envía por SMS. El código se guarda cifrado y vence solo.

CampoTipoRequeridoDefaultDescripción
Número de destino (to)Texto / variableSí—Teléfono al que se envía el código.
Mensaje del código (template)Texto largo / variableNoMensaje por defecto del sistemaSi 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:

CampoTipoDescripción
toTextoNúmero al que se envió el código
expiresAtTextoFecha y hora en que vence el código
resendAvailableInSecondsNúmeroSegundos que hay que esperar para poder reenviarlo

Comprueba el código que ingresó el usuario contra el que se envió.

CampoTipoRequeridoDefaultDescripción
Número de teléfono (to)Texto / variableSí—Debe ser el mismo número al que se envió el OTP.
Código ingresado por el usuario (otpCode)Texto / variableSí—Típicamente {{trigger.code}} u otra variable con lo que escribió el usuario.

Salidas:

CampoTipoDescripción
validBooleanotrue si el código es correcto y no ha vencido
reasonTextoMotivo cuando no es válido: not_found, expired, too_many_attempts o mismatch
attemptsLeftNúmeroIntentos 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}}.

  1. Enviar código OTP a {{trigger.phone}}.
  2. (El usuario ingresa el código en tu formulario o canal.)
  3. Verificar código OTP con {{trigger.code}} → revisa {{nodes.waiify.valid}}.
  4. Condición (se abre en una pestaña nueva): si valid es verdadero, continúa; si no, muestra {{nodes.waiify.reason}} al usuario.
  • “Waiify: el campo… es requerido” — falta to/message (SMS), to (OTP) u otpCode (verificación); revisa que la variable que alimenta el campo no llegue vacía.
  • El SMS sale más caro de lo esperado — revisa segments en 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 (ver attemptsLeft en los envíos previos). Hay que generar un código nuevo.