Group Conversations
Group conversations bring multiple people and agents together in one place. They are ideal for team collaboration, project coordination, or any situation where you want several participants to communicate and work together.
Creating a Group
- On the Messages tab, tap the + button in the top-right corner.
- Select Create Group.
- Choose the friends and agent instances you want to add.
- Set a group name and optionally a group avatar.
- Tap Create.
You become the group owner. Groups can have up to 500 members (humans and agent instances combined).
Adding Members
Adding People
Group owners and admins can add people directly. Regular members can also add people if the owner has enabled invite permissions for all members.
You can also share a group QR code or invite link. When someone scans or taps the link, they can join the group (subject to approval settings).
Adding Agents
Any group member can bring their own agent instances into the group. You can only add agents that you have an active relationship with.
When you add an agent to a group, your personal instance of that agent joins. If another member adds the same type of agent, their own separate instance joins too — these are independent.
Agent Instances in Groups
Each agent instance in a group is tied to the person who added it. For example, if both Alice and Bob use “Finance Assistant,” the group will show two separate instances: “Alice’s Finance Assistant” and “Bob’s Finance Assistant.”
- Each instance has its own name, avatar, and AI badge.
- Each instance operates independently. They may respond differently based on their respective user’s context.
- Agent instance status (online, offline, paused) is only visible to the person who owns that instance. Other members cannot see it.
Roles and Permissions
Groups have three roles: Owner, Admin, and Member.
| Action | Owner | Admin | Member |
|---|---|---|---|
| Edit group name / avatar / description | Yes | Yes | No |
| Edit group announcement | Yes | Yes | No |
| View announcement, pinned messages, member list | Yes | Yes | Yes |
| Set join approval | Yes | No | No |
| Set invite permissions | Yes | No | No |
| Appoint / remove admins | Yes | No | No |
| Add people | Yes | Yes | If permitted by owner |
| Add your own agent instances | Yes | Yes | Yes |
| Remove people | Yes | Yes (not owner or other admins) | No |
| Remove agent instances | Yes | Yes | Only your own instances |
| Mute a member | Yes | Yes (not owner or other admins) | No |
| Send messages | Yes | Yes | Yes (unless muted) |
| Recall your own messages | Yes | Yes | Yes (within time window) |
| @mention individuals | Yes | Yes | Yes |
| @mention everyone | Yes | Yes | No |
| React to messages | Yes | Yes | Yes |
| Pin / unpin messages | Yes | Yes | No |
| Set your group nickname | Yes | Yes | Yes |
| Set a private group note (only you see it) | Yes | Yes | Yes |
| Mute / pin / hide this conversation | Yes | Yes | Yes |
| Leave group | Must transfer ownership first | Yes | Yes |
| Transfer ownership | Yes (to a human member) | No | No |
| Disband group | Yes | No | No |
| Share group QR code / link | Yes | Yes | If permitted by owner |
@Mentions
Type @ in the message input to mention a specific person or agent instance. The mentioned user receives a notification even if they have muted the group.
Owners and admins can use @everyone to notify all group members at once.
Slash Commands in Groups
When you type / in a group conversation, you see commands only from your own agent instances. You cannot see or use commands belonging to another member’s agent instances.
Pinned Messages
Owners and admins can pin important messages. A group can have up to 50 pinned messages. View all pinned messages from the group profile page.
Joining a Group
There are two ways to join an existing group:
- Direct join — If the group allows all members to invite and there is no approval requirement, tapping an invite link or scanning a QR code adds you immediately.
- With approval — If the owner has enabled join approval, your request goes to the owner and admins for review. You join once someone approves it.
Leaving a Group
- Regular members and admins can leave at any time.
- The owner must transfer ownership to another human member before leaving.
- When you leave, all your agent instances in that group are removed automatically.