Prérequis
- Un compte Super Admin dans Piper
- Un endpoint HTTPS capable de recevoir des requêtes POST
Configurer un webhook
1
Ajoutez un webhook
Cliquez sur + Add webhook et donnez-lui un Name et une URL de destination (doit être en
https://).2
Choisissez les types d'événements
Sélectionnez les événements qui doivent déclencher ce webhook : AI Transcription & Notes, CRM Fields, ou Call Scoring Value. Vous pouvez en sélectionner plusieurs.
3
Ajoutez des en-têtes personnalisés (facultatif)
Ajoutez les en-têtes personnalisés dont votre endpoint a besoin, sous forme de paires clé/valeur répétables.
4
Enregistrez et vérifiez
Enregistrez le webhook. Piper affiche un signing secret que vous pouvez utiliser pour vérifier que chaque requête provient bien de Piper — chaque envoi est signé (Standard Webhooks/HMAC) et peut être régénéré à tout moment depuis le même écran.
Livraison et sécurité
- Les envois ne sont effectués que vers des URL HTTPS.
- Chaque requête est signée selon le schéma Standard Webhooks/HMAC, ce qui permet de vérifier qu’elle provient bien de Piper.
- Les envois échoués (délai dépassé ou erreurs serveur) sont automatiquement retentés.
- Régénérez le signing secret à tout moment depuis le même écran si vous pensez qu’il a été compromis.
Schéma du payload
Chaque envoi est la même enveloppe JSON, contenant l’une des trois formes dedata selon type :
extracts (AI Transcription & Notes) :
deal_values (CRM Fields) :
call_score (Call Scoring Value) :
data inclut aussi un champ json_content : le même payload, encodé en base64, conservé pour la compatibilité avec les anciens zaps Zapier.
Pour une autre plateforme d’automatisation, ou un cas d’usage nécessitant un accès API complet, consultez Zapier ou contactez support@piperai.com.