Огляд Messages API

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 та WhatsApp (Private Beta).

​

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

• Керуйте розмовами ваших користувачів з кореспондентами.
• Надсилання текстових, зображень, відео та 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 для WhatsApp

Підключіть обліковий запис WhatsApp Business через embedded signup від Meta безпосередньо з панелі Ayrshare:

• Вам знадобиться обліковий запис Meta Business Manager, WhatsApp Business Account (WABA) та придатний номер телефону. Meta перевіряє обліковий запис і номер телефону під час embedded signup.
• На сторінці Social Accounts натисніть Link на плитці WhatsApp. Ayrshare запустить спливаюче вікно embedded signup від Meta, яке проведе користувача через вибір/створення Business Manager, WABA та номера телефону, а також прийняття умов Meta.
• Коли реєстрацію завершено, Ayrshare підтверджує право власності на вибраний WABA та номер телефону, завершує реєстрацію та підписує обліковий запис на webhooks WhatsApp. Ви не вводите окремий реєстраційний PIN у панелі Ayrshare.

​

Важлива поведінка, специфічна для WhatsApp

• Одержувачі — це номери телефонів, а не ID. WhatsApp ідентифікує кореспондентів за номером телефону у форматі E.164 (лише цифри, без +). ID розмов, повернуті з Ayrshare, також є номером телефону кореспондента — на відміну від Facebook та Instagram, тут немає непрозорих ID розмов.
• 24-годинне вікно обслуговування клієнтів. WhatsApp Business дозволяє надсилати вільні вихідні повідомлення лише протягом 24 годин після останнього повідомлення від кореспондента. Поза цим вікном Meta відхиляє надсилання. Шаблонні повідомлення поза 24-годинним вікном наразі не підтримуються через Ayrshare.
• Звертайтеся до отримувача напряму через API. Передайте номер телефону отримувача до Send Message. Meta доставляє вільне повідомлення лише коли цей отримувач перебуває в межах 24-годинного вікна обслуговування клієнтів. Для «холодного» контакту потрібні схвалені шаблони, а Ayrshare наразі не підтримує надсилання шаблонів.
• Статус доставки використовує одне поле. Коли доступно для збереженого вихідного повідомлення, Get Messages повертає status як sent, delivered, read або failed. Оновлення статусу доставки та реакції WhatsApp наразі не надсилаються на зареєстрований URL webhook.
• Типи та розміри медіа відповідають опублікованим Meta лімітам WhatsApp Cloud API — зображення до 5 МБ, аудіо та відео до 16 МБ, документи до 100 МБ на момент написання.

​

Підтримувані медіа WhatsApp

• Image: .jpg, .jpeg, .png
• Video: .mp4, .3gp
• Audio: .aac, .amr, .mp3, .m4a, .ogg
• Document: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx

​

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

Можливо, вам потрібно буде увімкнути обмін повідомленнями для вашого облікового запису Instagram:

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

​

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

​

Отримання історії повідомлень для 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 & Privacy → Settings
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, щоб автоматично отримувати повідомлення, підтвердження прочитання або реакції.