Salesforce Service Cloud APIs

Salesforce Service Cloud APIs Bot API

The bot API from Salesforce Service Cloud APIs — 3 operation(s) for bot.

GitHub OpenAPI
Business capability
Self-Service Management BC-430.40

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v5.3.0/bots/{bot-id}/sessions Start a conversation with an Einstein Bot · Start a session #
Ask an LLM
“How do I open a new chat session with an Einstein Bot from my own app?”
“Can I pass context variables and the customer's timezone when a bot conversation begins?”
Tell an agent
Start a new session with bot {bot_id} in org {org_id}.
Open a conversation with bot {bot_id} using session key {session_key}.
POST /v5.3.0/sessions/{session-id}/messages Send a message in an active bot session · Continue an active session #
Ask an LLM
“How do I send the customer's next reply to a bot conversation that's already running?”
“Can I keep talking to the bot on an existing session instead of starting over?”
Tell an agent
Send the message {message} to bot session {session_id}.
Reply {message} in the ongoing bot conversation {session_id} for org {org_id}.
DELETE /v5.3.0/sessions/{session-id} End an active bot session · End an active session #
Ask an LLM
“How do I close out a bot conversation when the customer leaves?”
“Can I record why a bot session ended when I terminate it?”
Tell an agent destructive · confirm first
End bot session {session_id} with reason {reason}.
Terminate the bot conversation {session_id} in org {org_id} because {reason}.

Documentation

📖
Documentation
https://developer.salesforce.com/docs/atlas.en-us.bot_cookbook.meta/bot_cookbook/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/service-cloud/refs/heads/main/openapi/service-cloud-bot-api-openapi.yml

Other Resources

🔗
SourceCode
https://github.com/forcedotcom/einstein-bot-sdk-java

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/service-cloud:service-cloud-bot-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

service-cloud-bot-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Einstein Bots API (BETA) Bot API
  version: v5.3.0
servers:
- url: https://runtime-api-na-west.prod.chatbots.sfdc.sh
  description: Einstein Bots API - NA West
- url: https://runtime-api-na-east.prod.chatbots.sfdc.sh
  description: Einstein Bots API - NA East
- url: https://runtime-api-eu-west.prod.chatbots.sfdc.sh
  description: Einstein Bots API - EU West
- url: https://runtime-api-eu-east.prod.chatbots.sfdc.sh
  description: Einstein Bots API - EU East
- url: https://runtime-api-ap-west.prod.chatbots.sfdc.sh
  description: Einstein Bots API - AP West
- url: https://runtime-api-ap-east.prod.chatbots.sfdc.sh
  description: Einstein Bots API - AP East
tags:


# --- truncated at 32 KB (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/service-cloud/refs/heads/main/openapi/service-cloud-bot-api-openapi.yml