Webhooky a upozornění ve Slacku, Microsoft Teams nebo Discordu
V Pro a Team otevřete Přehled > Integrace a posílejte události z Pandafile do kanálu ve Slacku, Microsoft Teams nebo Discordu, nebo na vlastní server jako podepsaný webhook. Vyberte události, pošlete test a zkontrolujte protokol doručení.
V Pro a Team umí Pandafile dát vědět vašim dalším nástrojům, jakmile se něco stane: zprávou v kanálu ve Slacku, Microsoft Teams nebo Discordu, nebo webhookem, tedy podepsaným HTTPS požadavkem na váš server.
Události, které můžete vybrat
- Přenos připraven: nahrávání skončilo a odkaz funguje.
- Přenos stažen: jednou za příjemce, poprvé. Místo toho můžete zvolit každé stažení.
- Přenos vypršel.
- Schválení nebo žádost o změny od příjemce.
- Nahrání do některé z vašich žádostí o soubory.
- Dokument podepsali všichni (Pandafile Sign).
Přidání integrace
- Ve Slacku, Microsoft Teams nebo Discordu vytvořte pro kanál příchozí webhook a zkopírujte jeho URL. Pro vlastní systém použijte HTTPS adresu na svém serveru.
- Přihlaste se do Pandafile a otevřete Přehled > Integrace.
- V sekci Přidat integraci vyberte typ, vložte URL, případně doplňte název a zaškrtněte požadované události.
- Klikněte na Přidat integraci a potom na Odeslat testovací událost, abyste ověřili, že dorazí.
Integrací můžete mít nejvýš 5. Zprávy do chatu se píšou v jazyce vašeho účtu.
Webhooky pro vývojáře
- Každé doručení je JSON POST s typem události, identifikátorem a podrobnostmi: identifikátory, názvy, odkazy, počty a e-mailové adresy příjemců. Nikdy neobsahuje obsah souborů, hesla ani osobní odkazy ke stažení.
- Každý požadavek má hlavičku Pandafile-Signature s časovým razítkem (t) a podpisem HMAC-SHA256 (v1) časového razítka a těla, vytvořeným vaším podpisovým klíčem. Klíč začíná na whsec_ a zobrazí se jen jednou.
- Nový klíč vytvoří nový podpisový klíč. Starý funguje ještě 24 hodin, takže můžete přejít bez ztráty událostí.
- Odpovězte stavem 2xx do 10 sekund. Jinak to zkusíme znovu po 1 minutě, 5 minutách, 30 minutách, 2 hodinách a 12 hodinách.
- Protokol doručení ukazuje posledních 50 doručení každé integrace a jejich výsledek.
Týmy, testovací režim a Zapier
V týmu si každý spravuje vlastní integrace a dostává události jen o svých přenosech. Události o testovacích přenosech vytvořených testovacím API klíčem chodí do webhooků s livemode nastaveným na false, nikdy do Slacku, Teams ani Discordu. Zapier a Make se připojují přes API Pandafile a zobrazují se v sekci Odběry přes API.