Skip to main content
POST
Send Chatbot Message

Authorizations

X-Client-ID
string
header
required
X-API-Key
string
header
required
X-Secret
string
header
required

Headers

X-Tenant-ID
string

Optional tenant selector for multitenant accounts. The API key owner must have access to the selected tenant.

Path Parameters

chatbot_id
string
required

Body

application/json
message
string

What the user typed. Form and choice answers are understood from plain text.

session_key
string

Your stable conversation key, e.g. telegram:12345 or wa:+628123. Reuse it to continue a conversation. Omit to start a new one; the generated key is returned.

Maximum string length: 200
file_urls
string[]

URLs of uploaded files (see /external/upload)

form_values
object

Optional structured form answers keyed by next_step.form_fields[].field

reset
boolean
default:false

Forget the workflow position and partial answers before this message

executor_timezone
integer

Client UTC offset in minutes, e.g. 420 for UTC+7

timeout_seconds
integer
default:300

Max wait for the reply. The turn keeps running after a timeout.

Required range: 1 <= x <= 1800

Response

Turn result

data
object