Qu'est-ce qu'un webhook ?

Une URL qui vous appartient et à laquelle sona.to envoie une requête quand un événement se produit, pour que vos outils réagissent immédiatement au lieu de vérifier s'il y a du nouveau.

À quels événements puis-je m'abonner ?

Publication réussie ou échouée, audit de site terminé ou échoué, analyse de visibilité dans l'IA terminée ou échouée et assistant qui commence à citer votre marque ou cesse de la citer. Vous choisissez lesquels chaque webhook reçoit. Les événements de visibilité dans l'IA nécessitent un forfait qui inclut Visibilité dans l'IA.

Comment savoir qu'une requête vient bien de sona.to ?

Chaque requête porte une signature HMAC SHA-256 calculée sur l'horodatage et le corps du message. Recalculez-la avec votre clé de signature et comparez.

Que se passe-t-il si mon point de terminaison est indisponible ?

L'envoi est retenté après 60 secondes, 5 minutes et 30 minutes. Un point de terminaison qui échoue continuellement est désactivé, et vous pouvez le réactiver.

Est-ce que ça fonctionne avec Zapier, Make et n8n ?

Oui. Chacun vous donne une URL de webhook à coller, et l'événement arrive au format JSON.

Faut-il l'API pour utiliser les webhooks ?

Non. Vous pouvez en ajouter un depuis la page API de votre tableau de bord. Les gérer via l'API reste possible si vous préférez.

Accueil / Fonctionnalités / Webhooks

Webhooks

Envoyez vos événements à vos outils dès qu'ils se produisent

Recevez une requête HTTP signée quand une publication part ou échoue, ou quand un audit de site ou une analyse de visibilité dans l'IA se termine.

Commencez gratuitement dès aujourd'hui

Endpoints webhook à côté d'un événement de publication signé

Interroger une API pour savoir si quelque chose s'est produit est lent et coûteux. Les webhooks inversent la logique : vous donnez une URL à sona.to, et sona.to envoie une requête HTTP signée dès qu'une publication part ou échoue, ou qu'un audit de site ou une analyse de visibilité dans l'IA se termine. Pointez-la vers Zapier, Make, n8n ou votre propre serveur, et le reste de votre stack réagit tout seul.

Les événements en temps réel

Huit événements couvrent les cas qui méritent une réaction : publication réussie ou échouée, audit de site terminé ou échoué, analyse de visibilité dans l'IA terminée ou échouée et assistant qui commence à citer votre marque ou cesse de la citer. Chacun transporte les mêmes champs que l'API, donc un webhook et un GET disent la même chose.

Choix des événements reçus par un webhook

Signé, donc vérifiable

Chaque requête porte une signature HMAC SHA-256 calculée sur un horodatage et le corps du message, avec une clé secrète affichée une seule fois à la création du webhook. Vérifiez-la et vous savez que la requête vient de sona.to et qu'elle n'a pas été rejouée.

Vérification d'une requête webhook signée

Nouvelles tentatives et journal des envois

Un envoi échoué est retenté après 60 secondes, puis 5 minutes, puis 30 minutes. Chaque tentative est enregistrée avec son code de statut et sa durée, ce qui rend un point de terminaison défaillant facile à diagnostiquer.