Ir al contenido

Nodos de acción

Nodo Asignar a un humano

El nodo Asignar a un humano reparte una conversación al miembro del workspace con menos carga en ese momento. No requiere credencial.

Es el mismo criterio de reparto que usa la transferencia a humano de los asistentes (se abre en una pestaña nueva), pero aquí vive en un flujo genérico: no depende de que un asistente de IA decida escalar. Úsalo cuando la asignación deba dispararse desde otra parte — un trigger programado, un webhook, un evento del CRM — y no desde una conversación de chat en curso.

El nodo resuelve la conversación a asignar en este orden:

  1. Un conversationId explícito en el nodo, o el que traiga el output de un nodo anterior del mismo flujo (usa el selector de variables — no se escribe a mano).
  2. El de trigger.conversationId, si el flujo arrancó desde un trigger de WhatsApp o del Widget: se resuelve solo, sin llenar nada.
  3. La conversación más reciente del contacto con el teléfono indicado en el campo Teléfono del contacto.

Si ninguna de las tres se puede resolver, el nodo no falla: devuelve assigned: false con una nota explicando que no encontró conversación.

CampoTipoRequeridoDefaultDescripción
Teléfono del contacto (phone)Texto / variableNo—Con el código de país (ej. 57...); el + es opcional. Solo hace falta en flujos manuales, programados o disparados por un agente de voz — si un asistente de chat (WhatsApp/Widget) ejecuta este flujo como herramienta, la conversación se detecta sola.
ID de conversación — avanzado (conversationId)Texto / variableNo—Solo se llena con el botón de variables, tomando el resultado de un nodo anterior que ya conozca la conversación. Sección colapsada por defecto (“Avanzado: conectar con otro nodo del flujo”).
¿A quién se le puede asignar? (assignableUserIds)Lista de miembrosSí[]Miembros del workspace elegibles para recibir la conversación. Sin al menos uno, el nodo no tiene a quién repartir y queda marcado como incompleto.
Límite simultáneo por miembro (memberLimits)Número por miembroNoSin límiteTope de conversaciones activas que puede tener asignadas ese miembro a la vez. Se configura solo para los miembros ya marcados como asignables.
CampoTipoDescripción
conversationIdTextoConversación resuelta y afectada
assignedBooleanotrue si se asignó a alguien
assignedToTexto | nullID del miembro asignado, o null si nadie estaba disponible
allAtCapacityBooleanotrue si había miembros asignables pero todos estaban en su límite
alreadyAssignedBooleanoPresente y true cuando la conversación ya tenía un miembro asignado (de una escalación anterior) — el nodo no reasigna por encima
noteTextoSolo aparece cuando no se resolvió ninguna conversación o no se encontró en el workspace
  • assigned: false con nota “No se encontró ninguna conversación” — no llegó conversationId explícito, el flujo no arrancó desde WhatsApp/Widget, y el teléfono no resolvió ninguna conversación existente. Completa el campo Teléfono del contacto o conecta el conversationId de un nodo anterior.
  • allAtCapacity: true — todos los miembros seleccionados están en su límite simultáneo. Sube el límite, agrega más miembros asignables, o deja el límite vacío para “sin límite”.
  • El nodo queda marcado incompleto en el editor — falta seleccionar al menos un miembro en “¿A quién se le puede asignar?”; es el único campo obligatorio.
  • La conversación no se reasigna aunque cambiaste los miembros — es el comportamiento esperado: si ya tiene un assignedTo, el nodo no la reasigna (alreadyAssigned: true). Libera o reasigna manualmente desde el inbox (se abre en una pestaña nueva) si necesitas moverla.
  1. Trigger: Webhook (formulario de la web).
  2. Contacto CRM → crear o actualizar el contacto con los datos del formulario.
  3. Asignar a un humano:
    • Teléfono del contacto: {{trigger.body.phone}}
    • Asignables: equipo de ventas (3 miembros)
    • Límite simultáneo: 15 por miembro
  4. Si {{nodes.asignar.assigned}} es true, notifica por Slack (se abre en una pestaña nueva) a {{nodes.asignar.assignedTo}}.