Skip to main content
Il existe plusieurs types de webhooks disponibles, catégorisés par type d’action. Par exemple, une publication programmée déclenchera un webhook d’action scheduled. Veuillez consulter la vue d’ensemble des webhooks pour plus de détails. Après avoir enregistré une URL de webhook, vous recevrez une requête POST à votre URL lorsqu’un événement se produit. La requête POST inclura une charge utile JSON avec les détails de l’événement.

Action Scheduled

Vous recevrez cette notification de webhook lorsqu’une publication programmée est traitée — qu’elle réussisse ou échoue — et publiée sur les réseaux sociaux sélectionnés. Par exemple, si vous programmez une publication pour 12h00 le 1er août 2026, le webhook sera envoyé à l’heure exacte à laquelle la publication est publiée. Les notifications de webhook ne sont envoyées que pour les publications programmées dans le futur à l’aide du champ scheduleDate dans le point de terminaison /post.

Événement Scheduled

Vous ne recevrez pas de notification de webhook pour les publications immédiates, car l’API retourne la réponse de succès ou d’échec instantanément dans la réponse JSON. Les notifications de webhook ne sont envoyées que pour les publications programmées, car celles-ci sont traitées de manière asynchrone et nécessitent une notification séparée pour vous informer de leur statut.

Webhook de publication TikTok

Lorsque vous travaillez avec TikTok via Ayrshare, vous pouvez recevoir deux webhooks différents pour une publication programmée. Si votre publication a été programmée plutôt qu’immédiate, vous recevrez d’abord le webhook Scheduled Action standard. Cela indique que le média a été envoyé avec succès à TikTok pour traitement et publication. Par la suite, vous recevrez le webhook subAction: tikTokPublished. Il est déclenché une fois que TikTok a terminé le traitement du média et que le média est rendu public. Ce webhook est activé à la fois pour les publications immédiates et les publications programmées. Dans le tableau de bord Ayrshare, cet événement est étiqueté tikTok (pub).
Le webhook tikTokPublished n’est pas envoyé tant que le média n’est pas rendu public. Si le média est défini sur private, followers ou friends, le webhook ne sera pas envoyé.Si vous ne recevez pas le webhook tikTokPublished et que le statut de la publication reste pending, vérifiez l’application mobile TikTok pour vous assurer que le média a été accepté par TikTok.

Action Social

Notification lorsque le profil d’un utilisateur lie ou délie un réseau social.

Événement Social Action

Une source de system signifie qu’Ayrshare a automatiquement délié le compte, par exemple lorsque la connexion au réseau social n’est plus valide. Nous vous recommandons de notifier votre utilisateur afin qu’il puisse continuer à publier. Les détails du déliage se trouvent dans le champ details. Un e-mail sera également envoyé à l’adresse e-mail du compte principal, ou aux e-mails alternatifs s’ils ont été configurés. Une source de user signifie que l’utilisateur a lancé l’action lui-même, par exemple qu’il a manuellement délié un compte. Aucun e-mail ne sera envoyé lorsqu’une action initiée par l’utilisateur se produit.

Action Messages

Le module complémentaire de messagerie est requis pour accéder à tous les points de terminaison et webhooks de messages. Pour Facebook et Instagram, recevez des notifications lorsqu’un message direct arrive, est lu, ou lorsqu’une réaction est créée ou supprimée. WhatsApp envoie actuellement une notification à votre URL de webhook enregistrée uniquement lorsqu’un nouveau message entrant est stocké. Les webhooks X/Twitter sont disponibles en option pour les clients Enterprise. Veuillez contacter votre représentant de compte pour plus d’informations sur la manière de devenir client Enterprise. WhatsApp n’émet pas aujourd’hui de webhooks de réaction ou de statut de livraison vers votre URL enregistrée. Les messages sortants stockés peuvent avoir une valeur status égale à sent, delivered, read ou failed — voir WhatsApp Message Status ci-dessous.

Couverture standby pour les pages Facebook avec plusieurs applications

Ayrshare s’abonne au champ webhook standby de Facebook en plus des champs de messagerie standard. Cela signifie que les événements Messenger sont livrés à votre webhook même lorsqu’une autre application sur la même page Facebook détient actuellement le contrôle de la conversation — par exemple, lorsqu’une plateforme de chatbot est définie comme récepteur principal de votre page, ou lorsque la boîte de réception Page de Meta traite activement une conversation. Il n’y a pas de changement de schéma pour ces événements. Ils arrivent sous les mêmes charges utiles messageCreated / messageRead / reactionCreated / messageEdited documentées dans les sections ci-dessous. Deux choses à savoir pour les pages avec une application Messenger concurrente installée :
  • Le volume de messages entrants peut augmenter par rapport au comportement précédent, où les événements standby étaient silencieusement ignorés avant l’abonnement. Le nouveau trafic représente les messages que votre page a reçus qui étaient traités par l’autre application.
  • Vous pouvez recevoir des événements messageCreated avec type: "sent" qui ne correspondent pas à des messages que vous avez envoyés via Ayrshare. Il s’agit d’échos de messages envoyés par l’autre application Messenger sur votre page (Meta livre une copie de chaque envoi à chaque application abonnée). Si votre intégration réconcilie le trafic sortant avec votre propre historique d’envoi, vous pouvez utiliser cet historique pour distinguer vos envois de ceux d’une application concurrente.
Pour les pages avec uniquement Ayrshare installé (pas d’application Messenger concurrente), le seul changement observable est le nouvel événement Message Edit — tout le reste semble identique au comportement précédent.

Nouveaux événements de message

Notification lorsqu’un nouveau message est envoyé ou reçu.

Événement de lecture de message

Notification lorsqu’un message est lu par le destinataire.
Lorsqu’un message est lu sur Instagram, la charge utile du webhook inclut un champ mid qui identifie de manière unique le message spécifique lu. Pour les messages Facebook, les lectures de messages sont suivies au niveau de la conversation à l’aide du conversationId. Lorsqu’un événement de lecture se produit, tous les messages de cette conversation avec des horodatages antérieurs à l’horodatage created (ou read) doivent être considérés comme lus par l’utilisateur.

Événements de création et suppression de réaction

Notification lorsqu’une réaction, telle qu’un « j’aime », est créée ou supprimée sur un message.

Événement de modification de message

Notification lorsqu’un utilisateur modifie un message qu’il a précédemment envoyé. Disponible pour les messages directs Facebook et Instagram. Le champ messageEdit.mid correspond à l’id de l’événement messageCreated original, afin que les consommateurs puissent corréler la modification avec le message d’origine. Le champ messageEdit.text contient le texte du message modifié.

Statut des messages WhatsApp

WhatsApp suit l’état de livraison par message sur les messages sortants stockés en utilisant un seul champ status : sent, delivered, read ou failed. Ces mises à jour ne sont pas actuellement livrées à votre URL de webhook enregistrée sous forme d’événements distincts. Si vous avez besoin de l’état de livraison en temps réel, veuillez contacter votre représentant de compte Ayrshare.

Action Batch

Notification lorsqu’un lot a terminé son traitement et que le fichier est disponible, par exemple obtenir tous les profils d’utilisateur. Vous pouvez accéder au fichier avec l’URL pré-signée dans le champ url.

Événement Batch

Action Feed

Notification lorsqu’un nouvel élément de flux RSS est trouvé pour les flux RSS enregistrés. Remarque : si le webhook est actif, les nouveaux éléments RSS ne seront pas automatiquement publiés sur les réseaux sociaux.

Événement Feed

Action Mentions

Notification lorsque votre compte connecté est mentionné. Disponible pour Facebook et Instagram.
Pour Instagram, l’enregistrement du webhook mentions suffit pour recevoir les événements de mention. Le module complémentaire de messagerie, l’activation de la messagerie et la reconnexion du compte social ne sont pas nécessaires.
Ayrshare relaie la charge utile de mention native de Meta sans modification, en n’ajoutant que les champs d’enveloppe standard (action, refId, hookId, url et timeStamp avec la sécurité des webhooks) et subAction. L’exemple ci-dessous est la forme Instagram : media_id, plus comment_id lorsque la mention est dans un commentaire. Les événements de mention de Page Facebook ne sont pas actuellement livrés — Ayrshare les accuse de réception auprès de Meta et ne les transmet pas à votre webhook. Seules les mentions Instagram sont livrées aujourd’hui.

Événement Mention (Instagram)

Action Comments

Notification lorsqu’un commentaire est créé sur votre contenu connecté. Disponible pour Facebook et Instagram.
Pour Instagram, l’enregistrement du webhook comments suffit pour recevoir les événements de commentaire. Le module complémentaire de messagerie, l’activation de la messagerie et la reconnexion du compte social ne sont pas nécessaires.
Ayrshare relaie la charge utile de commentaire native de Meta sans modification, en n’ajoutant que les champs d’enveloppe standard (action, refId, hookId, url et timeStamp avec la sécurité des webhooks) et subAction. L’exemple ci-dessous est la forme Instagram. Les commentaires Facebook arrivent sous la forme d’un changement feed de la page avec des noms de champ différents (par exemple comment_id, post_id, message et from.name) ; consultez la référence des webhooks de Meta pour l’ensemble de champs Facebook.

Événement Comment (Instagram)

Action Automations

Notification lorsqu’une automatisation déclenche une action de webhook pour un utilisateur, par exemple un déclencheur de réponse automatique à un commentaire ou à un DM.

Événement Automation

Action Demo

Notification pour les événements du cycle de vie des Demo User Profile. Les Demo User Profiles sont disponibles avec le Enterprise plan ; veuillez nous contacter si vous souhaitez en savoir plus. Deux types d’événements sont envoyés sur l’action demo, distingués par le champ type :
  • upgradeWarning — envoyé deux jours avant qu’un Demo User Profile ne se convertisse automatiquement en User Profile standard, afin que vous puissiez avertir votre utilisateur de continuer ou de supprimer le profil.
  • upgrade — envoyé lorsque la conversion se produit.

Événement Demo Upgrade Warning

Événement Demo Upgrade