Skip to main content
POST
/
v1
/
bot
/
trigger
Fire Trigger Event
curl --request POST \
  --url https://api.boostgpt.co/v1/bot/trigger \
  --header 'Content-Type: application/json' \
  --data '
{
  "bot_id": "<string>",
  "event": "<string>",
  "context": {},
  "source_url": "<string>",
  "user": {
    "name": "<string>",
    "email": "<string>",
    "id": "<string>"
  },
  "screenshot": "<string>"
}
'
{
  "success": true,
  "chat_id": "<string>",
  "chat_url": "<string>",
  "event": "<string>"
}

Body

application/json
bot_id
string
required

Agent ID

event
string
required

Event name (e.g., 'checkout_error')

context
object

Custom context key-value pairs

source_url
string

Page URL where trigger fired

user
object

User information

screenshot
string

Base64 data URL of page screenshot (max 5MB)

Response

Trigger fired successfully

success
boolean
chat_id
string

Chat session UUID

chat_url
string

URL to chat interface

event
string

Event name