Listar puntos de entrada

GET

entry-points

List entry points

curl --request GET \
  --url https://api.getnexor.ai/api/public/entry-points \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.getnexor.ai/api/public/entry-points', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getnexor.ai/api/public/entry-points",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getnexor.ai/api/public/entry-points"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.getnexor.ai/api/public/entry-points")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "entry_points": [
    {
      "channel": "whatsapp",
      "id": "44444444-4444-4444-8444-444444444444",
      "handle": "+56911111111",
      "label": "Main",
      "active": true,
      "country": null,
      "destination": {
        "type": "group",
        "id": "11111111-1111-4111-8111-111111111111",
        "name": "Inbound"
      },
      "available": true,
      "unavailable_reason": null
    },
    {
      "channel": "phone",
      "id": "55555555-5555-4555-8555-555555555555",
      "handle": "+56222222222",
      "label": "Calls",
      "active": true,
      "country": "CL",
      "destination": null,
      "available": true,
      "unavailable_reason": null,
      "inbound_enabled": false,
      "managed_by_ops": false,
      "assignment": {
        "status": "pending",
        "destination": {
          "type": "group",
          "id": "11111111-1111-4111-8111-111111111111",
          "name": "Inbound"
        },
        "requested_at": "2026-10-12T15:04:05.000Z",
        "error_code": null
      }
    },
    {
      "channel": "webchat",
      "id": "webchat:11111111-1111-4111-8111-111111111111",
      "handle": null,
      "label": null,
      "active": true,
      "country": null,
      "destination": null,
      "available": true,
      "unavailable_reason": null,
      "ambient": true,
      "enabled": false
    }
  ]
}

{
  "error": "inbound_router_not_enabled"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "Forbidden",
  "message": "This API key is missing the required scope: workflows:write"
}

{
  "error": "agent_group_not_found"
}

{
  "error": "internal_error"
}

Un punto de entrada es un lugar por donde te llegan los leads: un número de WhatsApp, un número de iMessage, una línea personal de WhatsApp, un número de teléfono para llamadas, SMS, una cuenta de Instagram o Messenger, un remitente de email o el chat web.

No es la tarea marcada como Punto de entrada cuando pruebas un agente. Esa etiqueta habla de tareas; este endpoint habla de números, cuentas y casillas.

destination indica quién responde en cada punto de entrada. Sus tipos usan nombres anteriores:

`destination.type`	Quién responde
`group`	Un agente (`master_workflow`). Su enrutador de entrada elige la tarea.
`agent`	Una tarea (`workflow`).
`null`	Nadie.

Con master_workflow_id, la lista se ve desde ese agente:

available: false y unavailable_reason explican por qué un punto de entrada no se puede conectar a él.
El email y el chat web del agente aparecen con ambient: true. Pertenecen a todo el agente, y enabled indica si el agente responde ahí.
La cuenta necesita el enrutador de entrada; si no, la API responde 400 inbound_router_not_enabled.

Números de teléfono

Los números de teléfono traen tres campos más:

Campo	Significado
`inbound_enabled`	Si el número contesta llamadas entrantes.
`managed_by_ops`	El equipo de Nexor administra este número. Moverlo o desconectarlo puede rechazarse con 409 `number_managed_by_ops_pool`.
`assignment`	Una conexión a un agente que Nexor todavía está terminando, o que se detuvo. `null` cuando no hay ninguna.

Cuando está presente, assignment trae status, destination (el agente al que se está conectando el número), requested_at y error_code:

`assignment.status`	Significado
`pending`	Nexor todavía está conectando el número, por ejemplo mientras prepara al agente para llamadas. Termina por su cuenta; `assignment` pasa a `null` cuando el número contesta llamadas.
`failed`	La conexión se detuvo. `error_code` indica por qué, por ejemplo `phone_inbound_assignment_timeout` cuando el número todavía no contestaba 10 minutos después de la solicitud. Corrige la causa y envía el cambio otra vez.

Consulta Cuando el agente todavía se está preparando para llamadas. Para cambiar un destino, usa Definir destino.

Autorizaciones

X-API-Key

string

header

requerido

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.

Parámetros de consulta

master_workflow_id

string<uuid>

Optional agent ID. Shows the entry points from that agent's point of view.

Respuesta

Entry points of the account.

entry_points

object[]

requerido

Show child attributes

Última modificación el 13 de octubre de 2026

List entry points

curl --request GET \
  --url https://api.getnexor.ai/api/public/entry-points \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.getnexor.ai/api/public/entry-points', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getnexor.ai/api/public/entry-points",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getnexor.ai/api/public/entry-points"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.getnexor.ai/api/public/entry-points")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "entry_points": [
    {
      "channel": "whatsapp",
      "id": "44444444-4444-4444-8444-444444444444",
      "handle": "+56911111111",
      "label": "Main",
      "active": true,
      "country": null,
      "destination": {
        "type": "group",
        "id": "11111111-1111-4111-8111-111111111111",
        "name": "Inbound"
      },
      "available": true,
      "unavailable_reason": null
    },
    {
      "channel": "phone",
      "id": "55555555-5555-4555-8555-555555555555",
      "handle": "+56222222222",
      "label": "Calls",
      "active": true,
      "country": "CL",
      "destination": null,
      "available": true,
      "unavailable_reason": null,
      "inbound_enabled": false,
      "managed_by_ops": false,
      "assignment": {
        "status": "pending",
        "destination": {
          "type": "group",
          "id": "11111111-1111-4111-8111-111111111111",
          "name": "Inbound"
        },
        "requested_at": "2026-10-12T15:04:05.000Z",
        "error_code": null
      }
    },
    {
      "channel": "webchat",
      "id": "webchat:11111111-1111-4111-8111-111111111111",
      "handle": null,
      "label": null,
      "active": true,
      "country": null,
      "destination": null,
      "available": true,
      "unavailable_reason": null,
      "ambient": true,
      "enabled": false
    }
  ]
}

{
  "error": "inbound_router_not_enabled"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "Forbidden",
  "message": "This API key is missing the required scope: workflows:write"
}

{
  "error": "agent_group_not_found"
}

{
  "error": "internal_error"
}

Empieza aquí

Quickstart

Referencia API

Configura y lanza

WhatsApp

Canales

Agentes

Reuniones

Integraciones

Cuenta

Bandeja de entrada

Métricas

Herramientas para desarrolladores

Referencia de soporte

Listar puntos de entrada

Números de teléfono

Autorizaciones

Parámetros de consulta

Respuesta