Account AgentBots
Create an Agent Bot
Criar um bot agente na conta
POST
/
api
/
v1
/
accounts
/
{account_id}
/
agent_bots
Create an Agent Bot
curl --request POST \
--url https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots \
--header 'Content-Type: application/json' \
--header 'api_access_token: <api-key>' \
--data '
{
"name": "My Agent Bot",
"description": "This is a sample agent bot",
"outgoing_url": "https://example.com/webhook",
"avatar": "<string>",
"avatar_url": "https://example.com/avatar.png",
"bot_type": 0,
"bot_config": {}
}
'import requests
url = "https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots"
payload = {
"name": "My Agent Bot",
"description": "This is a sample agent bot",
"outgoing_url": "https://example.com/webhook",
"avatar": "<string>",
"avatar_url": "https://example.com/avatar.png",
"bot_type": 0,
"bot_config": {}
}
headers = {
"api_access_token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_access_token: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'My Agent Bot',
description: 'This is a sample agent bot',
outgoing_url: 'https://example.com/webhook',
avatar: '<string>',
avatar_url: 'https://example.com/avatar.png',
bot_type: 0,
bot_config: {}
})
};
fetch('https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'My Agent Bot',
'description' => 'This is a sample agent bot',
'outgoing_url' => 'https://example.com/webhook',
'avatar' => '<string>',
'avatar_url' => 'https://example.com/avatar.png',
'bot_type' => 0,
'bot_config' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_access_token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots"
payload := strings.NewReader("{\n \"name\": \"My Agent Bot\",\n \"description\": \"This is a sample agent bot\",\n \"outgoing_url\": \"https://example.com/webhook\",\n \"avatar\": \"<string>\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"bot_type\": 0,\n \"bot_config\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_access_token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots")
.header("api_access_token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"My Agent Bot\",\n \"description\": \"This is a sample agent bot\",\n \"outgoing_url\": \"https://example.com/webhook\",\n \"avatar\": \"<string>\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"bot_type\": 0,\n \"bot_config\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_access_token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"My Agent Bot\",\n \"description\": \"This is a sample agent bot\",\n \"outgoing_url\": \"https://example.com/webhook\",\n \"avatar\": \"<string>\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"bot_type\": 0,\n \"bot_config\": {}\n}"
response = http.request(request)
puts response.read_body{
"id": 123,
"name": "<string>",
"description": "<string>",
"thumbnail": "<string>",
"outgoing_url": "<string>",
"bot_type": "<string>",
"bot_config": {},
"account_id": 123,
"access_token": "<string>",
"system_bot": true
}{
"description": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>",
"code": "<string>"
}
]
}Authorizations
This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.
Body
application/json
Response
Success
⌘I
Create an Agent Bot
curl --request POST \
--url https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots \
--header 'Content-Type: application/json' \
--header 'api_access_token: <api-key>' \
--data '
{
"name": "My Agent Bot",
"description": "This is a sample agent bot",
"outgoing_url": "https://example.com/webhook",
"avatar": "<string>",
"avatar_url": "https://example.com/avatar.png",
"bot_type": 0,
"bot_config": {}
}
'import requests
url = "https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots"
payload = {
"name": "My Agent Bot",
"description": "This is a sample agent bot",
"outgoing_url": "https://example.com/webhook",
"avatar": "<string>",
"avatar_url": "https://example.com/avatar.png",
"bot_type": 0,
"bot_config": {}
}
headers = {
"api_access_token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_access_token: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'My Agent Bot',
description: 'This is a sample agent bot',
outgoing_url: 'https://example.com/webhook',
avatar: '<string>',
avatar_url: 'https://example.com/avatar.png',
bot_type: 0,
bot_config: {}
})
};
fetch('https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'My Agent Bot',
'description' => 'This is a sample agent bot',
'outgoing_url' => 'https://example.com/webhook',
'avatar' => '<string>',
'avatar_url' => 'https://example.com/avatar.png',
'bot_type' => 0,
'bot_config' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_access_token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots"
payload := strings.NewReader("{\n \"name\": \"My Agent Bot\",\n \"description\": \"This is a sample agent bot\",\n \"outgoing_url\": \"https://example.com/webhook\",\n \"avatar\": \"<string>\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"bot_type\": 0,\n \"bot_config\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_access_token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots")
.header("api_access_token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"My Agent Bot\",\n \"description\": \"This is a sample agent bot\",\n \"outgoing_url\": \"https://example.com/webhook\",\n \"avatar\": \"<string>\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"bot_type\": 0,\n \"bot_config\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.clickdesk.openclick.ai/api/v1/accounts/{account_id}/agent_bots")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_access_token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"My Agent Bot\",\n \"description\": \"This is a sample agent bot\",\n \"outgoing_url\": \"https://example.com/webhook\",\n \"avatar\": \"<string>\",\n \"avatar_url\": \"https://example.com/avatar.png\",\n \"bot_type\": 0,\n \"bot_config\": {}\n}"
response = http.request(request)
puts response.read_body{
"id": 123,
"name": "<string>",
"description": "<string>",
"thumbnail": "<string>",
"outgoing_url": "<string>",
"bot_type": "<string>",
"bot_config": {},
"account_id": 123,
"access_token": "<string>",
"system_bot": true
}{
"description": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>",
"code": "<string>"
}
]
}
