GET /v1/agents/{id}: detalle de un agente de IA

Este endpoint devuelve la configuración completa de un agente de IA a partir de su ID. La respuesta incluye todos los ajustes que gobiernan la forma de comunicarse del agente: su tono, los temas que tiene permitido tratar, las condiciones bajo las cuales deriva la conversación a un vendedor humano y la cadencia que sigue al enviar seguimientos automáticos.

Endpoint

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

Parámetros de ruta

string

requerido

Identificador único del agente que se quiere recuperar, por ejemplo agent_abc123.

Solicitud de ejemplo

cURL

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

Respuesta

string

Identificador único del agente.

string

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

string

Nombre visible del agente.

string

Estado actual: 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

Canales asignados al agente: whatsapp, facebook, instagram, web, email o phone.

string

Marca de tiempo ISO 8601 de la creación del agente.

string

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

object

Configuración de comportamiento completa del agente.

Mostrar Campos de configuración

string

Tono conversacional que usa el agente: formal, friendly o professional.

array

Lista de temas o situaciones que hacen que el agente transfiera la conversación a un vendedor humano, por ejemplo "pricing negotiation" o "financing".

array

Lista de temas que el agente tiene permitido tratar, por ejemplo "vehicle availability" o "test drive scheduling".

object

Ajustes que controlan los mensajes de seguimiento automáticos.

Mostrar Campos de la cadencia de seguimiento

integer

Cantidad máxima de mensajes de seguimiento que el agente envía por lead.

integer

Cantidad de días de espera entre cada mensaje de seguimiento.

string

Canal usado para enviar los mensajes de seguimiento, por ejemplo whatsapp.

200 OK

{
  "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",
  "configuration": {
    "tone": "friendly",
    "handoff_triggers": [
      "pricing negotiation",
      "financing",
      "trade-in valuation"
    ],
    "allowed_topics": [
      "vehicle availability",
      "pricing",
      "test drive scheduling",
      "financing options"
    ],
    "follow_up_cadence": {
      "max_follow_ups": 5,
      "interval_days": 3,
      "channel": "whatsapp"
    }
  }
}

Respuestas de error

404 Not Found

{
  "error": "not_found",
  "message": "No agent with ID agent_abc123 exists in your organization."
}

Introducción

Leads

Conversaciones

Agentes

Webhooks

GET /v1/agents/{id}: detalle de un agente de IA | DeltaLead

Endpoint

Parámetros de ruta

Solicitud de ejemplo

Respuesta

Respuestas de error

​Endpoint

​Parámetros de ruta

​Solicitud de ejemplo

​Respuesta

​Respuestas de error

Endpoint

Parámetros de ruta

Solicitud de ejemplo

Respuesta

Respuestas de error