NEnextcloud
bot

Sends a new chat message to the given room

Changed on

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

Request

  • The document declares no server URL.
  • Auth
    • none
    • or HTTP bearer
    • or HTTP basic

Path parameters

apiVersion'v1' required
tokenstring required

Conversation token

Headers

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

Request body

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)

Response

Message sent successfully

Changes

  • bbab49b96f5eRevision changes
    • info

      added the new optional header request parameter x-nextcloud-talk-bot-random

    • info

      added the new optional header request parameter x-nextcloud-talk-bot-signature

  • 31b09d1bcf85Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property