Webhooks
Où : Paramètres, Webhooks
Un webhook est un appel HTTP qu’UseNadia déclenche quand quelque chose se produit : une publication part, un commentaire ou un message arrive, une automatisation récupère un e-mail. Il sert à relayer du contenu dans Slack, à consigner les publications dans un tableur, à lancer un workflow Zapier ou n8n, ou à mettre à jour votre propre système.
En ajouter un
Section intitulée « En ajouter un »-
Nommez-le
Pour vous y retrouver dans la liste.
-
Donnez-lui une URL
L’adresse où UseNadia envoie son POST.
-
Choisissez le périmètre
Toutes les intégrations, ou une sélection de canaux. Restreindre par canal, c’est ce qui envoie les publications d’un client vers le système de ce client.
-
Envoyer un test
Déclenche aussitôt un appel de test : vous vérifiez que l’adresse répond et vous voyez la forme du contenu avant que quoi que ce soit de réel en dépende.
-
Enregistrez
L’en-tête de l’onglet compte vos webhooks sur un quota de 10 000, que vous n’atteindrez pas.
Événements
Section intitulée « Événements »Chaque livraison est une enveloppe { id, event, occurredAt, organizationId, data },
signée dans l’en-tête X-Nadia-Signature. Un webhook créé depuis les
Paramètres reçoit tous les événements ; par l’API publique (ou le
nœud déclencheur n8n), il peut
en choisir certains.
| Événement | Quand |
|---|---|
post.published |
Une publication est partie sur un canal |
comment.received |
Un commentaire est arrivé sur une publication d’un canal connecté |
dm.received |
Un message privé est arrivé sur un canal connecté |
automation.triggered |
Un commentaire a correspondu à une automatisation et la réponse est partie |
automation.email_captured |
Une automatisation a enregistré l’adresse e-mail de la personne avec qui elle échange |
post.published part une fois par publication, quand la plateforme la
confirme (le premier post d’un fil, pas ses réponses). Son data est la
publication : son id (la publication UseNadia), content, publishDate,
releaseURL (le lien sur la plateforme), link (le lien court de la
publication, null si elle n’en a pas), state et son integration (id,
name, providerIdentifier, picture, type). Elle ne porte aucun fichier
média.
automation.email_captured est la façon dont une
automatisation commentaire → DM
transmet les e-mails qu’elle récupère à un outil qui n’est pas sur la page
Intégrations (voir Transmettre l’e-mail) :
une newsletter comme Substack, un CRM, un tableur. Son data :
{ "email": "marie@gmail.com", "keyword": "LIEN", "username": "marie", "commenterId": "17841400000000000", "personId": "1234567890123456", "automation": { "id": "…", "name": "AWS kit" }, "pose": { "id": "…" }, "runId": "…", "postId": "…", "mediaId": "18000000000000000", "integrationId": "…", "capturedAt": "2026-10-13T09:30:00.000Z"}personId est l’identifiant avec lequel écrire à la personne (null tant
qu’il n’est pas connu), pose l’endroit où le template est posé (un post ou
une story), et postId la publication UseNadia quand il y en a une.
comment.received se déclenche pour chaque commentaire écrit par quelqu’un
d’autre sous une publication d’un canal Instagram connecté, réponses
comprises. Les commentaires du compte lui-même ne le déclenchent jamais. Son
data :
{ "integrationId": "…", "mediaId": "18000000000000000", "postId": "…", "commenter": { "id": "17841400000000000", "username": "marie" }, "comment": { "id": "18100000000000000", "text": "LIEN", "parentId": null }, "receivedAt": "2026-10-21T09:30:00.000Z"}postId est la publication UseNadia d’où vient la publication Instagram
(null pour une publication faite ailleurs), parentId le commentaire auquel
répond une réponse.
dm.received se déclenche pour chaque message privé que quelqu’un d’autre
envoie à un canal Instagram connecté : texte, réponses à une story, médias.
Vos propres messages, les accusés de lecture et les réactions ne le
déclenchent jamais, pas plus qu’un clic sur le bouton d’une automatisation
(c’est le rôle de automation.*). Son data :
{ "integrationId": "…", "sender": { "id": "1234567890123456", "username": "marie" }, "message": { "id": "aWdfZAG1…", "text": "Is the guide still available?", "storyId": null }, "conversationId": "aWdfZAG06…", "receivedAt": "2026-10-21T09:30:00.000Z"}sender.id est l’identifiant avec lequel répondre à la personne.
sender.username et conversationId valent null tant que l’Inbox n’a pas
synchronisé cette conversation une première fois ; storyId est la story à
laquelle répond une réponse.
Construire le récepteur
Section intitulée « Construire le récepteur »Faites toujours d’abord Envoyer un test et gardez le corps reçu : c’est le contrat, plus fiable que n’importe quelle description ici.
Deux habitudes à prendre :
- Répondre 2xx vite, puis faire le travail en asynchrone. Une adresse lente ne se distingue pas d’une adresse en panne.
- Être idempotent. Une livraison répétée ne doit rien faire, plutôt que publier deux fois.
Quand un webhook ne se déclenche plus
Section intitulée « Quand un webhook ne se déclenche plus »L’adresse n’est pas joignable publiquement
UseNadia appelle depuis ses serveurs : localhost et les adresses de réseau privé ne marchent pas. Pendant le développement, passez par un tunnel.
L’adresse renvoie une erreur
Regardez d’abord vos propres logs, puis reproduisez avec Envoyer un test.
Le webhook vise les mauvais canaux
Un webhook restreint à certaines intégrations reste muet pour tout le reste. Revérifiez le périmètre.
La publication n’est jamais partie
Un webhook se déclenche sur une publication réussie. Une publication en erreur, ou envoyée mais jamais confirmée par la plateforme, ne produit aucun appel. Regardez d’abord la publication dans le calendrier.
Voir aussi
Section intitulée « Voir aussi »Les webhooks vous disent quand UseNadia a agi. Pour faire agir UseNadia, passez par l’API publique, la CLI ou le MCP.