Discord and Telegram alerts from the campaign

Connect the Discord webhook and the group's Telegram bot: what from the table reaches the channel, from which view and how to test it works.

If your group lives on Discord or Telegram, the campaign can send what happens at the table there so nobody misses a session. With Discord you use a webhook for the channel you choose and decide what from the table goes in and from which point of view. With Telegram you connect your group's bot for session notices and, if you want, what is written in the channels. Everything is set up in a single chapter of the campaign.

Where to find it

The GM room, Settings section, Table etiquette chapter. The three settings for this topic come one after another, after the social contract and the safety tools: Discord webhook, What goes to the Discord channel and Telegram notices.

Requirements and permissions

The Discord webhook and its options are configured by the owner and the co-GMs.
The Telegram notice is only seen and changed by the campaign owner (or an administrator), because the bot address carries its token.
Sending is always done by the server, not by your browser.
To use Discord you need permission to create webhooks in the channel. For Telegram, a bot of your own (see Telegram notices).

Step by step

Connect Discord

In Discord, open the channel settings, go to Integrations and create a new webhook. Copy its address.
In Table etiquette, paste the address into Discord webhook. It must start with https://discord.com/api/webhooks/.
If it is valid, the field says "Webhook looks right". If you pasted the server invitation link, it warns you that it is not a webhook.
In What goes to the Discord channel tick what from the table you want to reach the channel.
Choose the view: As a player or As GM.

Connect Telegram

Create your bot and add it to the group (the full procedure is in Telegram notices).
In Telegram notices, paste the address in this form: https://api.telegram.org/bot<token>/sendMessage?chat_id=<id>.
When it is valid the Send a test message button appears. Press it: a message should reach the group.
If you also want channel messages to arrive, turn on "Also send what is written in the channels" and choose which channels and what kind of messages.

Examples

A group that organises meet-ups on Discord: paste the webhook and leave only Game alerts ticked. Reminders for scheduled sessions arrive in the channel.
A table that wants a record of the game on Discord: also tick Chat messages and Rolls, with the view set to player.
A Telegram group that wants to read the story: turn on the channels option, tick the story channel and leave both message types on.

Options

Discord

Option	What it sends to the channel	Default
Game alerts	Notices of a scheduled session and of it starting.	Ticked
Chat messages	The dialogue and narration messages of the table chat.	Unticked
Rolls	Skill check, attack, initiative rolls…	Unticked
Saves and damage	Saving throws and damage.	Unticked
Images shown	The images and plates you show as GM.	Unticked

The view decides what face it goes out with. With As a player, "Posts exactly what a player sees: no secret rolls, no hidden names, AC or health." With As GM, "Anyone reading that Discord channel will see what is hidden: real names, AC and secret rolls." The default view is the player one.

Option	What it does	Default
Telegram notices	The address of your group's bot. It receives the upcoming session notices.	Empty
Channels to send	Which channels reach the group. With none ticked, all story channels go out, except out-of-character chat.	All story channels
Which messages	Whether the characters' dialogue, the GM's narration or both go out.	Both

A hidden channel, or one limited to certain players, never goes out to Telegram.

Tips

Tip. Start with just the game notices. Add chat or rolls when you see your group's channel appreciates it.

Tip. Always test with the Telegram test message button before the session.

Known limits

Discord and Telegram receive what happens in Roliando; it is not a two-way bridge.
If Discord or Telegram do not respond, the app keeps working: the notice simply does not go out.
Each campaign has a single Discord webhook and a single Telegram address.
Personal alerts to your own Telegram are set up in your settings, not here (see Telegram notices).

Common problems

"I paste the webhook and it says it is not one." It has to start with https://discord.com/api/webhooks/. If you pasted the server invitation link, it will not work: copy the webhook address from the channel settings.

"Telegram says the group is missing." Add ?chat_id=<id> at the end of the address.

"The test message fails." Telegram did not accept the message: check the bot token and that the bot is inside the group.

"Things the players should not see show up on Discord." Look at the view: with the GM view, real names, AC and secret rolls are visible. Change it to the player one.

"I do not see the Telegram field." Only the campaign owner sees it.