🇪🇸 Español 🇬🇧 English 🇧🇷 Português

Nodo de IVR: Buscar contacto

Cómo usar el nodo Buscar contacto del editor de flujo IVR para identificar al llamante por su número y guardar sus datos para el resto del flujo.

Jul 11, 2026

El nodo Buscar contacto (tipo ContactLookup) busca en tu base de contactos del workspace a la persona que está llamando, usando el número de teléfono del llamante. Si lo encuentra, guarda su información en variables que podés usar en nodos posteriores (Condición, Bifurcar, mensajes personalizados). No requiere ninguna configuración: simplemente colocalo en el flujo donde quieras hacer la búsqueda.

Cómo funciona

El nodo normaliza el número del llamante a formato E.164 y también prueba variantes (con y sin +, solo dígitos) para maximizar la coincidencia con lo que tengas guardado en el campo teléfono del contacto, dentro del mismo workspace del canal.

Salidas

  • found: se encontró un contacto. Quedan disponibles las variables contact.id, contact.name, contact.email, contact.tags (lista de etiquetas) y contact.is_new = false.
  • not_found: no se encontró ningún contacto con ese número. Se marca contact.is_new = true.

Ejemplo

Colocás Buscar contacto justo después del saludo inicial. Conectás la salida found a una Condición con la expresión contact.tags includes 'vip' para dar prioridad a clientes etiquetados como VIP; conectás not_found directo al menú principal, ya que se trata de un llamante nuevo que probablemente necesite registrarse primero.

Consejos

  • Colocalo temprano en el flujo, antes de cualquier nodo que use contact.* en su configuración (Condición, mensajes personalizados, etc.) — si no se ejecutó antes, esas variables van a estar vacías.
  • El campo teléfono del contacto debe existir para que este nodo lo encuentre; si tus contactos se crean sin teléfono (por ejemplo, solo por WhatsApp con otro identificador), la búsqueda va a fallar sistemáticamente.
  • Combinalo con el nodo Buscar conversación (si está disponible en tu plan) para además rutear al mismo agente/equipo que atendió al cliente la última vez.

Solución de problemas

Si un contacto que sabés que existe siempre cae en not_found, verificá que el número guardado en su ficha esté en un formato reconocible (con o sin +, con código de país) — el nodo prueba varias variantes pero no puede adivinar números guardados de forma muy distinta a como llama el cliente.

¿Te fue útil?

Artículos relacionados