Bot installations

Create an Agent Bot

Create an agent bot in the account

post/v1/workspaces/{workspace_id}/agent_bots

Request

  • Base URL: https://api.oxvo.com
  • URL: https://api.oxvo.com/v1/workspaces/{workspace_id}/agent_bots
  • Auth: API key in header api_access_token

Request body

namestring

The name of the agent bot

descriptionstring

The description of the agent bot

outgoing_urlstring

The webhook URL for the bot

avatarstring binary

Send the form data with the avatar image binary or use the avatar_url

avatar_urlstring

The url to a jpeg, png file for the agent bot avatar

bot_typeinteger

The type of the bot (0 for webhook)

bot_configobject

The configuration for the bot

Example request

{
  "name": "My Agent Bot",
  "description": "This is a sample agent bot",
  "outgoing_url": "https://example.com/webhook",
  "avatar_url": "https://example.com/avatar.png",
  "bot_config": {}
}

Response

Success

idnumber

ID of the agent bot

namestring

The name of the agent bot

descriptionstring

The description about the agent bot

thumbnailstring

The thumbnail of the agent bot

outgoing_urlstring

The webhook URL for the bot

bot_typestring

The type of the bot

bot_configobject

The configuration of the bot

account_idnumber

Account ID if it's an account specific bot

access_tokenstring

The access token for the bot

system_botboolean

Whether the bot is a system bot

Changes

No recorded changes to this operation across all 1 revision of this API.