Asignar agente

Asigna un número de WhatsApp a un agente para que responda los mensajes entrantes. Un número lo responde un solo agente: si otro agente ya lo tiene, el CLI lo mueve (lo quita de ese agente) después de pedir confirmación. Solo cambian los canales de los agentes afectados; el resto de su configuración se mantiene.

bash

01plazbot whatsapp assign -p <número> -a <agentId> [opciones]

Parámetros

Parámetro	Flag	Requerido	Descripción
Teléfono	`-p, --phone <number>`	Sí	Número de WhatsApp en formato internacional, por ejemplo `+51912345678`
Agente	`-a, --agent <agentId>`	Sí	Agente que responderá el número, por ejemplo `age_AbcDef123`
JSON	`--json`	No	Imprime solo JSON en stdout
Confirmar	`-y, --yes`	No	Omite la confirmación cuando el número se mueve entre agentes (para scripts y CI)

La forma anterior con argumentos (plazbot whatsapp assign 51912345678 age_AbcDef123) sigue funcionando.

Ejemplos

bash

01# Hacer que un agente responda un número (lo quita de cualquier otro agente)
02plazbot whatsapp assign -p +51912345678 -a age_AbcDef123
03 
04# Sin confirmación cuando el número cambia de agente
05plazbot whatsapp assign -p +51912345678 -a age_AbcDef123 --yes
06 
07# Salida JSON (con --json la confirmación requiere --yes)
08plazbot whatsapp assign -p +51912345678 -a age_AbcDef123 --yes --json

Resultado

Cuando el número estaba en otro agente:

text

01  +51912345678 is currently assigned to:
02    • Soporte (age_GhiJkl456)
03 
04? Move +51912345678 to "Ventas" and remove it from 1 other agent? Yes
05✔ +51912345678 assigned to "Ventas"
06✔ Removed +51912345678 from "Soporte"
07 
08  +51912345678 now answered by "Ventas" (moved from Soporte).

Cuando el número no estaba en ningún agente, solo se muestra ✔ +51912345678 assigned to "Ventas". Si ya estaba asignado a ese agente y a ningún otro:

text

01  +51912345678 is already assigned to "Ventas". Nothing to change.

Si respondes que no a la confirmación, imprime Aborted. y termina con código 1. El número se asigna primero al agente nuevo y luego se quita de los demás, así nunca queda sin agente.

Salida JSON

json

01{
02  "phone": "51912345678",
03  "agentId": "age_AbcDef123",
04  "agentName": "Ventas",
05  "assigned": true,
06  "changed": true,
07  "removedFrom": [
08    { "id": "age_GhiJkl456", "name": "Soporte" }
09  ]
10}

changed es false (y removedFrom vacío) si el número ya estaba asignado solo a ese agente.
Si no se pudo quitar el número de algún agente, aparece failed con { "id", "name", "error" } por agente y el comando termina con código 1.

Errores comunes

Mensaje	Causa	Solución
`Missing agent ID.`	No pasaste `-a`	Agrega `-a age_AbcDef123` (consulta los IDs con `plazbot agent list`)
`Agent age_AbcDef123 not found in the active workspace.`	ID incorrecto o de otro workspace	Revisa el ID con `plazbot agent list`
`This action needs confirmation and there is no interactive terminal.`	El número cambia de agente, sin terminal o con `--json`, y sin `--yes`	Vuelve a ejecutar con `--yes`
`+51912345678 is still assigned to 1 other agent(s).`	Falló la actualización de algún agente anterior	Quítalo en el panel o vuelve a ejecutar el comando

Revisa las asignaciones actuales con plazbot whatsapp channels.