Skip to main content
POST
/
api
/
openapi
/
v1
/
bots
Criar Bot
curl --request POST \
  --url https://app.converza.io/api/openapi/v1/bots \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "Bot de Suporte",
  "instructions": "Você é um assistente de suporte amigável. Sempre seja útil e educado.",
  "role": "dynamic",
  "description": "Lida com consultas de suporte ao cliente",
  "temperature": 0.7,
  "identification_name": "João",
  "questions": [
    {
      "question": "<string>",
      "answer": "<string>"
    }
  ],
  "document_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "allow_human": true,
  "actions": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "endpoint": "<string>",
      "method": "GET",
      "headers": {},
      "body": [
        {
          "key": "<string>",
          "value": "<string>",
          "type": "string"
        }
      ]
    }
  ],
  "use_audio_responses": false,
  "allow_user_audio_requests": false,
  "capture_payments": false,
  "break_lines": true,
  "chat_model_level": 0
}
'
{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "Bot de Suporte",
    "role": "support",
    "description": "Lida com consultas de suporte ao cliente",
    "openai_id": "asst_abc123",
    "vector_id": "vs_abc123",
    "instructions": "<string>",
    "temperature": 0.7,
    "published": true,
    "allow_human": true,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization
string
header
required

Token JWT obtido do endpoint /api/openapi/auth/token

Body

application/json
team_id
string<uuid>
required
name
string
required
Example:

"Bot de Suporte"

instructions
string
required
Example:

"Você é um assistente de suporte amigável. Sempre seja útil e educado."

role
enum<string>
default:dynamic
Available options:
support,
dynamic,
sales
description
string
Example:

"Lida com consultas de suporte ao cliente"

temperature
number<float>
default:1
Required range: 0 <= x <= 2
Example:

0.7

identification_name
string | null
Example:

"João"

questions
object[]
document_ids
string<uuid>[]
allow_human
boolean
default:true
actions
object[]
use_audio_responses
boolean
default:false
allow_user_audio_requests
boolean
default:false
capture_payments
boolean
default:false
break_lines
boolean
default:true
chat_model_level
integer
default:0
Required range: 0 <= x <= 2

Response

Bot criado com sucesso

success
boolean
Example:

true

data
object