Skip to main content
Доступно кілька типів webhook, класифікованих за типом дії. Наприклад, запланований допис активує webhook дії scheduled. Для отримання деталей див. огляд webhook. Після реєстрації URL webhook, Ви будете отримувати POST-запит на Ваш URL при виникненні події. POST-запит буде містити JSON-payload з деталями події.

Scheduled Action

Ви отримаєте це сповіщення webhook, коли запланований допис буде оброблено — незалежно від того, чи вдалося йому, чи він зазнав невдачі — та опубліковано у вибрані соціальні мережі. Наприклад, якщо Ви заплануєте допис на 12:00 1 серпня 2026 року, webhook буде надіслано точно в момент публікації допису. Сповіщення webhook надсилаються лише для дописів, запланованих на майбутнє за допомогою поля scheduleDate у кінцевій точці /post.

Подія Scheduled

Ви не отримаєте сповіщення webhook для негайних дописів, оскільки API повертає відповідь про успіх чи невдачу миттєво в JSON-відповіді. Сповіщення webhook надсилаються лише для запланованих дописів, оскільки вони обробляються асинхронно і вимагають окремого сповіщення, щоб повідомити Вас про їх статус.

Webhook публікації TikTok

При роботі з TikTok через Ayrshare Ви можете отримати два різних webhook для запланованого допису. Якщо Ваш допис було заплановано, а не опубліковано негайно, Ви спочатку отримаєте стандартний webhook Scheduled Action. Це означає, що медіа успішно надіслано в TikTok для обробки та публікації. Після цього Ви отримаєте webhook subAction: tikTokPublished. Це активується, як тільки TikTok завершить обробку медіа та зробить його публічним. Цей webhook активується як для негайних, так і для запланованих дописів. У панелі керування Ayrshare ця подія позначена як tikTok (pub).
Webhook tikTokPublished не надсилається, поки медіа не зроблено публічним. Якщо медіа встановлено як приватне, для followers або friends, webhook не буде надіслано.Якщо Ви не отримали webhook tikTokPublished, а статус допису залишається pending, перевірте мобільний додаток TikTok, щоб переконатися, що медіа прийнято TikTok.

Social Action

Сповіщення, коли профіль користувача зв’язує або від’єднує соціальну мережу.

Подія Social Action

source system означає, що Ayrshare автоматично від’єднав обліковий запис, наприклад коли з’єднання з соціальною мережею більше недійсне. Ми рекомендуємо повідомити Вашого користувача, щоб він міг продовжувати публікувати. Деталі від’єднання знаходяться в полі details. Електронний лист також буде надіслано на електронну адресу Primary Account, або на альтернативні електронні адреси, якщо їх було налаштовано. source user означає, що користувач ініціював дію самостійно, наприклад, вручну від’єднав обліковий запис. Електронний лист не буде надіслано, коли відбувається дія, ініційована користувачем.

Messages Action

Для доступу до всіх кінцевих точок повідомлень і webhook потрібне доповнення Messaging. Для Facebook та Instagram отримуйте сповіщення, коли надходить пряме повідомлення, воно прочитане, або створена/видалена реакція. WhatsApp наразі надсилає сповіщення на ваш зареєстрований URL webhook лише коли зберігається нове вхідне повідомлення. Webhook X/Twitter доступні як опція для клієнтів Enterprise. Для отримання додаткової інформації про перехід на Enterprise зв’яжіться зі своїм представником облікового запису. WhatsApp сьогодні не надсилає webhook реакцій або статусу доставки на ваш зареєстрований URL. Збережені вихідні повідомлення можуть мати значення statussent, delivered, read або failed — див. WhatsApp Message Status нижче.

Standby покриття для Facebook Pages з кількома додатками

Ayrshare підписується на поле webhook standby Facebook на додаток до стандартних полів обміну повідомленнями. Це означає, що події Messenger доставляються до Вашого webhook навіть коли інший додаток на тій самій Facebook Page наразі утримує контроль потоку — наприклад, коли платформа чатботів встановлена як Ваш основний одержувач Page, або коли Meta Page Inbox активно обробляє розмову. Для цих подій немає змін у схемі. Вони надходять як ті самі payload’и messageCreated / messageRead / reactionCreated / messageEdited, задокументовані в розділах нижче. Дві речі, про які слід знати для Pages з встановленим конкуруючим додатком Messenger:
  • Обсяг вхідних повідомлень може збільшитися порівняно з попередньою поведінкою, коли події standby мовчазно відкидалися до підписки на них. Новий трафік представляє повідомлення, які Ваша Page отримувала і які обробляв інший додаток.
  • Ви можете отримувати події messageCreated з type: "sent", які не відповідають повідомленням, надісланим через Ayrshare. Це відлуння повідомлень, надісланих іншим додатком Messenger на Вашій Page (Meta доставляє копію кожного надсилання кожному підписаному додатку). Якщо Ваша інтеграція узгоджує вихідний трафік з Вашою власною історією надсилань, Ви можете використовувати цю історію, щоб відрізнити Ваші надсилання від надсилань конкуруючого додатка.
Для Pages лише з встановленим Ayrshare (без конкуруючого додатка Messenger) єдиною спостережуваною зміною є нова подія Message Edit — все інше виглядає ідентично попередній поведінці.

Події New Message

Сповіщення, коли надсилається або отримується нове повідомлення.

Подія Message Read

Сповіщення, коли повідомлення прочитане одержувачем.
Коли повідомлення прочитано в Instagram, payload webhook включає поле mid, яке однозначно ідентифікує, яке конкретне повідомлення було прочитано. Для повідомлень Facebook прочитання повідомлень відстежується на рівні розмови за допомогою conversationId. Коли відбувається подія прочитання, всі повідомлення в цій розмові з timestamps до created (або read) timestamp слід вважати прочитаними користувачем.

Події Reaction Created і Deleted

Сповіщення, коли реакція, наприклад like, створена або видалена на повідомленні.

Подія Message Edit

Сповіщення, коли користувач редагує повідомлення, яке раніше надсилав. Доступно для прямих повідомлень Facebook та Instagram. Поле messageEdit.mid збігається з id оригінальної події messageCreated, тому споживачі можуть корелювати редагування з оригінальним повідомленням. Поле messageEdit.text містить новий, відредагований текст повідомлення.

WhatsApp Message Status

WhatsApp відстежує стан доставки для кожного повідомлення на збережених вихідних повідомленнях за допомогою одного поля status: sent, delivered, read або failed. Ці оновлення наразі не доставляються на ваш зареєстрований URL webhook як окремі події. Якщо вам потрібен стан доставки в реальному часі, зверніться до вашого представника з облікового запису Ayrshare.

Batch Action

Сповіщення, коли пакет завершив обробку і файл доступний, наприклад get all user profiles. Ви можете отримати доступ до файлу за попередньо підписаним URL у полі url.

Подія Batch

Feed Action

Сповіщення, коли знайдено новий елемент RSS-стрічки для зареєстрованих RSS-стрічок. Примітка: якщо Webhook активний, нові елементи RSS не публікуватимуться автоматично у соціальних мережах.

Подія Feed

Mentions Action

Сповіщення, коли Ваш під’єднаний обліковий запис згадується. Доступно для Facebook та Instagram.
Для Instagram достатньо зареєструвати webhook mentions, щоб отримувати події згадувань. Доповнення Messaging, увімкнення месенджингу та повторне під’єднання соціального облікового запису не потрібні.
Ayrshare передає нативний payload згадування Meta без змін, додаючи лише стандартні поля конверта (action, refId, hookId, url та timeStamp з Webhook Security) та subAction. Приклад нижче — форма Instagram: media_id, плюс comment_id, коли згадування в коментарі. Згадування Події згадок на сторінках Facebook наразі не доставляються — Ayrshare підтверджує їх отримання від Meta й не пересилає на ваш webhook. Сьогодні доставляються лише згадки Instagram.

Подія Mention (Instagram)

Comments Action

Сповіщення, коли створено коментар на Вашому під’єднаному контенті. Доступно для Facebook та Instagram.
Для Instagram достатньо зареєструвати webhook comments, щоб отримувати події коментарів. Доповнення Messaging, увімкнення месенджингу та повторне під’єднання соціального облікового запису не потрібні.
Ayrshare передає нативний payload коментарів Meta без змін, додаючи лише стандартні поля конверта (action, refId, hookId, url та timeStamp з Webhook Security) та subAction. Приклад нижче — форма Instagram. Коментарі Facebook надходять як зміна feed на Page з різними назвами полів (наприклад comment_id, post_id, message та from.name); зверніться до довідки webhook Meta для набору полів Facebook.

Подія Comment (Instagram)

Automations Action

Сповіщення, коли автоматизація активує webhook-дію для користувача, наприклад тригер автовідповіді на коментар або DM.

Подія Automation

Demo Action

Сповіщення про події життєвого циклу Demo User Profile. Demo User Profiles доступні на Enterprise plan; будь ласка, зв’яжіться з нами, якщо хочете дізнатися більше. На дію demo надсилаються два типи подій, які розрізняються за полем type:
  • upgradeWarning — надсилається за два дні до того, як Demo User Profile автоматично перетвориться на стандартний User Profile, щоб ви могли запропонувати користувачу продовжити або видалити профіль.
  • upgrade — надсилається, коли відбувається конвертація.

Подія Demo Upgrade Warning

Подія Demo Upgrade