01
Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
Revolt
26 tools available
Revolt is a free and open-source chat platform offering secure and customizable communication.
Connect Revolt to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Revolt's 26 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Common workflows with Revolt
02
Daily summary
- Pull yesterday's activity
- Summarise with the model of your choice
- Send the digest via email or Slack
03
Cross-tool sync
- Read records from one app
- Transform with a persona
- Write the result back via this integration
Revolt actions 26
Every Revolt action below is a callable tool any Definable persona can invoke.
Acknowledge Policy Changes
Tool to acknowledge platform policy changes. Use when accepting or confirming policy updates for your bot account.
Add Reaction to Message
Tool to add a reaction to a message in a channel. Use when you want to react with an emoji to a specific message. Returns success on completion.
Block User
Tool to block another user by their ID. Use when you need to prevent interactions with a specific user.
Create Sync Settings
Tool to upload and save settings data to Revolt's sync storage. Use when you need to persist user settings or preferences.
Delete Message
Tool to delete a message you've sent or one you have permission to delete. Use when you need to remove a message from a channel.
Bulk Delete Messages
Tool to bulk delete multiple messages from a channel. Use when you need to delete multiple messages at once. Requires ManageMessages permission regardless of message ownership. Messages must have been sent within the past 1 week.
Fetch Owned Bots
Tool to fetch all bots that you have control over. Use when you need to retrieve information about bots owned by the authenticated user account.
Fetch Sync Settings
Tool to fetch settings from server filtered by keys. Returns an object with the requested keys where each value is a tuple of (timestamp, value). Only settings that exist on the server will be included in the response.
Fetch user
Tool to fetch detailed information about a user. Use when you have a valid user ID and need full account details. Call after authenticating with bot token.
Fetch User Flags
Tool to fetch flags associated with a specific user. Use after obtaining the user ID to inspect their special statuses or roles.
Get API Info
Tool to fetch the server configuration for this Revolt instance. Use when you need to discover API version, feature availability, WebSocket endpoints, or service URLs.
Get Channel
Tool to fetch a channel by its ID. Use when you need to retrieve detailed information about a specific channel.
Get Current User
Tool to retrieve your own user information. Use when you need to fetch details about the authenticated user account.
Get Invite
Tool to fetch detailed information about an invite by its code. Use when you have a valid invite code and need to retrieve invite details including server info, channel info, and member count.
Get Sync Unreads
Tool to fetch information about unread state on channels. Use when you need to check which channels have unread messages or mentions.
Get User Profile
Tool to retrieve a user's profile data including bio and background. Use when you need profile-specific information beyond basic user data. Will fail if you do not have permission to access the target user's profile.
Get User's Default Avatar
Tool to fetch a user's default avatar image based on their ID. Use when you need to retrieve the default avatar picture for a specific user.
Open DM with User
Tool to open a DM with another user. Use when you need to start or access a direct message conversation. If the target is oneself, returns a saved messages channel.
Get User DMs
Tool to fetch all direct message conversations for the authenticated user. Use when you need to list all DM and group DM channels.
Pin Message
Tool to pin a message in a channel by its ID. Use when you need to highlight important messages for channel members.
Remove Message Reaction
Tool to remove a reaction from a message. Use when you need to remove your own, someone else's, or all reactions of a given emoji from a message. Requires ManageMessages permission if removing others' reactions.
Send Channel Message
Tool to send a message to a Revolt channel. Use when you need to post a text message, embed, or attachment to a specific channel. Call after authenticating with bot token.
Unblock User
Tool to unblock another user by their ID. Use when you need to remove a block on a specific user. The relationship status will change from 'Blocked' to 'None' after successful execution.
Unpin Message
Tool to unpin a message in a channel. Use when you need to remove a pinned message from the channel's pinned messages list.
Update Channel Message
Tool to edit a message that you've previously sent in a channel. Use when you need to update the content or embeds of an existing message. At least one of content or embeds must be provided.
Update User
Tool to update user information. Use when you need to modify user profile or status fields. Call after authenticating with bot token.
2chat
2Chat provides a programmable API for integrating WhatsApp and other text channels, enabling developers to send and receive messages, manage groups, and automate workflows.
Dialmycalls
DialMyCalls provides a mass notification system enabling users to send voice and text messages to contacts.
Dialpad
Dialpad is a cloud-based business phone system and contact center platform that enables voice, video, messages and meetings across your existing devices
Google Chat
Google Chat API integration for messaging and collaboration in Google Workspace
Help Scout
Help Scout provides customer support software with shared inbox, knowledge base, and customer management tools
Heyy
Connect with your customers on Whatsapp, SMS, Messenger and Instagram using automation.
Frequently asked questions
What can I automate with Revolt on Definable?
Anything Revolt exposes through its API. Common communication workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 26 Revolt tools directly, then chain the result into another integration without you writing code.
How does Revolt authentication work?
Revolt uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the Revolt integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 26 Revolt tools. You only need a separate Revolt subscription if Revolt itself charges per seat or per API call.
Is using Revolt through Definable secure?
Every call from a persona to Revolt is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with Revolt on Definable?
Sign up for Definable, open the integrations page, find Revolt, and connect via OAuth or API key. You can immediately attach Revolt to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What Revolt actions does Definable expose?
Definable exposes all 26 Revolt actions as callable tools — including `Acknowledge Policy Changes`, `Add Reaction to Message`, `Block User`, plus 23 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with Revolt?
Wire it up in minutes. No coding required.