Criar agente
Cria um novo agente de IA. O agente é criado como rascunho (is_published: false) e com uma ação Human Handoff habilitada.
POST https://app.chatnorris.ai/api/v2/chatbots
Authorization: Bearer <sua_api_key>
Content-Type: application/json
chatbots:write
Corpo da request
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | ✅ | Nome do agente (1–100 caracteres) |
system_prompt | string | — | Instruções do sistema para o agente |
locale | string | — | Idioma dos textos padrão das ações criadas com o agente (Human Handoff e, quando for o caso, Lead Form): es (padrão) ou en. Não é salvo no agente nem retornado na resposta |
widget_config | object | — | Configuração visual do widget |
widget_config.primaryColor | string | — | Cor primária do widget (hex) |
widget_config.greeting | string | — | Mensagem de boas-vindas |
widget_config.leadCapture | boolean | — | Se for true, o agente também é criado com uma ação Lead Form habilitada |
Exemplo
{
"name": "Suporte ao cliente",
"system_prompt": "Você é o assistente virtual da Acme Corp. Responda em português, com tom gentil e conciso.",
"locale": "es",
"widget_config": {
"primaryColor": "#00ed64",
"greeting": "Olá! Como posso ajudar você hoje?",
"leadCapture": false
}
}
Resposta 201 Created
{
"status": "success",
"data": {
"id": "bot_xyz789",
"name": "Suporte ao cliente",
"description": null,
"system_prompt": "Você é o assistente virtual da Acme Corp...",
"model": "claude-sonnet-4-6",
"temperature": 0.7,
"max_tokens": 1000,
"is_active": true,
"is_published": false,
"widget_config": {
"primaryColor": "#00ed64",
"greeting": "Olá! Como posso ajudar você hoje?",
"leadCapture": false
},
"created_at": "2026-06-30T18:00:00.000Z",
"updated_at": "2026-06-30T18:00:00.000Z"
}
}
Erros comuns
| Code | Descrição |
|---|---|
INVALID_INPUT | Falta o campo name ou ele ultrapassa 100 caracteres |
PLAN_LIMIT_REACHED | O limite de agentes do plano foi atingido |