Skip to main content
GET
Отримайте повідомлення або розмови для платформи обміну повідомленнями. Час отримання відрізняється для кожної соціальної мережі. У Facebook, Instagram та WhatsApp повідомлення доступні через Ayrshare у режимі реального часу. У X/Twitter є затримка до 3 хвилин перед появою нових оновлень повідомлень. Будь ласка, зверніться до служби підтримки, щоб дізнатися більше про Enterprise-план, якщо вам потрібен доступ до повідомлень X/Twitter у режимі реального часу.
Кешування відповіді: для Facebook та Instagram відповіді кешуються 60 секунд. Для X/Twitter відповіді кешуються 15 секунд для кращої підтримки опитувань. WhatsApp читає повідомлення, вже отримані через webhooks Meta, тож нове отримане повідомлення може з’явитися одразу, щойно Ayrshare обробить свій webhook. Відповідь усе одно містить метадані lastUpdated та nextUpdate.
Початкове отримання історії повідомлень для Facebook та Instagram обмежене останніми 20 повідомленнями. Будь ласка, ознайомтеся з розділом Отримання історії повідомлень для Facebook та Instagram для отримання додаткової інформації.
Розмови WhatsApp ідентифікуються за номером телефону кореспондента (лише цифри, E.164 без провідного +). Збережене вихідне повідомлення може містити значення statussent, delivered, read або failed. Внутрішньо Ayrshare відстежує окремі поля statusSent, statusDelivered, statusRead та statusFailed, але вони виключені з відповіді API.
Повідомлення WhatsApp, надіслані через Send Message, наразі не додаються до історії Get Messages. Вхідні повідомлення WhatsApp, отримані через webhooks, зберігаються та повертаються тут.

Параметри заголовка

Параметри шляху

string
обов'язково
Платформа, з якої отримати повідомлення: facebook, instagram, twitter, whatsapp

Параметри запиту

string
за замовчуванням:"active"
обов'язково
Повернути активні або архівовані розмови. Значення: active або archived.
string
Повернути лише конкретну розмову.
boolean
за замовчуванням:false
Повернути всі розмови. Якщо true, поле conversationId ігнорується.
Коли conversationsOnly=true, деталі розмов повертаються в converstationsDetails. Це написання є частиною поточної відповіді API.
integer
Лише X/Twitter. Обмежте кількість повідомлень, що повертаються за один запит (1–100). Дозволяє ефективне опитування без повної синхронізації історії. Використовуйте з next для пагінації. Якщо не вказано, використовується стандартна поведінка (повне отримання повідомлень).
string
Лише X/Twitter. Зашифрований курсор пагінації, повернутий з поля meta.pagination.next попереднього запиту. Використовуйте з limit для отримання наступної сторінки результатів.