Definir el destino de un punto de entrada
Conecta un número, línea, cuenta o casilla a un agente o a una tarea, o desconéctalo. Los cambios de teléfono pueden pedir una confirmación o terminar después de la respuesta (202). Requiere confirm: true.
PUT
Usa el
Si recibes 409
Un 202 significa aceptado, todavía no conectado. No necesitas enviar la solicitud otra vez: Nexor termina la conexión por su cuenta, normalmente en menos de un minuto. Lee el número con Listar puntos de entrada hasta que pase una de estas cosas:
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 enmaster_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 400channel_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.phone_inbound_binding_changed, el número cambió mientras tanto: vuelve a listar los puntos de entrada y empieza de nuevo. Con 409 inbound_reception_publication_busy (retryable: true), otro cambio en la configuración de llamadas del mismo agente sigue en curso: espera retry_after_ms y envía la solicitud otra vez.
Cuando el agente todavía se está preparando para llamadas
Conectar un número de teléfono a un agente puede tardar más que la solicitud, por ejemplo cuando las llamadas entrantes del agente estaban desactivadas y Nexor primero tiene que preparar al agente para llamadas. En ese caso la API responde202 Accepted con el punto de entrada y un assignment:
La conexión se detiene como
failed cuando la configuración de llamadas del agente falla y no puede recuperarse, cuando el mismo error ocurre dos veces seguidas, o cuando el número todavía no contesta llamadas 10 minutos después de la solicitud. En ese último caso error_code es el último error visto, o phone_inbound_assignment_timeout si no hubo ninguno. Nexor deja de reintentar una conexión fallida; una nueva solicitud empieza un intento nuevo con 10 minutos nuevos.
Si la propia solicitud detecta que la configuración de llamadas del agente falló, la API responde 409 phone_inbound_assignment_failed con retryable: false y el mismo assignment, con status: "failed" y su error_code. Un 409 phone_inbound_binding_failed significa que la conexión del número se detuvo con un error; binding trae el detalle. En ambos casos, corrige la causa y envía la solicitud otra vez. Un 409 phone_inbound_binding_pending significa que el número todavía se está conectando: vuelve a leerlo como se indica arriba.Autorizaciones
Cuerpo
application/json
Última modificación el 13 de octubre de 2026