Skip to main content
PUT
Usa el id y el channel de Listar puntos de entrada, y elige un destino:

Email y chat web

El email y el chat web pertenecen a todo el agente. Envía el agente en master_workflow_id y usa group con ese mismo agente para activar el canal, o none para desactivarlo. El id del chat web es webchat: seguido del ID del agente.

Cuando el agente ya tiene uno

Si el agente ya tiene un punto de entrada del mismo canal, la API responde 400 channel_type_already_connected. Envía replace: true para desconectar el anterior y conectar este. Funciona con WhatsApp, SMS, iMessage, Instagram y Messenger.

Números de teléfono

Mover un número de teléfono puede cambiar quién atiende las llamadas, así que la API puede pedirte una confirmación:
1

Envía el cambio

La API responde 409 phone_inbound_binding_confirmation_required. conflict explica qué cambiaría, y required_confirmation trae la confirmación.
2

Repítelo con la confirmación

Envía la misma solicitud otra vez con required_confirmation copiado, sin cambios, como confirmation. No renombres sus claves.
Si recibes 409 phone_inbound_binding_changed, el número cambió mientras tanto: vuelve a listar los puntos de entrada y empieza de nuevo. Con inbound_reception_publication_busy, espera retry_after_ms y reintenta.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Cuerpo

application/json
channel
enum<string>
requerido
Opciones disponibles:
whatsapp,
imessage,
unsupervised-whatsapp,
phone,
sms,
instagram,
messenger,
email,
webchat
id
string
requerido

Entry point id from List entry points.

Minimum string length: 1
destination
object
requerido

{"type": "group", "id": <agent id>}, {"type": "agent", "id": <task id>}, or {"type": "none"}.

confirm
enum<boolean>
requerido

Must be true.

Opciones disponibles:
true
master_workflow_id
string<uuid>

Required for email and webchat: the agent whose channel you switch on or off.

replace
boolean
predeterminado:false

Disconnect the agent's current entry point of the same channel and connect this one.

confirmation
object

Only for phone numbers: the required_confirmation object from the previous 409, unchanged.

Respuesta

Entry point after the change.

entry_point
object
requerido
Última modificación el 28 de septiembre de 2026