Listar todos los agentes de IA de la organización

Este endpoint devuelve una lista paginada de todos los agentes de IA configurados en la organización de DeltaLead. Cada registro incluye el estado actual del agente, el idioma en el que conversa y los canales que tiene asignados, de modo que basta una lectura para tener el panorama operativo completo de la dotación de agentes de IA.

Endpoint

GET https://platform-api.deltalead.ai/v1/agents

Parámetros de consulta

integer

predeterminado:"20"

Cantidad máxima de agentes que se devuelven por página. Acepta valores entre 1 y 100.

string

Cursor de paginación devuelto en el campo pagination.next_cursor de la respuesta anterior. Si se omite este parámetro, la lectura empieza por el comienzo de la lista.

string

Filtra los resultados por estado del agente. Valores aceptados: active, inactive, draft. Si se omite, se devuelven los agentes de todos los estados.

Solicitud de ejemplo

cURL

curl https://platform-api.deltalead.ai/v1/agents \
  -H "X-API-Key: YOUR_API_KEY"

Respuesta

array

Arreglo de objetos de agente que coinciden con la consulta.

Mostrar Campos del objeto de agente

string

Identificador único del agente, por ejemplo agent_abc123.

string

ID de la organización a la que pertenece el agente.

string

Nombre visible del agente, por ejemplo Martín de Ventas.

string

Estado actual del agente: active, inactive o draft.

string

Configuración regional de idioma que usa el agente: es-AR, es-MX, es-CR, es-CO, pt-BR o en-US.

array

Lista de canales que atiende el agente: whatsapp, facebook, instagram, web, email o phone.

string

Marca de tiempo ISO 8601 del momento en que se creó el agente.

string

Marca de tiempo ISO 8601 de la actualización más reciente del agente.

object

Metadatos de paginación del conjunto de resultados.

Mostrar Campos de paginación

integer

El valor de limit aplicado a esta solicitud.

string | null

Cursor que se pasa como cursor en la solicitud siguiente para recuperar la próxima página. Es null cuando no quedan más páginas.

boolean

true si hay páginas adicionales de resultados disponibles.

200 OK

{
  "data": [
    {
      "id": "agent_abc123",
      "organization_id": "org_xyz789",
      "name": "Martín de Ventas",
      "status": "active",
      "language": "es-AR",
      "channels": ["whatsapp", "instagram"],
      "created_at": "2024-01-15T10:00:00Z",
      "updated_at": "2024-10-01T08:30:00Z"
    },
    {
      "id": "agent_def456",
      "organization_id": "org_xyz789",
      "name": "Ana Atención",
      "status": "active",
      "language": "es-CR",
      "channels": ["web", "email"],
      "created_at": "2024-03-20T14:00:00Z",
      "updated_at": "2024-09-15T11:00:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "next_cursor": null,
    "has_more": false
  }
}

Los agentes active están atendiendo conversaciones en vivo. Los agentes inactive están pausados y no responden a mensajes nuevos. Los agentes draft fueron creados pero nunca publicados: todavía no interactuaron con ningún lead.

Introducción

Leads

Conversaciones

Agentes

Webhooks

Listar todos los agentes de IA de la organización | DeltaLead

Endpoint

Parámetros de consulta

Solicitud de ejemplo

Respuesta

​Endpoint

​Parámetros de consulta

​Solicitud de ejemplo

​Respuesta

Endpoint

Parámetros de consulta

Solicitud de ejemplo

Respuesta