# Integrações

> Mandar o que acontece na mesa para fora (Discord, planilhas, luzes) pelo Zapier, pelo Make ou pelo IFTTT, com os webhooks dos plugins.

Página: https://docs.rpgdesk.com/mestres/integracoes/

Uma ficha ou tabela pode mandar dados para fora do RPG Desk: avisar uma rolagem num canal do Discord, anotar o XP numa planilha, mudar a cor das luzes da sala. Ela faz isso por **webhooks**, e só pelo **Zapier**, pelo **Make** ou pelo **IFTTT**: o plugin escolhe o que manda, e você escolhe para onde.

O plugin precisa declarar os webhooks dele. Ao instalar, o diálogo avisa quais são: “Pode mandar dados para fora, pelos webhooks que você cadastrar depois em Integrações”.

## Ligar um webhook

1. No serviço (Zapier, Make ou IFTTT), crie a automação com um gatilho de webhook e copie o endereço dele:

   - **Zapier:** o gatilho “Catch Hook” do Webhooks by Zapier: `https://hooks.zapier.com/hooks/catch/…`;
   - **Make:** o módulo de webhook do cenário: `https://hook.<região>.make.com/…`;
   - **IFTTT:** o Webhooks: `https://maker.ifttt.com/trigger/<evento>/json/with/key/<chave>`.

2. No RPG Desk, em **Configurações da mesa → Plugins**, clique em **Integrações** no plugin.

3. Cole o endereço no webhook, escolha **Quem pode disparar** (**Só mestres** ou **Todos**) e clique em **Salvar**.

*Captura de tela:* A tela Integrações de um plugin: o webhook rolagens, com o endereço do Zapier colado, Quem pode disparar em Todos, os botões Salvar e Remover e o estado Ligado.

- O endereço fica só no servidor: os jogadores não o veem, e o plugin não escolhe o destino, só o nome do webhook.
- **Remover** desliga o webhook. Sem endereço, o plugin não manda nada.
- **Últimos envios** mostra o que foi mandado, por quem, e se deu certo.

## O que chega no serviço

Cada envio é um `POST` com um JSON assim:

```json
{
  "plugin": "br.rpgdesk.exemplo.integracao",
  "webhook": "rolagens",
  "room": { "id": "…", "name": "A Cripta de Valdren" },
  "user": { "id": "…", "nick": "Luana" },
  "sentAt": "2026-10-17T20:15:00.000Z",
  "data": { "total": 17 }
}
```

Os dados do plugin vêm em `data`; o resto, o RPG Desk põe. No IFTTT sem o `/json` no endereço, vão só três valores: `value1` (o nome do webhook), `value2` (o apelido de quem disparou) e `value3` (os dados, em JSON).

> **Limites**
>
> Até 30 envios por minuto em cada mesa, com até 16 KB de dados cada. O serviço tem 10 segundos para responder.

Quer que a sua ficha mande algo? Veja [Webhooks na ficha](https://docs.rpgdesk.com/fichas/webhooks/).