Webhook e notifiche su Slack, Microsoft Teams o Discord
Con Pro e Team apri Dashboard > Integrazioni per inviare gli eventi di Pandafile a un canale Slack, Microsoft Teams o Discord, oppure al tuo server come webhook firmato. Scegli gli eventi, invia una prova e controlla il registro consegne.
Con Pro e Team, Pandafile può avvisare i tuoi altri strumenti nel momento in cui succede qualcosa: un messaggio in un canale Slack, Microsoft Teams o Discord, oppure un webhook, cioè una richiesta HTTPS firmata verso il tuo server.
Gli eventi che puoi scegliere
- Trasferimento pronto: il caricamento è finito e il link funziona.
- Trasferimento scaricato: una volta per destinatario, la prima volta. Puoi scegliere invece ogni download.
- Trasferimento scaduto.
- Approvazione o richiesta di modifiche da parte di un destinatario.
- Caricamento in una delle tue richieste di file.
- Documento firmato da tutti, per Pandafile Sign.
Aggiungi un'integrazione
- In Slack, Microsoft Teams o Discord crea un webhook in entrata per il canale e copia il suo URL. Per il tuo sistema usa un indirizzo HTTPS sul tuo server.
- Accedi a Pandafile e apri Dashboard > Integrazioni.
- In Aggiungi un'integrazione scegli il tipo, incolla l'URL, aggiungi un nome se vuoi e seleziona gli eventi che ti interessano.
- Premi Aggiungi integrazione, poi Invia evento di prova per controllare che arrivi.
Puoi avere fino a 5 integrazioni. I messaggi in chat sono scritti nella lingua del tuo account.
Webhook per sviluppatori
- Ogni consegna è un POST JSON con il tipo di evento, un id e i dettagli: id, titoli, link, contatori e indirizzi email dei destinatari. Non contiene mai il contenuto dei file, password o link di download personali.
- Ogni richiesta ha un header Pandafile-Signature con un timestamp (t) e una firma HMAC-SHA256 (v1) di timestamp e corpo, calcolata con il tuo segreto di firma. Il segreto inizia con whsec_ e viene mostrato una sola volta.
- Nuovo segreto crea un nuovo segreto di firma. Quello vecchio resta valido per 24 ore, così puoi passare al nuovo senza perdere eventi.
- Rispondi con uno stato 2xx entro 10 secondi. Altrimenti riproviamo dopo 1 minuto, 5 minuti, 30 minuti, 2 ore e 12 ore.
- Il registro consegne mostra le ultime 50 consegne di ogni integrazione e il loro esito.
Team, modalità test e Zapier
In un team ognuno gestisce le proprie integrazioni e riceve solo gli eventi dei propri trasferimenti. Gli eventi dei trasferimenti di prova creati con una chiave API di test arrivano ai webhook con livemode impostato su false, mai a Slack, Teams o Discord. Zapier e Make si collegano tramite l'API di Pandafile e compaiono in Iscrizioni API.