Webhookok és értesítések Slackben, Microsoft Teamsben vagy Discordon
Pro és Team csomagban az Irányítópult > Integrációk menüben küldheted a Pandafile eseményeit egy Slack-, Microsoft Teams- vagy Discord-csatornára, vagy aláírt webhookként a saját szerveredre. Válaszd ki az eseményeket, küldj tesztet, és nézd meg a kézbesítési naplót.
Pro és Team csomagban a Pandafile azonnal szól a többi eszközödnek, ha valami történik: üzenetet küld egy Slack-, Microsoft Teams- vagy Discord-csatornára, vagy webhookot, azaz egy aláírt HTTPS-kérést a saját szerveredre.
Választható események
- Küldés elkészült: a feltöltés befejeződött, és a link működik.
- Küldés letöltve: címzettenként egyszer, az első alkalommal. Választhatod helyette az összes letöltést is.
- Küldés lejárt.
- Jóváhagyás vagy módosítási kérés egy címzettől.
- Feltöltés valamelyik fájlkérésedre.
- A dokumentumot mindenki aláírta – a Pandafile Signhoz.
Integráció hozzáadása
- Slackben, Microsoft Teamsben vagy Discordon hozz létre egy bejövő webhookot a csatornához, és másold ki az URL-jét. Saját rendszerhez használj egy HTTPS-címet a szervereden.
- Jelentkezz be a Pandafile-ba, és nyisd meg az Irányítópult > Integrációk menüt.
- Az Integráció hozzáadása résznél válaszd ki a típust, illeszd be az URL-t, ha szeretnéd, adj neki nevet, és jelöld be a kívánt eseményeket.
- Nyomd meg az Integráció hozzáadása gombot, majd a Tesztesemény küldése gombot, hogy lásd, megérkezik-e.
Legfeljebb 5 integrációd lehet. A chatüzenetek a fiókod nyelvén íródnak.
Webhookok fejlesztőknek
- Minden kézbesítés egy JSON POST az esemény típusával, egy azonosítóval és a részletekkel: azonosítók, címek, linkek, darabszámok és a címzettek e-mail-címei. Soha nincs benne fájltartalom, jelszó vagy személyes letöltési link.
- Minden kérésben van egy Pandafile-Signature fejléc egy időbélyeggel (t) és az időbélyeg és a törzs HMAC-SHA256 aláírásával (v1), amely az aláírási titkoddal készül. A titok whsec_ előtaggal kezdődik, és csak egyszer jelenik meg.
- Az Új titok gomb új aláírási titkot hoz létre. A régi még 24 óráig működik, így esemény elvesztése nélkül válthatsz.
- Válaszolj 2xx státusszal 10 másodpercen belül. Ha nem, újra próbáljuk 1 perc, 5 perc, 30 perc, 2 óra és 12 óra után.
- A kézbesítési napló minden integrációnál az utolsó 50 kézbesítést és azok eredményét mutatja.
Csapatok, tesztmód és Zapier
Egy csapatban mindenki a saját integrációit kezeli, és csak a saját küldéseiről kap eseményeket. A teszt API-kulccsal készült tesztküldésekről szóló események livemode = false értékkel mennek a webhookokra, Slackbe, Teamsbe vagy Discordra soha. A Zapier és a Make a Pandafile API-n keresztül kapcsolódik, és az API-feliratkozások között jelenik meg.