Skip to main content
PATCH
Update agent behavior config
Combina ajustes de comportamiento en el objeto config de un agente sin modificar prompts, etapas, campos ni prompts por canal. Por defecto, sólo cambian las claves superiores enviadas y se conserva el resto de la configuración. Usa replace: true únicamente cuando necesites reemplazar intencionalmente el objeto completo. Los ajustes comunes incluyen disabled_channels, first_contact_channel, email_sender_id y gate_outbound_to_hours. Durante o después de una llamada, la tarea puede mover la conversación a WhatsApp, SMS, iMessage o correo. Por defecto (shadow) esos mensajes salen y Nexor solo registra si el lead los pidió. Configura channel_swap_consent en enforce cuando la tarea solo deba escribirle a un lead después de una llamada si el lead lo pidió o aceptó que se lo enviaran. Un link de pago, una confirmación de reserva, un contrato, una factura o una oferta que el lead aceptó cuentan como aceptados. Si no, no se envía nada, y el seguimiento posterior a la llamada tampoco lo envía.
  • shadow o null devuelve la tarea al comportamiento por defecto.
  • Cualquier otro valor se rechaza con 400 y error: "INVALID_CHANNEL_SWAP_CONSENT". No se guarda nada.
  • Obtener agente devuelve el modo efectivo en channel_swap_consent de primer nivel (enforce o shadow). Una tarea duplicada conserva el ajuste.
  • enforce también frena mensajes que el equipo puede esperar, como “te escribo por WhatsApp” cuando el lead no puede hablar. Para frenar todo cambio a otro canal, desactiva la herramienta de cambio de canal.

Enviar una copia oculta de los correos de la tarea (email_bcc)

Configura email_bcc con una lista de hasta 5 correos cuando alguien de tu equipo deba recibir una copia de cada correo que la tarea le envía a un lead, por ejemplo un supervisor que sigue una tarea de cobranza. La copia es oculta (CCO): el lead no ve esas direcciones.
  • La copia cubre los correos que Nexor envía por esa tarea. Un correo que una persona escribe desde la bandeja no se copia, y tampoco un correo a un lead de prueba.
  • El ajuste pertenece a una tarea (workflow en la API). Guárdalo en cada tarea que lo necesite.
  • La lista que envías reemplaza a la guardada. Para agregar una dirección, envía la lista completa. null o [] quita la copia.
  • Las direcciones se guardan sin espacios, en minúsculas y sin duplicados. Escribe cada una como una dirección simple (nombre@empresa.com), sin nombre visible.
  • Una lista inválida se rechaza con 400 y error: "INVALID_EMAIL_BCC". No se guarda nada. reason indica el motivo: not_a_list, invalid_address o too_many_addresses.
  • No existe copia visible (CC) para los correos de la tarea.

Authorizations

X-API-Key
string
header
required

API key for authentication. Keys are prefixed with nxr_live_. To work inside a sub-account with a main account key, also send the optional X-Nexor-Sub-Account-Id header.

Path Parameters

id
string<uuid>
required

Agent ID

Body

application/json
config
object
required

Top-level behavior config keys to merge or replace.

replace
boolean
default:false

Replace the complete config object instead of merging.

Response

Config updated

success
boolean
required
Example:

true

workflow_id
string<uuid>
required
config
object
required
Last modified on November 11, 2026