Skip to main content

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

CampoTipoDescrição
idstringID do agente
namestringNome
descriptionstring|nullDescrição
typestringsales ou support
statusstringdraft, active, paused
priorityintegerPrioridade de execução (menor = mais prioritário)
scopeobjectCanais e objetivos cobertos
triggersarrayEventos que ativam o agente
behaviorobjectModo de ativação e comportamento
humanizationobjectConfiguração de humanização (delays, split)
guardrailsobjectLimites e proteções
tools_allowedobjectFerramentas habilitadas
limitsobjectLimites de execução
ai_configobjectModelo e parâmetros de IA
statsobjectEstatísticas agregadas (runs, handoffs)