Nextcloud Talk Setup

Full voice + chat support. Connect your Nextcloud instance to let your agent join Talk rooms.

Capabilities: audio_inaudio_outreadwritetyping

Prerequisites

Before connecting, your Nextcloud instance must have the Chamade for Talk addon installed. This addon manages bot user creation and authorization. You need admin access to the Nextcloud instance.

Self-hosted

Nextcloud Talk is a self-hosted platform. Each Nextcloud instance needs the addon installed independently. The addon creates a dedicated bot user for Chamade on your instance.

Install from the Nextcloud App Store

The easiest way: Chamade for Talk is published on the official Nextcloud App Store and can be installed in one click from your instance's admin UI.

Open Administration settings → Apps

Go to the Integration or Multimedia category (or search for "Chamade")

Click "Download and enable" on the Chamade for Talk card

Prefer the command line? Run this as the web user on your Nextcloud server:

occ

sudo -u www-data php occ app:install chamade_talk

On Nextcloud AIO, prefix with docker exec -u www-data nextcloud-aio-nextcloud. The App Store installer fetches the signed archive directly from Codeberg, verifies the signature, and enables the app — no manual download needed.

Connect your instance

Go to your Chamade Dashboard → Platforms

Click "Connect" on the Nextcloud Talk card

Enter your Nextcloud instance URL (e.g. https://cloud.example.com)

You are redirected to your Nextcloud instance — log in, then click "Approve" to authorize Chamade

The dashboard updates automatically once the connection is established

Behind the scenes, the addon creates a dedicated bot user named "Chamade (your_username)" on your Nextcloud instance. The bot is placed in a visibility group with you, so other users on the instance won't see it (on instances with group-based user visibility).

One instance per account

Each Chamade account can connect one Nextcloud instance at a time. Connecting a new instance replaces the previous connection.

Authorization & privacy

The bot is scoped to your Nextcloud account. Other users on the instance cannot use it without your consent:

Direct messages: Only you can DM the bot. Messages from other users are silently ignored.
Group rooms: The bot is inactive by default. Type /activate in a room to enable it. Only you (the account owner) can activate or deactivate the bot.
Deactivate: Type /deactivate in a room to disable the bot. The bot stays in the room but stops responding.

Recommended: restrict user visibility

By default, all users on the Nextcloud instance can see the bot in the user directory and invite it to rooms (it won't respond, but it's not ideal). To hide the bot from other users, enable group-based user visibility in your Nextcloud admin settings: Administration → Sharing → Restrict users to only share with users in their groups. The bot is already placed in a private group with you during setup.

Join a voice call

Once connected, your agent can join any Talk room on your Nextcloud instance by providing the room URL.

MCP

chamade_call_join(platform: "nctalk", meeting_url: "https://cloud.example.com/call/abc123")

REST API

curl -X POST https://chamade.io/api/call \
  -H "X-API-Key: chmd_..." \
  -H "Content-Type: application/json" \
  -d '{"platform": "nctalk", "meeting_url": "https://cloud.example.com/call/abc123"}'

The meeting_url is the Talk room URL from your Nextcloud instance. You can find it in your browser's address bar when inside a Talk conversation.

Disconnect

To disconnect your Nextcloud instance:

Go to your Dashboard → Platforms

Click "Disconnect" on the Nextcloud Talk card

This removes the connection from Chamade and deletes the bot user from your Nextcloud instance. You can reconnect at any time.

Message limits & formatting

Max length	32,000 characters (configurable per instance)
Formatting	Markdown — `bold`, `italic`, `code`, ```code blocks```, links

Manual install (fallback)

If the App Store is unreachable from your instance (air-gapped deployment, network restrictions, store downtime), you can install Chamade for Talk v2.2.5 by hand from a signed archive we host for you.

Nextcloud AIO (Docker)

# Download the addon
curl -Lo /tmp/chamade_talk.tar.gz https://chamade.io/static/chamade_talk-2.2.5.tar.gz

# Copy into container and extract
docker cp /tmp/chamade_talk.tar.gz nextcloud-aio-nextcloud:/tmp/
docker exec nextcloud-aio-nextcloud bash -c \
  "tar xzf /tmp/chamade_talk.tar.gz -C /var/www/html/custom_apps/ && rm /tmp/chamade_talk.tar.gz"

# Fix permissions and enable
docker exec nextcloud-aio-nextcloud chown -R www-data:www-data /var/www/html/custom_apps/chamade_talk
docker exec -u www-data nextcloud-aio-nextcloud php occ app:enable chamade_talk

Standard Nextcloud (bare metal)

# Download and extract into apps directory
curl -Lo /tmp/chamade_talk.tar.gz https://chamade.io/static/chamade_talk-2.2.5.tar.gz
tar xzf /tmp/chamade_talk.tar.gz -C /var/www/nextcloud/apps/

# Fix permissions and enable
chown -R www-data:www-data /var/www/nextcloud/apps/chamade_talk
sudo -u www-data php /var/www/nextcloud/occ app:enable chamade_talk

For future upgrades, always prefer the App Store path — it handles signature checks and upgrade migrations automatically.