Listar agentes de IA - SocialSell API

Endpoint

GET /v1/ai-agents

Escopo necessário: read:ai_agents — disponível nos planos Growth e Scale.

Exemplo de requisição

curl "https://api.socialsell.ai/v1/ai-agents" \
  -H "Authorization: Bearer sk_live_..."

Exemplo de resposta

{
  "data": [
    {
      "id": "664p1q2r3s4t5u6v7w8x9y0z",
      "name": "Qualificador de Leads",
      "description": "Qualifica leads inbound e agenda reuniões",
      "type": "sales",
      "status": "active",
      "priority": 1,
      "scope": { "channels": ["whatsapp"], "objectives": ["sales"] },
      "triggers": [{ "event": "message.received.from_contact" }],
      "behavior": { "activationMode": "always" },
      "ai_config": { "model": "gpt-oss-120b" },
      "stats": { "runs": 142, "handoffs": 23 },
      "created_at": "2026-05-01T00:00:00.000Z",
      "updated_at": "2026-06-10T12:00:00.000Z"
    }
  ],
  "meta": { "total": 3, "has_more": false }
}

Objeto agente

Campo	Tipo	Descrição
`id`	string	ID do agente
`name`	string	Nome
`description`	string\|null	Descrição
`type`	string	`sales` ou `support`
`status`	string	`draft`, `active`, `paused`
`priority`	integer	Prioridade de execução (menor = mais prioritário)
`scope`	object	Canais e objetivos cobertos
`triggers`	array	Eventos que ativam o agente
`behavior`	object	Modo de ativação e comportamento
`humanization`	object	Configuração de humanização (delays, split)
`guardrails`	object	Limites e proteções
`tools_allowed`	object	Ferramentas habilitadas
`limits`	object	Limites de execução
`ai_config`	object	Modelo e parâmetros de IA
`stats`	object	Estatísticas agregadas (`runs`, `handoffs`)