Simposys guide

Channels & teams

Create teams and channels, organise and moderate them, and connect them to email, webhooks and other organizations.

Create or join a team

A team gathers people around a subject and holds its channels. Whoever creates a team becomes its owner, and a “General” channel is created with it.

  1. In the left pane, click + next to Channels.
  2. Choose Create a team, type a Team name and click Create.
  3. To join an existing team, choose Join a team from the same + and type the Join code a team owner gave you — 10 characters such as ABCDE-FGHJK, with or without the hyphen, in capitals or not — then confirm. The window says “Checking the code…” and closes once you're in: you are a member and see the team's standard channels.
  4. If the code is wrong or has expired, the window stays open and says “Invalid or expired code.”; after five attempts in a short time it says “Too many attempts. Try again in N minutes.”, and you get one more attempt each minute.
  5. Click the team's name at the top of the left pane (or right-click it) to open its menu: it lists your teams, to move from one to another, and the commands of the chosen team — Configure team…, Create tag, Leave team and, with one of its shared channels open, Share with external people…
  6. Click a channel under Channels to open it.

Tip A team always keeps at least one owner: the last owner can't leave or be demoted while other members remain. Joining with a code works in the desktop app too; creating a team and the other actions here, for now, work only when you use Simposys in the browser.

Configure a team

Everything a team has — its description, channels, members, join code and activity — is gathered in one window with four sections. Every member can look; only owners can change things.

  1. Click the team's name at the top of the left pane and, under your teams, choose Configure team…
  2. In General, read the name and description; an owner changes them with Edit…
  3. In Channels, see the channels you can see; select one and click Open, or click Channels… to manage them.
  4. In Access, see the members and your role; an owner can Add members, change someone's Role… (Owner or Member) and Remove from team, and manages the Join code under How to join with Show the code, Copy, Regenerate and Revoke.
  5. A join code is valid for 7 days, and “Valid until …” beside it says until when. Regenerate makes a new code, valid 7 days from now, and the old one stops working; Revoke switches the code off, so nobody can join with a code. After a revoke, or once the code expires, you read No active code, and Generate code makes a new one. Copy puts the code on the clipboard, ready to give to whoever should join: the code lives only here.
  6. In Statistics, click Refresh to count messages, replies and active people in each channel you belong to.

Tip Owners manage members, roles, channels and the join code; members take part in the channels without management rights. Regenerate and Revoke take effect at once, without asking for confirmation. Join codes created before codes started to expire were all replaced: give people the new one.

Add and manage channels

A standard channel is open to the whole team; a private one only to the team members you pick; a shared one can also host people from other organizations. What kind a channel is is chosen when you create it and can't be changed later.

  1. Open Configure team…, go to Channels and click Channels…
  2. Click Add…, choose Standard, Private or Shared, and click Continue.
  3. Type the Channel name (it must be unique in the team); for a private or shared channel also tick its Members, then click Create.
  4. To change a channel, select it and click Edit (name and Description) or, for a private or shared channel, Members… to tick who can see it.
  5. Select a channel and click Leave to stop seeing a private channel, or Delete to remove it with all its messages for the whole team.

Tip Only owners add, edit and delete channels, and a team always keeps at least one channel. To stop seeing a standard channel without leaving the team, hide it from its ⋯ in the left pane. For now this works only when you use Simposys in the browser, not in the desktop app.

Reach a group with a tag

A tag is a named group of team members — for example everyone on call. Mentioning the tag in one of the team's channels notifies all its members at once.

  1. As a team owner, click the team's name at the top of the left pane and choose Create tag.
  2. Type the Tag name, tick its Members and confirm.
  3. In any channel of the team, type @ and the tag's name in the message box, pick it from the list and send.
  4. Open the details panel of a channel to see the TEAM TAGS; an owner uses Manage to change a tag's members or delete it.

Tip Everyone in the tag gets the mention in their Activity, just as if they had been mentioned by name. For now this works only when you use Simposys in the browser, not in the desktop app.

Moderate a channel's messages

In a team's channels, the team owner and the organization's administrators can remove a message someone else wrote — one that is offensive or posted in the wrong place, for example — as long as they are members of the channel. Editing a message always stays with its author.

  1. Point at someone else's message in the channel and click ⋯ in the quick actions bar.
  2. Choose Delete.
  3. The Delete message window reminds you that channel members will see “Deleted by a moderator”: click Delete to confirm, or Cancel (or press Esc) to keep the message.
  4. For everyone in the channel the message is replaced by “Deleted by a moderator”; a message deleted by its own author reads “This message was deleted” instead.

Tip Moderation exists only in team channels: in 1:1 and group chats, and in channels another organization shares with you, each person deletes only their own messages. Every message deleted by a moderator is recorded in the organization's Simposys log.

Write a post or an announcement

In a channel, a message can carry a subject in bold above the text — handy to open a discussion — or become an announcement with a headline on a coloured band, for news that matters to everyone.

  1. In a channel, click + in the message box toolbar and point at Post format.
  2. Choose Message (a plain message), Post with subject or Announcement.
  3. Type the subject — for an announcement, its headline — in the field that appears above the message box.
  4. Write the text and send.

Tip Post format appears in the + menu only in channels. A subject left empty sends an ordinary message.

Post in several channels at once

Send the same message to the channel you are in and to other channels you belong to, without copying it by hand.

  1. In a channel, click + in the message box toolbar and choose Post in multiple channels.
  2. Under Channels, tick the other channels that should receive the message, then click Done.
  3. While channels are picked, the + button stays lit.
  4. Write the message and send it: it appears in the current channel and in each channel you ticked.

Tip The choice applies to the next message only, and is cleared when you change conversation. For now this works only when you use Simposys in the browser, not in the desktop app.

Send email to a channel

A channel can have its own email address: an email sent there is posted in the channel, with its subject in bold. The address is long and random, so nobody can guess it. It works when your organization has set up the mail gateway that forwards messages to Simposys.

  1. As a team owner, open the channel and open the details panel.
  2. At the bottom of the panel, click Channel settings: the window opens on the Channel email section. Click Get email address.
  3. Click Copy and give the address to whoever should write to the channel.
  4. Click Regenerate to replace the address (the old one stops working), or Remove to switch it off.

Tip Only owners see the address. Treat it like a password: if it reaches the wrong people, regenerate it. Addresses created before they became long and random were all replaced by new ones, and the old ones no longer work: if you set one up earlier, click Get email address and copy the new one wherever the old one was used. An address that receives too many emails in a short time is slowed down, and an email too long for a chat message is refused.

Post from other systems with a webhook

A webhook is a web address that lets another system — a build server, a monitoring tool, a script — post messages in a channel. The address carries a random 32-character secret, so nobody can guess it.

  1. As a team owner, open the channel and open the details panel.
  2. At the bottom of the panel, click Channel settings and choose the Webhook section; click Get webhook URL, then Copy.
  3. Configure the other system to send an HTTP POST to that address with a JSON body such as {"title": "Build", "text": "All tests passed", "sender": "CI"} — only text is required.
  4. Each call appears in the channel as a message, with the title in bold and the sender as its author.
  5. Click Regenerate to replace the address, or Remove to switch the webhook off.

Tip Anyone who knows the address can post in the channel: keep it secret and regenerate it if it leaks. Webhooks created before their addresses became random were all replaced, and the old addresses no longer work: click Get webhook URL and copy the new one into the systems that post. A webhook called too often in a short time answers 429 Too Many Requests, with a Retry-After header saying how long to wait; a message that is too long is refused with 413.

See how active your channels are

The team's statistics count, for each channel you belong to, the messages, the replies and the people who wrote, and they live in the team configuration. Every member can see them — no special rights needed.

  1. Click the team's name at the top of the left pane and choose Configure team…
  2. Go to Statistics and click Refresh.
  3. Read, for each channel, the number of messages, replies and active people, with a bar that compares it with the busiest channel.
  4. When you reopen the section, the counts you already read are still there; Refresh updates them.

Tip Channels you are not a member of are never counted. For now this works only when you use Simposys in the browser, not in the desktop app.

Share a channel with another organization

A shared channel is a team channel that can host people from a different organization. They read and write in it, react, vote in polls, tick checklists, edit live tables and share files — but they never see the rest of your team: not its other channels, not its members, not who is online. A channel is shared the moment it is created, and cannot be shared afterwards: turning an ordinary channel into a shared one would change who can read a history that has already been written.

  1. Click the team's name at the top of the left pane, choose Configure team…, go to Channels and click Channels…
  2. Click Add…, choose Shared and click Continue.
  3. Type the Channel name, tick the team members who should be in it and click Create.
  4. Only team owners can do this.

Tip Everything a shared channel contains — messages, files, polls, live tables — lives with the organization that hosts it, never copied elsewhere. Guests are not team members: they see the channel and nothing else of the team.

Invite someone from outside

An invitation is a single-use code that you hand to one person, out of band — by email, by chat, in person. You label the invitation with the name of the person you are inviting, and that label becomes the name they appear under in the channel. The code is shown once and never again, because a spent code creates access across organizations; if you lose it, revoke the invitation and create another.

  1. Open the shared channel.
  2. Click the team's name at the top of the left pane and choose Share with external people… (or click Share with external people under EXTERNAL SHARING in the details panel).
  3. Type a label for the person you are inviting under New invite label, then click Apply.
  4. The code appears once, in the details panel: copy it and send it to them yourself.
  5. The same window lists pending invitations and external members: tick one and click Apply to revoke it.

Tip Revoking an external member takes effect immediately: their next action in the channel fails, and the channel disappears from their list. Revoking a pending invitation makes its code worthless.

Join a channel shared with you

When another organization shares a channel with you, paste the code you were given and the channel appears in the Shared channels section of the left pane, marked with the name of the organization that hosts it. Inside it you take part like any other member. Outside it you have no access to that organization at all.

  1. In the left pane, click + next to Channels and choose Join a shared channel.
  2. In Join a shared channel, paste the Invite code you were sent and click Join: the window stays open while the code is checked, and closes once you're in.
  3. If the code is wrong or has expired, the window says “Invalid or expired code.”; after too many attempts in a short time it says “Too many attempts. Try again in N minutes.”
  4. The channel appears under Shared channels.
  5. To leave, open the details panel and choose Leave shared channel.

Tip Some things are deliberately not available to you in a channel shared with you: you cannot schedule messages, manage members, see analytics, or configure the channel — those belong to the organization that hosts it. Presence dots are not shown for external members either: showing them would mean exposing the host organization's roster.

Back to the guide

Productivity, made in Italy.

Bring the whole suite to your team — simple, secure and entirely yours.