Actions des webhooks

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

{
  "action": "scheduled", // The action taken
  "subAction": "tikTokPublished", // Only present when TikTok video publishing complete
  "created": "2023-01-05T01:18:47Z",
  "code": 200, // HTTP response code
  "refId": "140b8700bd6ade089b242d845e268fb886130c53", // User Reference ID
  "status": "success", // success or error
  "id": "TBAAAqAMMpoweA9wKHUp", // Ayrshare id of post
  "errors": [], // List of errors if any occurred
  "postIds": [
    // Individual successful posts status
    {
      "postUrl": "https://www.facebook.com/102775127855689_361718068618052",
      "platform": "facebook",
      "status": "success",
      "id": "102775127855689_361718068618052"
    }
  ],
  "url": "https://mysite.com/webhook" // Your webhook URL
}

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.

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

{
  "account": {
    // Optional: identity of the linked social account. Sent for YouTube only today,
    // not for other platforms.
    "id": "UCxyz123", // Optional: the social network's own account id. For YouTube, the channel id
    "handle": "@socialdept", // Optional: the @ handle, present when the account has one, such as a YouTube custom URL
    "title": "The Social Dept.", // Optional: the social account's own title, such as the YouTube channel name
    "profileUrl": "https://www.youtube.com/@socialdept" // Optional: the public URL of the social account
  },
  "action": "social", // The action taken
  "created": "2023-01-05T01:18:47Z",
  "code": 200, // HTTP response code
  "details": {
    // Optional: sent on unlink, if details are available
    "status": "error",
    "code": 349,
    "message": "Account locked"
  },
  "displayName": "Google Account Name", // If a user account name is present at the social network
  "hookId": "TKLc30192HLGw5UeJ46",
  "platform": "youtube", // The social platform the action occurred on
  "refId": "140b8700bd6ade089b242d845e268fb886130c53", // User Reference ID
  "refreshBy": "2022-11-05T12:21:29Z", // Optional: If type is refresh, the date the social network authorization must be refreshed on the social account linkage page
  "source": "system", // Optional: sent on unlink and refresh. Initiated by "system" or "user".
  "title": "User Profile Name", // The user profile's account title
  "type": "unlink", // Type of action: link, unlink, or refresh
  "url": "https://mysite.com/webhook" // Your webhook URL
}

L’objet account est envoyé lorsqu’Ayrshare dispose de l’identité au niveau du compte pour la plateforme liée (actuellement YouTube uniquement), et il est inclus dans les actions link et unlink. Chaque clé de account est facultative (une chaîne YouTube sans URL personnalisée n’a pas de handle). Lorsqu’aucune identité n’est disponible, la clé account est entièrement omise au lieu d’être envoyée vide : vérifiez donc qu’une clé est présente avant de l’utiliser. Notez que account.title est le titre propre du compte social, comme le nom de la chaîne YouTube, tandis que le title de premier niveau est le titre de votre profil utilisateur Ayrshare. Ce sont des valeurs différentes. 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.

Certains champs sont optionnels lorsque nous ne pouvons pas joindre le réseau social.conversationId et senderDetails sont résolus auprès du réseau social au moment où le message arrive. Lorsque cette résolution échoue, plutôt que de retenir le message, nous le livrons avec ce que nous avons pu résoudre et définissons connectionDegraded: true.La cause habituelle est une connexion Instagram ou Facebook du profil qui a expiré ou a été invalidée, mais tout échec de cette résolution active le drapeau, y compris une erreur transitoire de la Graph API. Distinguez-les selon la persistance : sur un seul message, il s’agissait d’un incident passager qui ne requiert rien de votre part, tandis que sur chaque message d’un profil, l’identifiant est mort et seule une reconnexion efface le drapeau.

{
  "action": "messages",
  "connectionDegraded": true, // présent uniquement lorsque la résolution a échoué
  "id": "aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlE...",
  "message": "This is an amazing message",
  "platform": "instagram",
  "recipientId": "17841401430400299",
  "senderId": "17841452212707444",
  "subAction": "messageCreated"
  // conversationId et senderDetails peuvent être absents
}

Lorsque le drapeau persiste, considérez-le comme un signal qu’il faut reconnecter le compte social de ce profil. Un identifiant mort bloque également la réponse et la récupération de l’historique de conversation via l’API, car les deux nécessitent le même identifiant. Les messages continuent d’arriver pendant tout ce temps, donc aucune donnée entrante n’est perdue.Un compte Instagram connecté via une Page Facebook dépend de l’identifiant de cette Page ; reconnectez donc Facebook d’abord, puis Instagram — reconnecter Instagram seul n’effacera pas le drapeau.Concevez votre intégration pour tolérer l’absence de conversationId et de senderDetails sur n’importe quel message. id, senderId, recipientId et platform sont toujours présents.Notez que message n’est pas garanti non plus, indépendamment de l’état de la connexion : un message ne contenant qu’une pièce jointe transporte attachments sans champ message.

{
  "action": "messages",
  "conversationId": "t_10161117434308936",
  "created": "2024-06-07T11:58:44Z",
  "hookId": "JC6IgqFjvDliTJ8MLqzE",
  "id": "m_aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEOjE3ODQxNDUyMjEyNzA",
  "message": "This is an amazing message",
  "platform": "facebook",
  "recipientId": "7270633706358444",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",
  "scheduleDate": "2024-06-07T11:58:44Z",
  "senderDetails": {
    // recipientDetails if type is sent
    "id": "7270633706358444",
    "picture": "https://scontent-ord5-2.cdninstagram.com/v/t51.jpg",
    "username": "SweetMessage",
    "name": "Sweet"
  },
  "senderId": "17841452212707444",
  "subAction": "messageCreated",
  "timeStamp": 1735189325, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "received", // received, sent, or deleted
  "url": "https://mysite.com/webhook" // Your webhook URL
}

{
  "action": "messages",
  "conversationId": "aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6MTc4",
  "created": "2024-06-07T11:58:44Z",
  "hookId": "JC6IgqFjvDliTJ8MLqzE",
  "id": "aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEOjE3ODQxNDUyMjEyNzA",
  "message": "This is an amazing message",
  "platform": "instagram",
  "recipientId": "7270633706358444",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",
  "scheduleDate": "2024-06-07T11:58:44Z",
  "senderDetails": {
    // recipientDetails if type is sent
    "id": "7270633706358444",
    "picture": "https://scontent-ord5-2.cdninstagram.com/v/t51.jpg",
    "username": "SweetMessage",
    "name": "Sweet"
  },
  "senderId": "17841452212707444",
  "subAction": "messageCreated",
  "timeStamp": 1735189325, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "received", // received, sent, or deleted
  "url": "https://mysite.com/webhook" // Your webhook URL
}

{
  "action": "messages",
  "attachments": [
    {
      "type": "image",
      "url": "https://images.ayrshare.com/abc123/whatsapp_image_x9aB2pK7.jpg"
    }
  ],
  "conversationId": "14155551234",
  "created": "2026-05-18T17:08:41Z",
  "hookId": "JC6IgqFjvDliTJ8MLqzE",
  "id": "wamid.HBgLMTQxNTU1NTEyMzQVAgARGBI4OUYxRkExNzE0M0EwQTYwM0EA",
  "message": "Here's the photo you asked for.",
  "platform": "whatsapp",
  "recipientId": "123456789012345",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",
  "senderDetails": {
    "id": "14155551234",
    "name": "Jane Customer"
  },
  "senderId": "14155551234",
  "timeStamp": 1747588121,
  "title": "Primary Profile",
  "url": "https://mysite.com/webhook"
}

Pour WhatsApp, conversationId et senderId correspondent au numéro de téléphone du correspondant au format E.164 chiffres uniquement. recipientId est l’ID de numéro de téléphone Meta de votre compte WhatsApp lié. timeStamp est présent lorsque la sécurité des webhooks est activée. Sur tous les réseaux, un message qui transporte des médias les transporte dans attachments, comme le montre l’exemple WhatsApp ci-dessus — Facebook et Instagram inclus. Les types d’attachement peuvent être image, video, audio, document ou sticker. Les webhooks de messages ne transportent jamais mediaUrls — ce champ appartient aux charges utiles post-livraison telles que l’Action Scheduled, où il indique les médias que vous avez envoyés.

Événement de lecture de message

Notification lorsqu’un message est lu par le destinataire.

{
  "action": "messages",
  "conversationId": "t_10161117434308936",
  "created": "2024-06-08T23:33:30Z",
  "hookId": "CviPBMXEy3cdJnK0EESd",
  "platform": "facebook",
  "read": 1717889607802,  // UNIX timestamp of when the message was read
  "readerDetails": {
    "name": "John Smith",
    "id": "7101149746568444",
    "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic"
  },
  "recipientId": "106638148652329",
  "refId": "9abf1426d6ce9122ef11c8932",
  "scheduleDate": "2024-06-08T23:33:30Z",
  "senderId": "7101149746568522",
  "subAction": "messageRead",
  "timeStamp": 1717889610, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "read",
  "url": "https://mysite.com/webhook" // Your webhook URL
}

{
  "action": "messages",
  "conversationId": "t_10161117434308938",
  "created": "2024-06-08T23:33:30Z",
  "hookId": "CviPBMXEy3cdJnK0EESd",
  "platform": "instagram",
  "read": {
    "mid": "aWdfZAG1faXRlbToxOkl" // Instagram message ID
  },
  "readerDetails": {
    "name": "John Smith",
    "id": "7101149746568444",
    "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic",
    "username": "johnsmith"
  },
  "recipientId": "106638148652329",
  "refId": "9abf1426d6ce9122ef11c8932",
  "scheduleDate": "2024-06-08T23:33:30Z",
  "senderId": "7101149746568522",
  "subAction": "messageRead",
  "timeStamp": 1717889610, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "read",
  "url": "https://mysite.com/webhook" // Your webhook URL
}

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.

{
  "action": "messages",
  "conversationId": "t_10161117434308936",
  "created": "2024-06-06T00:49:18Z",
  "hookId": "LcgLuXzZki15lqBNt69h",
  "platform": "facebook",
  "reaction": "😮",
  "recipientId": "106638148652444",
  "refId": "9abf1426d6ce9432",
  "scheduleDate": "2024-06-06T00:49:18Z",
  "senderId": "7101149746568444",
  "subAction": "reactionCreated", // reactionDeleted if deleted
  "timeStamp": 1717634958, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "reaction",
  "url": "https://mysite.com/webhook" // Your webhook URL
}

{
  "action": "messages",
  "conversationId": "aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEO",
  "created": "2024-06-06T00:49:18Z",
  "hookId": "LcgLuXzZki15lqBNt69h",
  "platform": "instagram",
  "reaction": "😮",
  "recipientId": "106638148652444",
  "refId": "9abf1426d6ce9432",
  "scheduleDate": "2024-06-06T00:49:18Z",
  "senderId": "7101149746568444",
  "subAction": "reactionCreated", // reactionDeleted if deleted
  "timeStamp": 1717634958, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "reaction",
  "url": "https://mysite.com/webhook" // Your webhook URL
}

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

{
  "action": "messages",
  "conversationId": "t_10161117434308936",
  "created": "2024-06-06T00:49:18Z",
  "hookId": "LcgLuXzZki15lqBNt69h",
  "id": "m_xyz...",                    // Message ID — matches the original messageCreated event
  "messageEdit": {
    "mid": "m_xyz...",
    "text": "the edited message text"
  },
  "platform": "facebook",
  "recipientId": "106638148652444",
  "refId": "9abf1426d6ce9432",
  "senderId": "7101149746568444",
  "subAction": "messageEdited",
  "timeStamp": 1717634958,              // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "edit",
  "url": "https://mysite.com/webhook"   // Your webhook URL
}

{
  "action": "messages",
  "conversationId": "aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEO",
  "created": "2024-06-06T00:49:18Z",
  "hookId": "LcgLuXzZki15lqBNt69h",
  "id": "aWdfZAG1faXRlbToxOkl",
  "messageEdit": {
    "mid": "aWdfZAG1faXRlbToxOkl",
    "text": "the edited message text"
  },
  "platform": "instagram",
  "recipientId": "106638148652444",
  "refId": "9abf1426d6ce9432",
  "senderId": "7101149746568444",
  "subAction": "messageEdited",
  "timeStamp": 1717634958,              // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "edit",
  "url": "https://mysite.com/webhook"   // Your webhook URL
}

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": "batch",
  "batchType": "users",
  "created": "2024-01-11T22:00:30Z",
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",
  "source": "user",
  "timeStamp": 1705010424, // Present with Webhook Security
  "title": "Primary Profile",
  "type": "batch",
  "url": "https://storage.googleapis.com/batch.ayrshare.com/users/dfdf92jskd933r/users-batch-2024-01-11-22-00.json",
  "urlExpires": "2024-01-18T22:00:04Z",
  "userCount": 73
}

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": "feed",
    "created": "2023-01-05T01:18:47Z",
    "code": 200,                                          // HTTP response code
    "refId": "140b8700bd6ade089b242d845e268fb886130c53",  // User Reference ID
    "title": "Title of profile if available",             // optional, only if available
    "data": { ... },
    "url": "https://api.myapp.com/Webhook/Ayrshare/Feed"  // Your webhook URL
}

Action Mentions

Notification lorsque votre compte connecté est mentionné. Disponible pour 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), subAction, platform et postId. 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, donc platform vaut toujours instagram sur cette action. postId suit la même règle que sur l’Action Comments, et sur les mentions il est généralement absent : une mention se produit normalement sur la publication de quelqu’un d’autre, qui n’a pas d’id Ayrshare. Il n’apparaît que lorsque la mention porte sur une publication que vous avez publiée via Ayrshare.

Événement Mention (Instagram)

{
  "action": "mentions",
  "subAction": "mention",
  "platform": "instagram",            // The social network the mention came from
  "postId": "TBAAAqAMMpoweA9wKHUp",   // Ayrshare post id; absent unless you published the post
  "media_id": "17900000000000000",    // Meta media the mention occurred on
  "comment_id": "17900000000000001",  // Present when the mention is in a comment
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1705010424,             // Present with Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Mentions"  // Your webhook URL
}

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. Pour Facebook, les événements de commentaire ne sont livrés que lorsque la messagerie est activée sur le profil (le module complémentaire de messagerie) — l’enregistrement du webhook comments seul ne suffit pas. La reconnexion de la Page Facebook n’est pas nécessaire.

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), subAction, platform et postId. 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. Puisque les deux réseaux livrent au même endpoint comments, branchez-vous sur platform — instagram ou facebook — plutôt que de deviner le réseau à partir des noms de champs présents.

Corréler un commentaire avec la publication que vous avez créée

postId est l’id Ayrshare de la publication sur laquelle le commentaire a été laissé — le même id que /post a renvoyé lorsque vous l’avez créée, et celui qu’acceptent Récupérer une publication et les statistiques de publication. Il est là pour que vous puissiez faire correspondre un commentaire à votre propre publication sans maintenir votre propre table de correspondance des ids natifs. Il est fourni au mieux, et omis lorsqu’il ne peut pas être déterminé. Traitez un postId manquant comme « ce commentaire ne porte pas sur une publication que j’ai publiée », jamais comme une erreur. Il est absent lorsque :

La publication n’a pas été publiée via Ayrshare. Les événements de commentaire se déclenchent pour tout ce qui se passe sur votre compte connecté, y compris les publications créées directement dans l’application Instagram ou Facebook. Celles-ci n’ont aucun id Ayrshare — rien ne permet d’en retrouver un.
La publication a été publiée avant l’arrivée de ce champ. Les données de corrélation sont enregistrées au moment de la publication et ne sont pas complétées rétroactivement, donc les commentaires sur vos publications plus anciennes ne porteront pas de postId.
La publication a été publiée par un autre User Profile (profil utilisateur). Plusieurs profils peuvent être connectés à la même Page ou au même compte Instagram et tous reçoivent l’événement de commentaire, mais seul le profil qui a réellement publié la publication se voit communiquer son id.

postId est l’id de publication Ayrshare, pas celui du réseau. L’id propre au réseau pour la même publication reste là où il a toujours été — media.id sur Instagram, post_id sur Facebook.

Événement Comment (Instagram)

{
  "action": "comments",
  "subAction": "comment",
  "platform": "instagram",             // The social network the comment came from
  "postId": "TBAAAqAMMpoweA9wKHUp",    // Ayrshare post id; absent unless you published the post
  "id": "17900000000000002",           // Comment ID
  "text": "Great post!",
  "from": {
    "id": "1234567890",
    "username": "alice"
  },
  "media": {
    "id": "17900000000000000",         // ID of the commented media
    "media_product_type": "FEED"       // e.g. FEED, REELS, STORY
  },
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1705010424,             // Present with Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Comments"  // Your webhook URL
}

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. Deux types d’événements sont envoyés sur l’action automations, distingués par le champ type. Voir événements webhook pour la référence complète des champs.

`type`	Envoyé lorsque
`automation.triggered`	L’action `fire_webhook` de l’automatisation s’exécute. Non envoyé lorsque l’envoi est limité en débit ou que cette action est dédupliquée
`automation.completed`	L’envoi a atteint un statut terminal. Désactivé par défaut : envoyé uniquement lorsque l’action `fire_webhook` de l’automatisation définit `"sendCompletedEvent": true`

Événement Automation Triggered

{
  "action": "automations",
  "type": "automation.triggered",
  "automationId": "a1B2c3D4",
  "triggerId": "t9X8y7Z6",
  "trigger": "comment_keyword",        // The trigger type that fired the automation (varies by automation)
  "platform": "instagram",
  "recipientId": "17841400000000000",
  "recipientUsername": "alice",        // null if unavailable
  "keyword": "INFO",                   // null if not keyword-triggered; the emoji for dm_reaction
  "activityId": "a1B2c3D4:t9X8y7Z6:comment.received:17912345678901234", // Matches the row in GET /automations/:id/activity
  "actionId": "act_wh_1",              // The fire_webhook action that sent this; matches actionResults[].actionId
  "eventId": "comment.received:17912345678901234",
  "commentId": "17912345678901234",    // null for DM-driven triggers
  "commentText": "INFO please",        // DM text for dm_keyword, the emoji for dm_reaction, null when there is none
  "postId": "17895695668004550",       // null unless the engagement was on a post or reel
  "storyId": null,                     // null unless the engagement was on a story
  "timestamp": "2026-05-27T22:00:30Z", // When the automation fired (ISO 8601)
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1705010424,             // Unix timestamp, present with Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Automations"  // Your webhook URL
}

Événement Automation Completed

{
  "action": "automations",
  "type": "automation.completed",
  "automationId": "a1B2c3D4",
  "triggerId": "t9X8y7Z6",
  "trigger": "comment_keyword",
  "platform": "instagram",
  "recipientId": "17841400000000000",
  "activityId": "a1B2c3D4:t9X8y7Z6:comment.received:17912345678901234", // Join key; matches automation.triggered when one was sent
  "eventId": "comment.received:17912345678901234",
  "status": "sent",                    // sent, failed, rate_limited, deduplicated, skipped, or auth_error
  "actionResults": [                   // Empty when rate_limited, deduplicated, or failed after the retry limit
    { "actionId": "act_dm_1", "type": "send_dm", "status": "sent", "errorDetails": null },
    { "actionId": "act_wh_1", "type": "fire_webhook", "status": "sent", "errorDetails": null }
  ],
  "errorDetails": null,                // Reason when skipped, rate_limited, or failed after the retry limit
  "timestamp": "2026-05-27T22:00:58Z",
  "hookId": "Kq2LmN8pR4tV6wXyZ1aB",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",
  "timeStamp": 1705010452,
  "url": "https://api.myapp.com/Webhook/Ayrshare/Automations"
}

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

{
  "action": "demo",
  "type": "upgradeWarning",
  "demoExpires": "2026-08-27T09:57:00.000Z",  // Quand le profil se convertit (ISO 8601)
  "daysUntilUpgrade": 2,
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1787734624,             // Horodatage Unix (2026-08-26), présent avec Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Demo"  // Votre URL de webhook
}

Événement Demo Upgrade

{
  "action": "demo",
  "type": "upgrade",
  "upgradedAt": "2026-08-28T08:57:04.000Z",  // Quand le profil a été converti (ISO 8601)
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1787907424,             // Horodatage Unix (2026-08-28), présent avec Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Demo"  // Votre URL de webhook
}

Action Suspended

Notification lorsqu’un User Profile est suspendu ou réactivé. Les suspensions peuvent provenir de l’application des règles d’un réseau social lui-même (par exemple, une exigence de vérification d’identité Facebook), de la protection contre les limites de débit, ou de problèmes de facturation. Tant qu’un profil est suspendu, les appels API pour ce profil renvoient HTTP 403. Deux types d’événements sont envoyés sur l’action suspended, distingués par le champ type :

suspend — envoyé lorsque le profil est suspendu. Suspendez la publication et toute autre activité pour ce profil jusqu’à ce qu’il soit réactivé.
unsuspend — envoyé lorsque le profil est réactivé.

Les événements ne sont envoyés que lorsque l’état global de suspension du profil change. Un profil peut être suspendu pour plusieurs causes à la fois : si une cause supplémentaire est ajoutée alors que le profil est déjà suspendu, ou si l’une des causes est résolue alors qu’une autre s’applique toujours, aucun événement n’est envoyé — le profil reste suspendu, et le prochain événement est l’unsuspend lorsque la dernière cause disparaît. Pour inspecter l’état de suspension actuel à tout moment, utilisez Get Profiles avec include=suspension. Une suspension déclenchée par une plateforme est généralement précédée d’un événement unlink d’Action Social pour le réseau concerné. La suspension ne peut être résolue qu’à la source — par exemple, une vérification d’identité Facebook doit être effectuée par l’administrateur de la Page dans l’application Facebook — après quoi le profil peut être réactivé et le réseau relié.

Événement Suspend

{
  "action": "suspended",
  "type": "suspend",
  "reason": "Confirm your identity before you can publish as this Page.", // Tel que rapporté par la plateforme ou Ayrshare ; null si indisponible
  "platform": "facebook",              // Le réseau social ayant déclenché la suspension ; null si non déclenchée par une plateforme
  "origin": "policy",                  // Ce qui a suspendu le profil : policy, payment, rateLimit, manual, report ou subscription ; null si indisponible
  "suspendedAt": "2026-08-13T20:31:41.128Z", // Quand la suspension s'est produite (ISO 8601) ; null si indisponible
  "unsuspendAt": null,                 // Réactivation automatique planifiée (ISO 8601), lorsqu'elle est déjà connue
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1786731101,             // Horodatage Unix, présent avec Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Suspended"  // Votre URL de webhook
}

Événement Unsuspend

{
  "action": "suspended",
  "type": "unsuspend",
  "reason": null,
  "platform": null,
  "origin": null,
  "suspendedAt": null,
  "unsuspendAt": null,
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1786988742,             // Horodatage Unix, présent avec Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Suspended"  // Votre URL de webhook
}

Les événements de suspension sont envoyés pour le profil dont l’état a changé. Vous pouvez également vérifier l’état de suspension à la demande avec Get Profiles en utilisant include=suspension, qui renvoie isSuspended, reason, suspendedAt, unsuspendAt et suspensionCount.

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

Action Scheduled

Événement Scheduled

Webhook de publication TikTok

Action Messages

Couverture standby pour les pages Facebook avec plusieurs applications

Nouveaux événements de message

Événement de lecture de message

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

Événement de modification de message

Statut des messages WhatsApp

Action Batch

Événement Batch

Action Feed

Événement Feed

Action Mentions

Événement Mention (Instagram)

Action Comments

Corréler un commentaire avec la publication que vous avez créée

Événement Comment (Instagram)

Action Automations

Événement Automation Triggered

Événement Automation Completed

Action Demo

Événement Demo Upgrade Warning

Événement Demo Upgrade

Action Suspended

Événement Suspend

Événement Unsuspend

​Action Scheduled

​Événement Scheduled

​Webhook de publication TikTok

​Action Social

​Événement Social Action

​Action Messages

​Couverture standby pour les pages Facebook avec plusieurs applications

​Nouveaux événements de message

​Événement de lecture de message

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

​Événement de modification de message

​Statut des messages WhatsApp

​Action Batch

​Événement Batch

​Action Feed

​Événement Feed

​Action Mentions

​Événement Mention (Instagram)

​Action Comments

​Corréler un commentaire avec la publication que vous avez créée

​Événement Comment (Instagram)

​Action Automations

​Événement Automation Triggered

​Événement Automation Completed

​Action Demo

​Événement Demo Upgrade Warning

​Événement Demo Upgrade

​Action Suspended

​Événement Suspend

​Événement Unsuspend

Action Scheduled

Événement Scheduled

Webhook de publication TikTok

Action Social

Événement Social Action

Action Messages

Couverture standby pour les pages Facebook avec plusieurs applications

Nouveaux événements de message

Événement de lecture de message

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

Événement de modification de message

Statut des messages WhatsApp

Action Batch

Événement Batch

Action Feed

Événement Feed

Action Mentions

Événement Mention (Instagram)

Action Comments

Corréler un commentaire avec la publication que vous avez créée

Événement Comment (Instagram)

Action Automations

Événement Automation Triggered

Événement Automation Completed

Action Demo

Événement Demo Upgrade Warning

Événement Demo Upgrade

Action Suspended

Événement Suspend

Événement Unsuspend