Aller au contenu

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.

  1. Nommez-le

    Pour vous y retrouver dans la liste.

  2. Donnez-lui une URL

    L’adresse où UseNadia envoie son POST.

  3. 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.

  4. 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.

  5. Enregistrez

    L’en-tête de l’onglet compte vos webhooks sur un quota de 10 000, que vous n’atteindrez pas.

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.

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.
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.

Les webhooks vous disent quand UseNadia a agi. Pour faire agir UseNadia, passez par l’API publique, la CLI ou le MCP.