Integrações

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

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>.
No RPG Desk, em Configurações da mesa → Plugins, clique em Integrações no plugin.
Cole o endereço no webhook, escolha Quem pode disparar (Só mestres ou Todos) e clique em Salvar.

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:

{
  "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).

Quer que a sua ficha mande algo? Veja Webhooks na ficha.