Send chat message
Send a chat message to the meeting through the bot.
The message will be sent as the bot in the meeting's chat. The bot must be actively in the meeting to send messages. Messages are limited to 500 characters and cannot be empty or whitespace-only.
Status Requirements: The bot must be in one of the following statuses: in_call_not_recording, in_call_recording, recording_paused, or recording_resumed. If the bot is in any other state (e.g., queued, joining_call, in_waiting_room, completed, failed), the request will fail with a 409 Conflict error (FST_ERR_BOT_STATUS).
Chat Disabled: Some meetings have chat disabled by the host or meeting policy. If the bot attempts to send a message in a meeting where chat is not available, the request will fail with a 422 Unprocessable Entity error (FST_ERR_CHAT_DISABLED). This is determined at runtime by the meeting platform and cannot be known in advance. Chat disabled detection works for Zoom and Microsoft Teams meetings. For Google Meet, message delivery is best-effort — the bot may report success even if the host has restricted chat permissions for external participants.
Message Delivery: The message is forwarded to the bot process which sends it through the meeting platform's chat API (Google Meet, Microsoft Teams, or Zoom). Delivery is best-effort — if the bot process is unreachable or the platform rejects the message, the request will fail with a 500 Internal Server Error (FST_ERR_SEND_CHAT_MESSAGE_FAILED).
Message Persistence: Successfully sent messages are included in the chat_messages artifact alongside received messages when the bot completes. Bot-sent messages have sender_id: null and the bot's display name as sender_name.
Returns 404 if the bot is not found, 409 if the bot's status does not allow this operation, or 422 if chat is disabled in the meeting.
Authorization
ApiKeyAuth Your Meeting BaaS API key. Get one from your account settings.
In: header
Path Parameters
The UUID of the bot to send the chat message through.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidRequest Body
application/json
The chat message text to send in the meeting.
1 <= length <= 500Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.meetingbaas.com/v2/bots/497f6eca-6276-4993-bfeb-53cbbbba6f08/send-chat-message" \ -H "Content-Type: application/json" \ -d '{ "message": "string" }'{
"success": true,
"data": {
"message": "string"
}
}{
"success": false,
"error": "string",
"code": "string",
"statusCode": 9007199254740991,
"message": "string"
}{
"success": false,
"error": "string",
"code": "string",
"statusCode": 9007199254740991,
"message": "string",
"details": "string"
}{
"success": false,
"error": "string",
"code": "string",
"statusCode": 9007199254740991,
"message": "string",
"details": "string"
}{
"success": false,
"error": "string",
"code": "string",
"statusCode": 9007199254740991,
"message": "string",
"details": "string"
}{
"success": false,
"error": "string",
"code": "string",
"statusCode": 9007199254740991,
"message": "string",
"details": "string",
"retryAfter": 9007199254740991
}{
"success": false,
"error": "string",
"code": "string",
"statusCode": 9007199254740991,
"message": "string",
"details": "string"
}