Webhooks en meldingen in Slack, Microsoft Teams of Discord
Met Pro en Team stuur je via Dashboard > Integraties Pandafile-gebeurtenissen naar een kanaal in Slack, Microsoft Teams of Discord, of als ondertekende webhook naar je eigen server. Kies de gebeurtenissen, verstuur een test en bekijk het afleverlogboek.
Met Pro en Team laat Pandafile je andere tools meteen weten wanneer er iets gebeurt: met een bericht in een kanaal in Slack, Microsoft Teams of Discord, of met een webhook, een ondertekend HTTPS-verzoek naar je eigen server.
Gebeurtenissen die je kunt kiezen
- Overdracht klaar: de upload is klaar en de link werkt.
- Overdracht gedownload: één keer per ontvanger, de eerste keer. Je kunt ook kiezen voor elke download.
- Overdracht verlopen.
- Goedkeuring of wijzigingsverzoek van een ontvanger.
- Upload naar een van je bestandsverzoeken.
- Document door iedereen ondertekend, voor Pandafile Sign.
Een integratie toevoegen
- Maak in Slack, Microsoft Teams of Discord een inkomende webhook voor het kanaal en kopieer de URL. Gebruik voor je eigen systeem een HTTPS-adres op je server.
- Log in bij Pandafile en open Dashboard > Integraties.
- Kies onder Integratie toevoegen het type, plak de URL, geef er eventueel een naam aan en vink de gebeurtenissen aan die je wilt.
- Druk op Integratie toevoegen en daarna op Testgebeurtenis versturen om te controleren of die aankomt.
Je kunt maximaal 5 integraties hebben. Chatberichten worden geschreven in de taal van je account.
Webhooks voor ontwikkelaars
- Elke aflevering is een JSON-POST met het type gebeurtenis, een id en de details: id's, titels, links, aantallen en de e-mailadressen van ontvangers. Er staan nooit bestandsinhoud, wachtwoorden of persoonlijke downloadlinks in.
- Elk verzoek heeft een Pandafile-Signature-header met een tijdstempel (t) en een HMAC-SHA256-handtekening (v1) over tijdstempel en body, gemaakt met je ondertekeningsgeheim. Het geheim begint met whsec_ en wordt maar één keer getoond.
- Nieuw geheim maakt een nieuw ondertekeningsgeheim. Het oude blijft nog 24 uur werken, zodat je kunt overstappen zonder gebeurtenissen te missen.
- Antwoord binnen 10 seconden met een 2xx-status. Anders proberen we het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2 uur en 12 uur.
- Het afleverlogboek toont de laatste 50 afleveringen van elke integratie met hun resultaat.
Teams, testmodus en Zapier
In een team beheert iedereen zijn eigen integraties en krijgt hij alleen gebeurtenissen over zijn eigen overdrachten. Gebeurtenissen over testoverdrachten met een test-API-sleutel gaan naar webhooks met livemode op false, nooit naar Slack, Teams of Discord. Zapier en Make koppelen via de Pandafile-API en verschijnen onder API-abonnementen.