Poussez les événements CRM et recevez des données externes
Configurez des webhooks sortants qui envoient du JSON quand des fiches sont créées, mises à jour ou supprimées — et des points d’entrée entrants qui mappent du JSON externe vers les champs CRM. Les journaux d’événements aident à valider les livraisons pendant la mise en production.
14j
Rétention des journaux
Déboguer les livraisons en test
whk_
Bearer entrant
Jeton affiché une fois à la création
2-way
Modèle de sync
Pousser le CRM ; recevoir les payloads externes
Événements dans les deux sens
POST sortants au changement ; JSON entrant vers les fiches.
Votre CRM doit dialoguer avec la facturation, l’automation marketing et vos services sans export CSV nocturne. Les webhooks sortants partent aux changements de fiches ; les entrants acceptent des POST authentifiés qui créent, mettent à jour ou upsertent des enregistrements.
Configuration → Webhooks couvre les deux sens, les options d’authentification et un journal de 14 jours. Les payloads de test confirment la configuration abonné avant le trafic réel.
Sortants sur changement de fiche
Pointez chaque règle vers une URL abonnée. Choisissez objets, événements et auth — en-tête, basique ou signature HMAC.
Points d’entrée JSON entrants
Les systèmes externes POSTent sur /api/webhooks/inbound/{id} avec jeton Bearer whk_. Mappez les chemins JSON vers les champs CRM.
Journaux pour le débogage
Filtrez par sens, date, statut et règle. Inspectez payload, champs mappés, réponse HTTP et lien vers la fiche.
Sortant
Sortants : événements CRM vers votre stack
OSTRATA POSTe du JSON quand les objets sélectionnés changent — votre plateforme d’automation ou service reçoit des payloads structurés.
- Bascule par règle pour les événements d’import en masse (désactivée par défaut)
- Payload de test webhook.test sans toucher aux fiches réelles
- Auth abonné : en-tête, basique ou HMAC
Entrant
Entrants : données externes vers les fiches
Créez des points d’entrée qui mappent les champs JSON avec création, mise à jour ou upsert.
- Jeton Bearer whk_ affiché une fois à la création
- Profil de permissions pour limiter ce que le point d’entrée peut écrire
- Chemins JSON imbriqués vers champs CRM plats
Vérification
Vérifier avant la production
Journaux et payloads de test réduisent les tâtonnements avec n8n, Zapier ou services custom.
- Testez les règles sortantes et confirmez la livraison dans les journaux
- Exécutez les workflows entrants et vérifiez champs mappés et lien fiche
- Journaux conservés 14 jours pour le dépannage
API
Complément à l’API REST
Webhooks pour les flux événementiels ; clés API pour le polling et les jobs par lots.
- Sortants poussent les changements au fil de l’eau
- Entrants acceptent les poussées des systèmes externes
- Clés API à périmètre pour la lecture/écriture programmatique
Périmètre
Écritures conscientes des permissions
Les points d’entrée entrants héritent d’un profil pour que l’automation ne dépasse pas le périmètre prévu.
- Limitez création/mise à jour à des objets et champs précis
- Même modèle de profil que clés API et accès membres
- Auditez les livraisons dans les journaux d’événements
Questions
Réponses courtes avant de demander l'accès.
- Quelle authentification pour les webhooks entrants ?
- Jeton Bearer avec préfixe whk_, copié une fois à la création dans Configuration → Webhooks → Entrants. Incluez-le dans l’en-tête Authorization sur POST vers /api/webhooks/inbound/{id}.
- Les sortants incluent-ils les événements d’import en masse ?
- Seulement si vous activez la bascule par règle. Par défaut, les imports en masse sont exclus pour éviter de saturer les abonnés.
- Combien de temps les journaux sont-ils conservés ?
- 14 jours. Filtrez par sens, date, statut et règle pour inspecter payloads, réponses HTTP et liens vers les fiches concernées.
- Puis-je tester sans créer de vraies fiches ?
- Oui. Les règles sortantes supportent un payload de test webhook.test. Utilisez les journaux d’événements pour confirmer réception et authentification.