Nextcloud — Talk

Nextcloud Talk (Spreed) is the chat / video-meeting app. Bee Flow can list rooms, post messages, react.

Integration ID	nextcloud-talk
Auth	NC session
Required NC app	spreed
Required scope	TALK
Source	server/integrations/nextcloudTalkTools.js

Tools

Tool	Purpose
nextcloud_talk_list_rooms	List rooms the user is in.
nextcloud_talk_get_room	Room details + participant list.
nextcloud_talk_send_message	Post a message.
nextcloud_talk_get_messages	Read recent messages.
nextcloud_talk_search_messages	Full-text search across rooms.
nextcloud_talk_react	Add an emoji reaction.
nextcloud_talk_set_typing	Send a typing indicator.
nextcloud_talk_create_room	Create a new public / group / one-to-one room.
nextcloud_talk_invite	Invite a user to a room.

Endpoints

GET  /ocs/v2.php/apps/spreed/api/v4/room
POST /ocs/v2.php/apps/spreed/api/v4/room
GET  /ocs/v2.php/apps/spreed/api/v1/chat/{token}
POST /ocs/v2.php/apps/spreed/api/v1/chat/{token}
POST /ocs/v2.php/apps/spreed/api/v1/reaction/{token}/{messageId}

Use cases

• "Post a message in #engineering thanking @alice for the PR."
• "Summarise yesterday's chat in #general."
• "Create a one-to-one room with bob and post 'are you free for 5 min?'."
• (Automation) On NC UserCreatedEvent, post a welcome in #welcome.

Bots

Bee Flow can run as a Talk bot — give it a service account, set up a dedicated room, and route automation outputs there. See Automations for the trigger setup.

Privacy

Message bodies are scanned by the Privacy Shield. In Strict mode, message author names tokenise as [person_N] to the model.

Common errors

Error	Cause	Fix
Room is read-only	Talk room locked by mod	Mod unlocks.
Cannot send to one-to-one with self	Trying to message yourself	Use nextcloud_notes_create for self-notes.