Get Query Response — POST /api/v1/get-query-response

Send a message to a Botsify bot and receive an AI-generated response in real time. You identify the bot with your API key and the end-user with a session identifier (fbId), which can be a Facebook user ID or any custom string that uniquely represents a user session. The bot uses this identifier to maintain conversational context across multiple turns.

Request

string

required

The user’s message or question to send to the bot.

string

required

Your bot’s API key. Alternatively, pass the same value as the X-Api-Key request header instead of including it in the body.

string

required

A unique identifier for the end-user or session. Can be a Facebook user ID or any custom string (e.g. a UUID) that you generate to represent a session. The bot uses this to maintain context across messages.

Example

curl --request POST \
  --url https://app.botsify.com/api/v1/get-query-response \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "hi",
    "apikey": "YOUR_BOT_API_KEY",
    "fbId": "user-session-123"
  }'

Using the X-Api-Key header instead:

curl --request POST \
  --url https://app.botsify.com/api/v1/get-query-response \
  --header 'X-Api-Key: YOUR_BOT_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "hi",
    "fbId": "user-session-123"
  }'

Response

A successful 200 OK response returns the bot’s reply along with metadata about the matched intent or flow.

Field	Type	Description
`response`	string	The bot’s generated reply to the user’s query.
`fbId`	string	The user session identifier echoed back from the request.
`intent`	string	The intent or flow the bot matched to handle the query, if applicable.

{
  "response": "Hello! How can I help you today?",
  "fbId": "user-session-123",
  "intent": "greeting"
}

Authorization

Bots & Agents

Agent Versions

Messaging

Users & Analytics

WhatsApp

Get Query Response — POST /api/v1/get-query-response

Request

Example

Response

​Request

​Example

​Response

Request

Example

Response