Intégrations : webhooks sortants

Paramètres → Intégrations (adresse /app/settings/integrations) envoie des événements de cet espace de travail vers une URL à vous, par exemple un outil d’automatisation (Zapier, Make, n8n) ou votre propre serveur. Seuls Propriétaire et Admin peuvent voir et modifier.

Étape par étape : ajouter un point de terminaison

1. Ouvrir Paramètres → Intégrations.
2. Dans URL du point de terminaison, saisissez l’URL de votre point de terminaison, par exemple https://your-system.example.com/omnibrand-hook. Elle doit être en https et joignable sur l’Internet public ; sinon, une ligne rouge indique le problème ("L’adresse du point de terminaison doit commencer par https://. Le simple http:// n’est pas accepté.", ou qu’elle n’est pas joignable depuis Internet).
3. Sous Événements, cochez les événements que reçoit ce point de terminaison. Chaque case comporte une description simple et le nom de l’événement, par exemple post.published ("Une publication a été publiée"), post.failed, social_account.token_expired ou social_account.disconnected ; Tous les événements, y compris ceux ajoutés plus tard correspond à *. workspace.created et invitation.accepted y figurent aussi. Cochez-en au moins un, sinon le formulaire indique "Choisissez au moins un événement."
4. Cliquez sur Ajouter un point de terminaison.
5. Secret de signature (à copier maintenant - affiché une seule fois) : apparaît avec le secret, au-dessus du formulaire ; la page fait défiler jusqu’à celui-ci pour que vous le voyiez aussi sur un téléphone. Si le point de terminaison est refusé, le message rouge apparaît au même endroit et la page y fait défiler. Copiez le secret dans votre système récepteur maintenant ; OmniBrand ne le montre plus jamais (seulement ses quatre derniers caractères). Copier le secret à côté le copie pour vous.
6. Cliquez sur Envoyer un test sur le point de terminaison. Vous voyez ✓ livré avec le statut HTTP que votre serveur a renvoyé. En cas d’échec, vous voyez « Non livré : votre serveur a répondu à [statut]. » avec quoi corriger, par exemple pour 405 Méthode Non autorisé « Il doit accepter les requêtes POST à cette adresse. », pour 404 Non trouvé « Rien ne répond à cette adresse. Vérifiez l’URL. », pour une redirection « Il a été redirigé vers une autre adresse, et les webhooks ne suivent jamais de redirections. Enregistrez plutôt l’URL finale. » ; ou, lorsque le serveur n’a pas du tout été atteint, « Non livré : votre serveur n’a pas pu être atteint ([raison]). Vérifiez l’URL et que le serveur est en ligne. » Un lien Comment fonctionnent les webhooks ouvre cet article.

Chaque extrémité

• L’URL et un badge actif ou désactivé.
• « événements : ... · secret ••••1234 », avec chaque événement par sa description (par exemple « Un post a été publié »), plus « · N échecs consécutifs » lorsque les tentatives de livraison échouent et « · N en attente d’une nouvelle tentative » pendant que les événements attendent leur prochaine tentative.
• Une ligne rouge « N livraisons ratées - ouvrir l’historique des livraisons pour les renvoyer » lorsque les événements ont cessé (voir Historique des livraisons et Relivraison ci-dessous).
• Activé / Désactivé met en pause ou reprend les livraisons. Pendant que la modification est enregistrée, la carte indique « Fonctionne... » et son Envoyer un test d’envoi et Supprimer attendent ; si le commutateur ou Supprimer échoue, la raison apparaît en rouge en bas de la carte de ce point de terminaison, et la page y fait défiler.
• Envoyer un test envoie un événement nommé 'webhook.test' une fois (il n’est pas réessayé et ne reste pas dans l’historique).
• Historique des livraisons ouvre les livraisons récentes du point de terminaison (le bouton Masquer l’historique des livraisons les ferme).
• Supprimer demande "Supprimer le webhook pour (adresse) ? Les événements cessent d’y être envoyés immédiatement et son secret de signature disparaît définitivement. Pour le mettre en pause à la place, désactivez son interrupteur." La fenêtre s’intitule Supprimer le webhook ? ; cliquez sur Supprimer pour retirer immédiatement le point de terminaison, ou sur Annuler pour le conserver.

Ce que reçoit votre serveur

Un POST avec un corps JSON : id (l’id de l’événement – utilisez-le pour ignorer les doublons), event (par exemple post.published), occurredAt et data (les détails de l’événement). En-têtes :

• X-OmniBrand-Signature : sha256= suivi du HMAC-SHA256 du corps brut, indiqué par votre secret de signature.
• « X-OmniBrand-Timestamp » et « X-OmniBrand-Signature-V2 » : le HMAC-SHA256 de l’horodatage, d’un point et du corps - l’utiliser pour rejeter les anciennes rediffusions.

Répondez avec n’importe quel état 2xx dans les 5 secondes.

Essais : combien de temps OmniBrand continue d’essayer

Chaque événement est sauvegardé avant d’être envoyé, donc rien n’est perdu si votre serveur – ou le nôtre – redémarre. Lorsque votre serveur ne répond pas avec un statut 2xx dans les 5 secondes (une erreur, un temps mort, une redirection, toute réponse autre que 2xx), l’événement est réessayé après environ 1 minute, 5 minutes, 15 minutes, 30 minutes, 1 heure, 2 heures, 4 heures, 8 heures et 12 heures - 10 tentatives sur environ 28 heures. Chaque attente varie jusqu’à 20 %, donc les réessais ne sont pas tous arrivés en même temps. Comme une réessaie peut arriver après un événement ultérieur, utilisez 'id' pour ignorer les doublons et 'occurredAt' pour commander les événements.

Si les 10 tentatives échouent, la livraison est marquée Échec et reste dans l’historique pendant 30 jours, où vous pouvez la renvoyer.

Historique des livraisons et relivraison

1. Sur le point de terminaison, cliquez Historique des livraisons. Livraisons récentes indiquent les 30 derniers jours, les plus récentes en premier.
2. Chaque ligne affiche un badge d’état - Livrée, Nouvel essai prévu ou Échec - le nom de l’événement, au moment où cela s’est produit, « Tentative N de 10 », pour Nouvel essai prévu du temps de « prochaine tentative », et pour celui qui n’a pas passé « Dernière réponse : » avec ce que votre serveur a répondu (par exemple « HTTP 503 » ou « Pas de réponse dans les 5 s »).
3. Cochez Échecs uniquement pour ne voir que les échecs ; Afficher les plus anciennes en charge davantage. S’il n’y en a aucun, il est indiqué « Aucune livraison échouée au cours des 30 derniers jours. Les livraisons encore en cours de nouvelle tentative ne comptent pas comme échouées. » (une livraison Nouvel essai prévu n’a pas encore échoué).
4. Pour en envoyer un à nouveau, cliquez sur Renvoyer sur sa ligne. Il est envoyé immédiatement : vous voyez « Livré » ou « Pas encore livré (répondre). Il est réessayé automatiquement. » - un événement relivré lance une nouvelle série de 10 tentatives.
5. Pour tous les renvoyer après avoir réparé votre serveur, cliquez sur Renvoyer tous les échecs (affiché lorsqu’il y a des livraisons ratées). Vous voyez « N livraisons ratées sont en file d’attente et sortent en moins d’une minute. »

Redeliver nécessite que le point de terminaison soit activé ; pendant qu’il est Désactivé , les boutons attendent et l’historique indique « Ce point de terminaison est désactivé. Activez son interrupteur pour relivrer. » Les événements qui arrivent alors qu’un point de terminaison est désactivé ne sont ni envoyés ni conservés.

Si quelque chose tourne mal

• Les redirections ne sont jamais suivies ; enregistrez l’URL finale. Si la vôtre redirige, le test indique « Non livré : votre serveur a répondu à 301 Déplacé de façon permanente. Il a été redirigé vers une autre adresse, et les webhooks ne suivent jamais de redirections. Enregistrez plutôt l’URL finale. » (avec l’état envoyé par votre serveur).
• Lorsque chaque tentative vers un point de terminaison a échoué pendant une journée entière (au moins 20 tentatives consécutives), le point de terminaison est automatiquement désactivé et les administrateurs sont informés. Ses livraisons en attente sont marquées Échec. Réparez le récepteur, remettez l’interrupteur en Activé, puis ouvrez Historique des livraisons et cliquez sur Renvoyer tous les échecs.

Accès API (pour les développeurs)

En bas de la page, la carte Accès API (pour les développeurs) : « Connectez OmniBrand à vos propres systèmes, à Zapier ou à Make pour créer des publications, ajouter des contacts ou lire les statistiques automatiquement. » Avec les forfaits Agency et Enterprise, elle contient vos clés pour l’API publique (voir Accès API). Avec les autres forfaits, elle indique « L’accès API est disponible avec le forfait Agency. » avec un lien Voir les forfaits. Les webhooks de cette page fonctionnent avec tous les forfaits.

Bon à savoir

• Un point de terminaison ne reçoit que les événements de cet espace de travail, ainsi que les événements à l’échelle du compte (facturation et événements de compte).
• L’espace de travail auquel vous vous trouvez lorsque vous ajoutez le point d’extrémité est celui auquel il appartient.