Перейти до основного вмісту
Messaging API дає змогу керувати прямими повідомленнями (DM) з кореспондентами, які звертаються до ваших User Profiles. Кореспондент — це особа, з якою ваш користувач (User Profile) спілкується. Розмова — це серія повідомлень між вашим користувачем (User Profile) та його кореспондентом.
  • Messaging API входить до всіх планів Ayrshare Business Plans та доступна як платне доповнення для планів Premium.
  • Як для планів Business, так і для Premium, ви маєте активувати Messaging на сторінці Account у панелі Ayrshare.
  • Обмін повідомленнями доступний для Facebook Messenger, Instagram Direct Messenger та X Direct Messages.

Дізнайтеся більше про Messaging API

Ключові функції обміну повідомленнями

  • Керуйте розмовами ваших користувачів з кореспондентами.
  • Надсилання текстових, зображень, відео та emoji-повідомлень від імені ваших користувачів.
  • Отримання повних історій розмов.
  • Налаштування автоматичних відповідей на повідомлення.
  • Отримання оновлень у режимі реального часу через вебхуки для отриманих повідомлень, реакцій на повідомлення та підтверджень прочитання.

Увімкнення обміну повідомленнями

Увімкніть ваш обліковий запис Ayrshare та User Profiles

Спершу вам потрібно увімкнути обмін повідомленнями для вашого загального облікового запису Ayrshare, щоб керувати DM. У панелі Ayrshare перейдіть на сторінку Account і натисніть кнопку “Learn More”, а потім “Enable”. На цьому етапі ви увімкнули обмін повідомленнями для вашого загального облікового запису, але не активували обмін повідомленнями для окремих User Profiles. Ви можете активувати обмін повідомленнями для окремих User Profiles або на сторінці User Profiles, натиснувши прапорець “Messaging Active” для кожного профілю, або за допомогою ендпоінту створення чи оновлення profiles endpoint. Після увімкнення обміну повідомленнями для User Profile ви маєте повторно підключити соціальний обліковий запис (Facebook та Instagram) на сторінці Social Accounts/Social Linking. Після увімкнення ви побачите бейдж “Messaging” на підключеному соціальному обліковому записі. Messaging badge

Увімкнення обміну повідомленнями в застосунку Instagram

Можливо, вам потрібно буде увімкнути обмін повідомленнями для вашого облікового запису Instagram:
  • Перейдіть до свого профілю в мобільному застосунку Instagram і торкніться значка меню ≡ у верхньому правому куті, щоб перейти на сторінку Settings and activity.
  • Прокрутіть вниз до розділу How others can interact with you.
  • Натисніть Messages and story replies.
  • Торкніться Message requests.
  • Під Connected tool увімкніть перемикач Allow access to messages.

Важлива інформація про обмін повідомленнями

Розмова має бути ініційована кореспондентом. Після встановлення розмови ви можете вільно надсилати повідомлення, отримувати повідомлення, отримувати реакції (наприклад, лайки) або підтвердження прочитання від імені ваших користувачів.
Ваш користувач має відповісти на розмову в Instagram протягом 7 днів після останнього повідомлення, надісланого кореспондентом. Якщо кореспондент не надсилав повідомлення протягом 7 днів, розмова вважається неактивною, і на неї не можна відповісти.

Отримання історії повідомлень для Facebook та Instagram

Коли ви вперше вмикаєте обмін повідомленнями для профілю користувача з підключеним Facebook або Instagram, існують важливі обмеження щодо доступу до історії розмов:

Обмеження початкового підключення

  • Facebook та Instagram дозволяють отримувати лише останні 20 повідомлень з існуючих розмов при першому підключенні облікового запису для обміну повідомленнями
  • Якщо розмова має понад 20 повідомлень, спочатку буде доступно лише 20 останніх

Після початкового налаштування

  • Після увімкнення обміну повідомленнями усі нові повідомлення, надіслані та отримані, будуть повністю доступні
  • Ayrshare підтримує повну історію розмов надалі
  • Наприклад: якщо ви спочатку отримуєте 20 повідомлень, потім обмінюєтеся 100 новими повідомленнями, ви зможете отримати доступ до всіх 120 повідомлень
Це обмеження стосується лише історичних повідомлень, які існували до увімкнення обміну повідомленнями — вся майбутня активність розмов для Facebook та Instagram буде повністю збережена та доступна.

Ліміт розмов та ціноутворення

  • Кожен Ayrshare User Profile може мати до 1000 активних розмов за платіжний цикл. Кількість активних розмов — це сума по всіх соціальних мережах.
  • План Premium: Messaging — це фіксоване доповнення $49 на місяць на обліковий запис.
  • Плани Launch і Business: Messaging тарифікується $0.09 за активну розмову через Stripe metered billing. Доступні знижки залежно від обсягу; зверніться до вашого представника з облікового запису Ayrshare для отримання деталей.
  • Розмова вважається активною для платіжного циклу, коли ви надсилаєте повідомлення отримувачу. Вхідні повідомлення від отримувача самі по собі не позначають розмову як активну.
  • Якщо ліміт у 1000 розмов досягнуто, ви все ще можете отримувати повідомлення, але не зможете відповідати до початку наступного платіжного циклу.
  • Кількість надісланих або отриманих повідомлень в активній розмові необмежена.
  • Якщо вам потрібно збільшити ліміт розмов, будь ласка, зв’яжіться з вашим представником з облікового запису Ayrshare.
Ви можете переглянути поточну кількість розмов за допомогою user endpoint.

Проблеми з контролем обміну повідомленнями у Facebook та Instagram

Meta (Facebook та Instagram) використовує систему “контролю потоку” для розмов. Це означає, що лише один застосунок може надсилати повідомлення в розмові одночасно, тоді як інші застосунки можуть лише отримувати повідомлення.

Що це означає?

Якщо ви бачите помилку “Message failed to send because another app is controlling this thread now”, це означає:
  • Інший сторонній застосунок наразі контролює цю розмову
  • Ayrshare може лише отримувати повідомлення в цій розмові
  • Ayrshare не може надсилати повідомлення, доки не поверне контроль

Як виправити цю проблему

Щоб дозволити Ayrshare знову надсилати повідомлення, вам потрібно видалити сторонній застосунок, який контролює розмову. Зверніть увагу, що Meta (Facebook та Instagram) може оновити процес видалення сторонніх застосунків, тому використовуйте наступні кроки як загальний орієнтир. Для сторінок Facebook:
  1. Перейдіть на Facebook.com і увійдіть у свій обліковий запис
  2. Натисніть меню (☰) у верхньому правому куті → Settings & PrivacySettings
  3. У лівій бічній панелі натисніть Apps and Websites
  4. Знайдіть сторонній застосунок, який контролює ваш обмін повідомленнями
  5. Натисніть Remove поруч із цим застосунком
  6. Підтвердьте видалення
Для бізнес-облікових записів Instagram:
  1. Відкрийте застосунок Instagram на вашому телефоні
  2. Перейдіть до Profile → торкніться меню (☰) → Settings and Privacy
  3. Торкніться Apps and Websites
  4. Знайдіть і видаліть сторонній застосунок
Альтернатива для Instagram:
  1. Перейдіть на business.facebook.com
  2. Перейдіть до Business Settings
  3. Під Accounts натисніть Instagram Accounts
  4. Виберіть ваш обліковий запис Instagram
  5. Перевірте підключені застосунки та видаліть проблемний

Після видалення

Після видалення стороннього застосунку:
  • Контроль над потоком автоматично повернеться до Ayrshare
  • Ви зможете знову надсилати повідомлення нормально
  • Жодних додаткових дій з вашого боку не потрібно
Якщо ви продовжуєте стикатися з проблемами після видалення застосунку, будь ласка, зв’яжіться з нашою командою підтримки.

Message WebHooks

Див. Messages Webhooks, щоб автоматично отримувати повідомлення, підтвердження прочитання або реакції.