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.
Qué conversación se ve afectada
Sección titulada «Qué conversación se ve afectada»El nodo resuelve la conversación a asignar en este orden:
- Un
conversationIdexplí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). - El de
trigger.conversationId, si el flujo arrancó desde un trigger de WhatsApp o del Widget: se resuelve solo, sin llenar nada. - 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.
Parámetros
Sección titulada «Parámetros»| Campo | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
Teléfono del contacto (phone) | Texto / variable | No | — | 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 / variable | No | — | 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 miembros | Sí | [] | 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 miembro | No | Sin límite | Tope de conversaciones activas que puede tener asignadas ese miembro a la vez. Se configura solo para los miembros ya marcados como asignables. |
Salidas
Sección titulada «Salidas»| Campo | Tipo | Descripción |
|---|---|---|
conversationId | Texto | Conversación resuelta y afectada |
assigned | Booleano | true si se asignó a alguien |
assignedTo | Texto | null | ID del miembro asignado, o null si nadie estaba disponible |
allAtCapacity | Booleano | true si había miembros asignables pero todos estaban en su límite |
alreadyAssigned | Booleano | Presente y true cuando la conversación ya tenía un miembro asignado (de una escalación anterior) — el nodo no reasigna por encima |
note | Texto | Solo aparece cuando no se resolvió ninguna conversación o no se encontró en el workspace |
Solución de problemas
Sección titulada «Solución de problemas»assigned: falsecon nota “No se encontró ninguna conversación” — no llegóconversationIdexplí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 elconversationIdde 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.
Ejemplo — repartir leads de un formulario
Sección titulada «Ejemplo — repartir leads de un formulario»- Trigger: Webhook (formulario de la web).
- Contacto CRM → crear o actualizar el contacto con los datos del formulario.
- Asignar a un humano:
- Teléfono del contacto:
{{trigger.body.phone}} - Asignables: equipo de ventas (3 miembros)
- Límite simultáneo: 15 por miembro
- Teléfono del contacto:
- Si
{{nodes.asignar.assigned}}estrue, notifica por Slack (se abre en una pestaña nueva) a{{nodes.asignar.assignedTo}}.
Relacionado
Sección titulada «Relacionado»- Transferencia a humano (asistentes) (se abre en una pestaña nueva) — mismo criterio de reparto, pero disparado por el asistente de IA en vez de un nodo de flujo
- Conversaciones (inbox) (se abre en una pestaña nueva)
- Roles y permisos (se abre en una pestaña nueva)
