Skip to main content

​
Endpoint

POST /v1/ai-agents
Escopo necessário: write:ai_agents

​
Corpo da requisição

CampoTipoObrigatórioDescrição
namestringSimNome do agente (3–100 chars)
typestringSimsales ou support
scopeobjectSimCanais e objetivos cobertos
triggersarraySimEventos que ativam o agente
behaviorobjectSimComportamento e modo de ativação
descriptionstringNãoDescrição
humanizationobjectNãoHumanização de respostas (delays, split de mensagens)
guardrailsobjectNãoLimites e proteções
tools_allowedobjectNãoFerramentas habilitadas para o agente
limitsobjectNãoLimites de execução por conversa
ai_configobjectNãoModelo e parâmetros de IA
A estrutura de configuração espelha as opções disponíveis no painel em Agentes de IA. Recomenda-se criar um agente pelo painel e usar GET /v1/ai-agents/:id como referência para o formato exato dos objetos aninhados.

​
Exemplo de requisição

curl -X POST https://api.socialsell.ai/v1/ai-agents \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Atendente Suporte L1",
    "type": "support",
    "scope": { "channels": ["whatsapp"], "objectives": ["support"] },
    "triggers": [{ "event": "message.received.from_contact" }],
    "behavior": { "activationMode": "always" }
  }'

​
Resposta

Retorna HTTP 201. O agente é criado com status: draft. Para ativá-lo, use Publicar agente.