Skip to main content
In this guide, we will walk through the process of creating a chatbot using an API.

​
Prerequisites

Before you begin, make sure you have the following:
  1. An API key for accessing the Chatwize API.
  2. A development environment or tool for making HTTP requests, such as Curl or a programming language like Python.

​
API Endpoint

The API endpoint for creating a chatbot is: 
https://app.chatwize.ai/api/v1/chatbot/create

​
Request Body

To create a chatbot, you need to send a POST request to the API endpoint with a JSON request body. Here’s an example request body: 
{
  "model": "gpt-3.5-turbo",
  "name": "Your Chatbot's Name",
  "prompt": "A sample prompt for your chatbot.",
  "rate_limit": [
    20,
    240
  ],
  "rate_limit_message": "Too many messages",
  "show_citations": false,
  "temperature": 0,
  "visibility": "private"
}
  • model (string, optional): Specify the model you want to use. In this example, we’re using gpt-3.5-turbo. Options available gpt-3.5-turbo, gpt-3.5-turbo-16k, gpt-4
  • name (string, required): Provide a name for your chatbot.
  • prompt (string, optional): You can provide an initial prompt for your chatbot.
  • rate_limit (array, optional): Set the rate limit for the chatbot in messages per minute. It’s an array with two values: [20, 240]. First number: amount of messages. Min 1 - Max 100 Second number: amount of seconds. Min 1 - Max 360
  • rate_limit_message (string, optional): Define a message to display when the rate limit is exceeded.
  • show_citations (boolean, optional): Set to true if you want the chatbot to show citations for its responses.
  • temperature (float, optional): You can adjust the temperature parameter for response randomness. A value of 0 makes responses deterministic, while higher values increase randomness. Options are values as a float between 0 and 1
  • visibility (string, optional): Set the visibility of your chatbot. Options are “private” or “public.” Options available private, public, hybrid

​
Example Request

Here’re example command sto create a chatbot using the Chatwize API:
Replace token with your actual API key.
curl --location --request POST 'https://app.chatwize.ai/api/v1/chatbot/create' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
    "model": "gpt-3.5-turbo",
    "name": "Your Chatbot Name",
    "prompt": "A sample prompt for your chatbot.",
    "rate_limit": [
        20,
        240
    ],
    "rate_limit_message": "Too many messages",
    "show_citations": false,
    "temperature": 0,
    "visibility": "private"
}'
That’s it! You’ve now learned how to create your own chatbot using the Chatwize API.