Platform Actions

Discord, Telegram, Slack, and WhatsApp moderation and management actions

What it does: Wraps the native moderation and management APIs of Discord, Telegram, Slack, and WhatsApp so agents can kick users, manage roles, pin messages, archive channels, change group settings, and more — all from inside a conversation.

Who it’s for: Agents that need to act as moderators or admins in a chat platform. These tools require both Comis tool policy (typically the group:platform_actions group) AND the underlying bot permissions on the platform itself. Granting Comis access does not bypass platform permissions; the bot must already have the relevant capability (e.g., “Kick Members” on Discord, group-admin status on Telegram or WhatsApp).

Quick Reference

Platform	Tool Name	Action count	Guide
Discord	discord_action	19	Discord Actions
Telegram	telegram_action	12	Telegram Actions
Slack	slack_action	12	Slack Actions
WhatsApp	whatsapp_action	11	WhatsApp Actions

All platform action tools follow the same pattern: call the tool with an action parameter specifying what to do, plus any additional parameters that action requires. The action set per platform reflects what each platform’s bot/API actually exposes — Slack and WhatsApp do not have direct equivalents of Discord’s role system, for example, and Telegram’s API is the only one that exposes native polls.

Auth and bot permissions

Each tool reads its credentials from the same place its channel adapter does. There is no separate auth surface for platform actions — if your bot is connected and can send messages, it can attempt platform actions, subject to the bot’s own platform permissions.

Tool	Reads credentials from	Bot must have
discord_action	DISCORD_BOT_TOKEN (same as the Discord adapter)	Server-side permissions per action: “Kick Members” for kick, “Ban Members” for ban, “Manage Roles” for role ops, “Manage Channels” for channel ops, “Manage Messages” for pin/unpin
telegram_action	TELEGRAM_BOT_TOKEN	Bot must be a chat administrator with the relevant rights for ban / promote / pin / set_title / set_description
slack_action	SLACK_BOT_TOKEN and SLACK_APP_TOKEN	Bot scopes per action: channels:manage, pins:write, channels:write.invites, channels:archive, bookmarks:write, etc. — configure in the Slack app’s OAuth & Permissions screen
whatsapp_action	Baileys auth dir (no env keys)	Bot must be a group admin for participant / settings / promote / demote ops

If a platform rejects the call (insufficient permission, missing scope, target not in scope), the tool returns a structured error with errorKind: "platform" and the platform’s error message. The action classifier also gates destructive actions (kick, ban, archive, channelDelete, group_leave) behind user confirmation via _confirmed: true.

Discord Actions

The discord_action tool provides actions for managing Discord servers, channels, threads, roles, and member moderation.

pin -- Pin a message

Pin a message to the current channel so it appears in the pinned messages list.

Parameter	Type	Required	Description
action	string	Yes	"pin"
message_id	string	Yes	The ID of the message to pin

unpin -- Unpin a message

Remove a message from the pinned messages list.

Parameter	Type	Required	Description
action	string	Yes	"unpin"
message_id	string	Yes	The ID of the message to unpin

kick -- Kick a member

Remove a member from the server. They can rejoin with a new invite.

Parameter	Type	Required	Description
action	string	Yes	"kick"
user_id	string	Yes	The Discord user ID to kick
reason	string	No	Reason for the kick (shown in audit log)

ban -- Ban a member

Ban a member from the server. They cannot rejoin until unbanned.

Parameter	Type	Required	Description
action	string	Yes	"ban"
user_id	string	Yes	The Discord user ID to ban
reason	string	No	Reason for the ban (shown in audit log)
delete_message_days	number	No	Number of days of message history to delete from the banned user (0-7)

unban -- Unban a member

Remove a ban, allowing the user to rejoin the server.

Parameter	Type	Required	Description
action	string	Yes	"unban"
user_id	string	Yes	The Discord user ID to unban

role_add -- Add a role to a member

Assign a role to a server member.

Parameter	Type	Required	Description
action	string	Yes	"role_add"
user_id	string	Yes	The Discord user ID
role_id	string	Yes	The role ID to assign

role_remove -- Remove a role from a member

Remove a role from a server member.

Parameter	Type	Required	Description
action	string	Yes	"role_remove"
user_id	string	Yes	The Discord user ID
role_id	string	Yes	The role ID to remove

set_topic -- Set channel topic

Update the topic text displayed at the top of a channel.

Parameter	Type	Required	Description
action	string	Yes	"set_topic"
topic	string	Yes	The new channel topic text

set_slowmode -- Set slowmode delay

Set the slowmode interval for the channel. When enabled, members can only send one message per interval.

Parameter	Type	Required	Description
action	string	Yes	"set_slowmode"
seconds	number	Yes	Slowmode interval in seconds (0 to disable)

guild_info -- Get server information

Retrieve information about the current Discord server, including name, member count, channels, and roles.

Parameter	Type	Required	Description
action	string	Yes	"guild_info"

channel_info -- Get channel information

Retrieve information about the current channel, including name, topic, type, and permissions.

Parameter	Type	Required	Description
action	string	Yes	"channel_info"

threadCreate -- Create a thread

Create a new thread in the current channel. Optionally create it from an existing message.

Parameter	Type	Required	Description
action	string	Yes	"threadCreate"
name	string	Yes	The thread name
message_id	string	No	Message ID to create the thread from (creates a thread attached to that message)
auto_archive_duration	number	No	Auto-archive duration in minutes (60, 1440, 4320, or 10080)

threadList -- List threads

List all threads in the current channel.

Parameter	Type	Required	Description
action	string	Yes	"threadList"

threadReply -- Reply in a thread

Send a message to a specific thread.

Parameter	Type	Required	Description
action	string	Yes	"threadReply"
thread_id	string	Yes	The thread ID to reply in
text	string	Yes	The message text to send

channelCreate -- Create a channel

Create a new channel in the server.

Parameter	Type	Required	Description
action	string	Yes	"channelCreate"
name	string	Yes	The channel name
type	string	Yes	Channel type: "text", "voice", "category", "announcement", "forum", or "stage"
parent_id	string	No	Parent category ID to create the channel under
position	number	No	Position of the channel in the channel list

channelEdit -- Edit channel settings

Modify the settings of an existing channel.

Parameter	Type	Required	Description
action	string	Yes	"channelEdit"
name	string	No	New channel name
topic	string	No	New channel topic

channelDelete -- Delete a channel

Delete the current channel. This action is irreversible.

Parameter	Type	Required	Description
action	string	Yes	"channelDelete"

Channel deletion is permanent. All messages and history in the channel will be lost.

channelMove -- Move channel to a category

Move a channel to a different category in the server.

Parameter	Type	Required	Description
action	string	Yes	"channelMove"
category_id	string	Yes	The category ID to move the channel to

setPresence -- Set bot presence

Update the bot’s online status and activity message.

Parameter	Type	Required	Description
action	string	Yes	"setPresence"
status_text	string	Yes	Bot status text displayed under the bot’s name
activity_type	string	No	Activity type: "playing", "watching", "listening", or "competing"

Telegram Actions

The telegram_action tool provides actions for managing Telegram groups and channels.

pin -- Pin a message

Pin a message in the chat so it appears at the top.

Parameter	Type	Required	Description
action	string	Yes	"pin"
message_id	string	Yes	The message ID to pin

unpin -- Unpin a message

Remove a pinned message.

Parameter	Type	Required	Description
action	string	Yes	"unpin"
message_id	string	Yes	The message ID to unpin

poll -- Create a poll

Create a poll in the chat for members to vote on.

Parameter	Type	Required	Description
action	string	Yes	"poll"
question	string	Yes	The poll question
options	array	Yes	Array of answer options (strings)

sticker -- Send a sticker

Send a sticker to the chat.

Parameter	Type	Required	Description
action	string	Yes	"sticker"
sticker_id	string	Yes	The sticker file ID

chat_info -- Get chat information

Retrieve information about the current chat, including name, type, and member count.

Parameter	Type	Required	Description
action	string	Yes	"chat_info"

member_count -- Get member count

Get the number of members in the current chat.

Parameter	Type	Required	Description
action	string	Yes	"member_count"

get_admins -- List administrators

List all administrators in the current chat with their permissions.

Parameter	Type	Required	Description
action	string	Yes	"get_admins"

set_title -- Set chat title

Change the title of the group or channel.

Parameter	Type	Required	Description
action	string	Yes	"set_title"
title	string	Yes	The new chat title

set_description -- Set chat description

Update the description of the group or channel.

Parameter	Type	Required	Description
action	string	Yes	"set_description"
description	string	Yes	The new chat description

ban -- Ban a user

Ban a user from the chat. They cannot rejoin until unbanned.

Parameter	Type	Required	Description
action	string	Yes	"ban"
user_id	string	Yes	The Telegram user ID to ban

unban -- Unban a user

Remove a ban, allowing the user to rejoin the chat.

Parameter	Type	Required	Description
action	string	Yes	"unban"
user_id	string	Yes	The Telegram user ID to unban

promote -- Promote to admin

Promote a user to administrator with specified permissions.

Parameter	Type	Required	Description
action	string	Yes	"promote"
user_id	string	Yes	The Telegram user ID to promote
rights	object	No	Admin rights object specifying permissions to grant (if omitted, grants default admin permissions)

Slack Actions

The slack_action tool provides actions for managing Slack workspaces and channels.

pin -- Pin a message

Pin a message in the channel.

Parameter	Type	Required	Description
action	string	Yes	"pin"
message_id	string	Yes	The message timestamp (Slack’s message ID)

unpin -- Unpin a message

Remove a pinned message.

Parameter	Type	Required	Description
action	string	Yes	"unpin"
message_id	string	Yes	The message timestamp to unpin

set_topic -- Set channel topic

Update the channel topic displayed at the top of the channel.

Parameter	Type	Required	Description
action	string	Yes	"set_topic"
topic	string	Yes	The new channel topic

set_purpose -- Set channel purpose

Update the channel’s purpose description.

Parameter	Type	Required	Description
action	string	Yes	"set_purpose"
purpose	string	Yes	The new channel purpose

archive -- Archive a channel

Archive a channel. Archived channels are read-only and hidden from the channel list.

Parameter	Type	Required	Description
action	string	Yes	"archive"

unarchive -- Unarchive a channel

Restore an archived channel to active status.

Parameter	Type	Required	Description
action	string	Yes	"unarchive"

create_channel -- Create a channel

Create a new Slack channel.

Parameter	Type	Required	Description
action	string	Yes	"create_channel"
name	string	Yes	The channel name (lowercase, no spaces)
is_private	boolean	No	Whether the channel is private (defaults to public)

invite -- Invite users to channel

Invite one or more users to join the current channel.

Parameter	Type	Required	Description
action	string	Yes	"invite"
user_ids	array	Yes	Array of Slack user IDs to invite

kick -- Remove a user from channel

Remove a user from the current channel.

Parameter	Type	Required	Description
action	string	Yes	"kick"
user_id	string	Yes	The Slack user ID to remove

channel_info -- Get channel information

Retrieve detailed information about the current channel.

Parameter	Type	Required	Description
action	string	Yes	"channel_info"

members_list -- List channel members

List all members of the current channel.

Parameter	Type	Required	Description
action	string	Yes	"members_list"
limit	number	No	Maximum number of members to return

bookmark_add -- Add a bookmark

Add a bookmark link to the channel’s bookmarks bar.

Parameter	Type	Required	Description
action	string	Yes	"bookmark_add"
title	string	Yes	The bookmark display name
link	string	Yes	The URL to bookmark

WhatsApp Actions

The whatsapp_action tool provides actions for managing WhatsApp groups.

group_info -- Get group information

Retrieve information about the current WhatsApp group, including name, description, and participants.

Parameter	Type	Required	Description
action	string	Yes	"group_info"

group_update_subject -- Change group name

Update the group name (subject).

Parameter	Type	Required	Description
action	string	Yes	"group_update_subject"
subject	string	Yes	The new group name

group_update_description -- Change group description

Update the group description text.

Parameter	Type	Required	Description
action	string	Yes	"group_update_description"
description	string	Yes	The new group description

group_participants_add -- Add participants

Add new members to the group.

Parameter	Type	Required	Description
action	string	Yes	"group_participants_add"
participant_jids	array	Yes	Array of participant JIDs to add (e.g., ["[e-mail]"])

group_participants_remove -- Remove participants

Remove members from the group.

Parameter	Type	Required	Description
action	string	Yes	"group_participants_remove"
participant_jids	array	Yes	Array of participant JIDs to remove

group_promote -- Promote to admin

Promote participants to group admin status.

Parameter	Type	Required	Description
action	string	Yes	"group_promote"
participant_jids	array	Yes	Array of participant JIDs to promote

group_demote -- Demote from admin

Revoke admin status from participants, returning them to regular member status.

Parameter	Type	Required	Description
action	string	Yes	"group_demote"
participant_jids	array	Yes	Array of participant JIDs to demote

group_settings -- Update group settings

Change group-wide settings that control who can send messages and edit group info.

Parameter	Type	Required	Description
action	string	Yes	"group_settings"
setting	string	Yes	One of: "announcement" (only admins can send messages), "not_announcement" (everyone can send), "locked" (only admins can edit group info), "unlocked" (everyone can edit)

group_invite_code -- Get invite link

Retrieve the group’s invite link that can be shared to add new members.

Parameter	Type	Required	Description
action	string	Yes	"group_invite_code"

profile_status -- Update bot profile status

Update the bot’s WhatsApp profile status message.

Parameter	Type	Required	Description
action	string	Yes	"profile_status"
status_text	string	Yes	The new profile status text

group_leave -- Leave a group

Have the bot leave the current group. This action is irreversible — the bot must be re-invited to rejoin.

Parameter	Type	Required	Description
action	string	Yes	"group_leave"

Leaving a group is permanent. The bot must be added back by a group admin to rejoin.

Permissions and Trust

Platform actions require appropriate bot permissions on each platform. For example:

• Discord — Kick and ban require the bot to have the “Kick Members” and “Ban Members” permissions in the server settings. Role management requires “Manage Roles.”
• Telegram — Ban, promote, and group management actions require the bot to be an administrator with the relevant permissions.
• Slack — Channel management actions require appropriate bot scopes (like channels:manage, chat:write) configured in the Slack app settings.
• WhatsApp — Group management actions require the bot to be a group admin.

Platform actions are part of the group:platform_actions tool group and can be restricted through Tool Policy. By default, they are available in the full profile but not in restricted profiles like minimal or coding.

If a platform action fails with a permissions error, check that your bot has the required permissions on that platform. The error message will typically indicate which permission is missing.

End-to-end example: auto-pin first message of the day

A community-management workflow: at the start of each day, the agent finds the first user message in a channel and pins it as a “today’s kickoff” anchor. This combines cron, the message tool’s fetch action, and a platform action pin call.

You: Every weekday at 8am Eastern, find the first message posted in
     #general after midnight today and pin it.

The agent registers a cron job:

tool: cron
action: add
name: pin-first-message-of-day
schedule_kind: cron
schedule_expr: "0 8 * * 1-5"
timezone: America/New_York
payload_kind: agent_turn
payload_text: >
  Find the first message posted in #general today (after midnight in
  America/New_York). Pin it using discord_action. If there are no
  messages yet today, do nothing.

When the cron fires, the agent runs:

# 1. Fetch recent messages
tool: message
action: fetch
channel_type: discord
channel_id: "general"
limit: 100

The agent filters the fetched results client-side for the earliest message after the day boundary, then pins it:

# 2. Pin the first message
tool: discord_action
action: pin
message_id: "<id from step 1>"

If the bot lacks the “Manage Messages” permission, step 2 returns an error and the agent can post a notification asking the admin to grant the permission. For Telegram or Slack the same workflow swaps discord_action for telegram_action or slack_action — the action name pin is identical across all three.

Related

Discord Setup

Set up and configure your Discord bot

Telegram Setup

Set up and configure your Telegram bot

Slack Setup

Set up and configure your Slack bot

WhatsApp Setup

Set up and configure your WhatsApp connection