Agentes IA

Los agentes IA de Mirlo atienden conversaciones de WhatsApp, webchat y llamadas de voz de forma autonoma. Puedes configurar su comportamiento (prompt), herramientas, voz y reglas de transferencia via API.

Autenticacion

Todos los endpoints requieren autenticacion con el header X-API-Key:

-H "X-API-Key: sk_live_tu_api_key"

Base URL

https://api.mirlo.com/v1/members/organizations/{organization_id}

Listar Agentes IA

Retorna los agentes IA de tu organizacion con su estado de conexion y flujos asociados.

curl -X GET "https://api.mirlo.com/v1/members/organizations/{organization_id}/members/ai-agents" \
  -H "X-API-Key: sk_live_tu_api_key"

Parametros de Query

Parametro	Tipo	Descripcion
`search`	string	Filtrar por nombre (case-insensitive)
`category`	string	Filtrar por categoria: `sales`, `support`, etc.
`sort`	string	Ordenar por: `name`, `created_at`. Default: `name`
`order`	string	Direccion: `asc`, `desc`. Default: `asc`
`page`	number	Pagina. Default: 1
`limit`	number	Resultados por pagina (1-100). Default: 20

Response

{
  "agents": [
    {
      "id": "81ab9945-dfdd-4ee3-b413-59cae534e9d3",
      "name": "Asistente de Ventas",
      "email": "ventas@tuempresa.com",
      "type": "ai",
      "status": "available",
      "avatar_url": "https://example.com/avatar.png",
      "agent_type": "generic",
      "business_category": "sales",
      "teams": [
        { "team_id": "abc123", "team_name": "Ventas" }
      ],
      "connections": ["whatsapp", "webchat"],
      "has_config": true
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20
}

Obtener Detalle de Agente

curl -X GET "https://api.mirlo.com/v1/members/organizations/{organization_id}/members/ai-agents/{agent_id}" \
  -H "X-API-Key: sk_live_tu_api_key"

Obtener Configuracion

curl -X GET "https://api.mirlo.com/v1/members/organizations/{organization_id}/members/{agent_id}/agent-config" \
  -H "X-API-Key: sk_live_tu_api_key"

Response

{
  "id": "config-uuid",
  "member_id": "81ab9945-dfdd-4ee3-b413-59cae534e9d3",
  "sections": {
    "identity": "Eres un asistente de ventas...",
    "rules": "Siempre saluda al cliente...",
    "knowledge": "Nuestros productos incluyen..."
  },
  "tools": {
    "transfer_to_human": { "enabled": true },
    "search_knowledge": { "enabled": true }
  },
  "voice": "female",
  "agent_type": "generic",
  "business_category": "sales",
  "call_transfers": [],
  "created_at": "2026-01-15T10:00:00.000Z",
  "updated_at": "2026-08-01T14:30:00.000Z"
}

En esta pagina