v47

latestOpenAPI 3.0.3agplraw.githubusercontent.com2026-08-014467.9 KB

bot

Sends a new chat message to the given room

The author and timestamp are automatically set to the current user/guest and time.

post/ocs/v2.php/apps/spreed/api/{apiVersion}/bot/{token}/message

apiVersion'v1' required

tokenstring required

Conversation token

x-nextcloud-talk-bot-randomstring

Random seed (at least 32 bytes) used together with the message to generate the SHA256-HMAC request signature

x-nextcloud-talk-bot-signaturestring

SHA256-HMAC signature over the concatenation of the random seed and the message, signed with the shared bot secret, to verify authenticity

OCS-APIRequestboolean required

Required to be true for the API request to pass

messagestring required

The message to send

referenceIdstring

For the message to be able to later identify it again

replyTointeger

Parent id which this message is a reply to

silentboolean

If sent silent the chat message will not create any notifications

threadTitlestring

Only supported when not replying, when given will create a thread (requires threads capability)

threadIdinteger

Thread id which this message is a reply to without quoting a specific message (ignored when $replyTo is given, also requires threads capability)

Message sent successfully

All 4 operations