Webhooks et notifications Slack, Microsoft Teams ou Discord
Avec Pro et Team, ouvre Tableau de bord > Intégrations pour envoyer les événements Pandafile vers un canal Slack, Microsoft Teams ou Discord, ou vers ton propre serveur sous forme de webhook signé. Choisis les événements, envoie un test et consulte le journal des livraisons.
Avec Pro et Team, Pandafile peut prévenir tes autres outils dès que quelque chose se passe : un message dans un canal Slack, Microsoft Teams ou Discord, ou un webhook, c'est-à-dire une requête HTTPS signée vers ton propre serveur.
Les événements disponibles
- Transfert prêt : l'envoi est terminé et le lien fonctionne.
- Transfert téléchargé : une fois par destinataire, la première fois. Tu peux choisir chaque téléchargement à la place.
- Transfert expiré.
- Approbation ou demande de modifications d'un destinataire.
- Dépôt dans une de tes demandes de fichiers.
- Document signé par tous, pour Pandafile Sign.
Ajouter une intégration
- Dans Slack, Microsoft Teams ou Discord, crée un webhook entrant pour le canal et copie son URL. Pour ton propre système, utilise une adresse HTTPS sur ton serveur.
- Connecte-toi à Pandafile et ouvre Tableau de bord > Intégrations.
- Sous Ajouter une intégration, choisis le type, colle l'URL, ajoute un nom si tu veux et coche les événements souhaités.
- Clique sur Ajouter l'intégration, puis sur Envoyer un événement de test pour vérifier qu'il arrive bien.
Tu peux avoir jusqu'à 5 intégrations. Les messages de chat sont rédigés dans la langue de ton compte.
Webhooks pour les développeurs
- Chaque livraison est un POST JSON avec le type d'événement, un identifiant et les détails : identifiants, titres, liens, compteurs et adresses e-mail des destinataires. Elle ne contient jamais le contenu des fichiers, de mots de passe ni de liens de téléchargement personnels.
- Chaque requête a un en-tête Pandafile-Signature avec un horodatage (t) et une signature HMAC-SHA256 (v1) de l'horodatage et du corps, calculée avec ton secret de signature. Le secret commence par whsec_ et n'est affiché qu'une seule fois.
- Nouveau secret crée un nouveau secret de signature. L'ancien reste valable 24 heures, pour que tu puisses basculer sans perdre d'événements.
- Réponds avec un statut 2xx en moins de 10 secondes. Sinon, nous réessayons après 1 minute, 5 minutes, 30 minutes, 2 heures et 12 heures.
- Le journal des livraisons affiche les 50 dernières livraisons de chaque intégration et leur résultat.
Équipes, mode test et Zapier
Dans une équipe, chacun gère ses propres intégrations et ne reçoit que les événements de ses propres transferts. Les événements liés aux transferts de test créés avec une clé API de test partent vers les webhooks avec livemode à false, jamais vers Slack, Teams ou Discord. Zapier et Make se connectent via l'API Pandafile et apparaissent sous Abonnements API.