# Integrations

> Sending what happens in the room elsewhere (Discord, spreadsheets, lights) through Zapier, Make or IFTTT, with the plugins' webhooks.

Page: https://docs.rpgdesk.com/en/mestres/integracoes/

A sheet or table can send data out of RPG Desk: announce a roll in a Discord channel, log XP in a spreadsheet, change the color of the room’s lights. It does so through **webhooks**, and only through **Zapier**, **Make** or **IFTTT**: the plugin chooses what it sends, and you choose where it goes.

The plugin must declare its webhooks. When you install it, the dialog lists them: “It can send data outside, through the webhooks you register later in Integrations”.

## Connect a webhook

1. In the service (Zapier, Make or IFTTT), create the automation with a webhook trigger and copy its address:

   - **Zapier:** the “Catch Hook” trigger from Webhooks by Zapier: `https://hooks.zapier.com/hooks/catch/…`;
   - **Make:** the scenario’s webhook module: `https://hook.<region>.make.com/…`;
   - **IFTTT:** Webhooks: `https://maker.ifttt.com/trigger/<event>/json/with/key/<key>`.

2. In RPG Desk, in **Room settings → Plugins**, click **Integrations** on the plugin.

3. Paste the address into the webhook, choose **Who can trigger** it (**GMs only** or **Everyone**) and click **Save**.

*Screenshot:* A plugin's Integrations screen: the rolls webhook, with the Zapier address pasted, Who can trigger set to Everyone, the Save and Remove buttons and the On status.

- The address stays on the server only: players do not see it, and the plugin does not choose the destination, only the webhook’s name.
- **Remove** turns the webhook off. Without an address, the plugin sends nothing.
- **Latest sends** shows what was sent, by whom, and whether it worked.

## What reaches the service

Each send is a `POST` with JSON like this:

```json
{
  "plugin": "br.rpgdesk.example.integration",
  "webhook": "rolls",
  "room": { "id": "…", "name": "The Crypt of Valdren" },
  "user": { "id": "…", "nick": "Luana" },
  "sentAt": "2026-10-17T20:15:00.000Z",
  "data": { "total": 17 }
}
```

The plugin’s data comes in `data`; RPG Desk adds the rest. On IFTTT without `/json` in the address, only three values go: `value1` (the webhook’s name), `value2` (the nickname of whoever triggered it) and `value3` (the data, as JSON).

> **Limits**
>
> Up to 30 sends per minute in each room, with up to 16 KB of data each. The service has 10 seconds to answer.

Want your sheet to send something? See [Webhooks on the sheet](https://docs.rpgdesk.com/en/fichas/webhooks/).