> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar agente

> Criar um novo agente de IA na sua organização.

# Criar agente

Cria um novo agente de IA. O agente é criado como rascunho (`is_published: false`) e com uma ação Human Handoff habilitada.

```http theme={null}
POST https://app.chatnorris.ai/api/v2/chatbots
Authorization: Bearer <sua_api_key>
Content-Type: application/json
```

**Escopo necessário:** `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

```json theme={null}
{
  "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`

```json theme={null}
{
  "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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.