Отримати повідомлення

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/messages/facebook

const apiKey = 'API_KEY';
const url = 'https://api.ayrshare.com/api/messages/facebook';

const headers = {
  'Authorization': `Bearer ${apiKey}`,
};

fetch(url, {
  method: 'GET',
  headers: headers,
})
  .then(response => {
    if (response.ok) {
      return response.json();
    } else {
      throw new Error(`Request failed. Status code: ${response.status}`);
    }
  })
  .then(data => {
    console.log('Response:', data);
  })
  .catch(error => {
    console.error('Error:', error.message);
  });

import requests

api_key = 'API_KEY'
url = 'https://api.ayrshare.com/api/messages/facebook'

headers = {
    'Authorization': f'Bearer {api_key}',
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    print('Response:', data)
else:
    print(f'Request failed. Status code: {response.status_code}')

<?php

$apiKey = 'API_KEY';
$url = 'https://api.ayrshare.com/api/messages/facebook';

$headers = [
    'Authorization: Bearer ' . $apiKey,
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if ($response === false) {
    $error = curl_error($ch);
    echo 'Error: ' . $error;
} else {
    $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

    if ($statusCode === 200) {
        $responseData = json_decode($response, true);
        print_r($responseData);
    } else {
        echo 'Request failed. Status code: ' . $statusCode;
    }
}

curl_close($ch);

?>

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using System.Text.Json;

class Program
{
    static async Task Main()
    {
        string apiKey = "API_KEY";
        string url = "https://api.ayrshare.com/api/messages/facebook";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);

        try
        {
            var response = await client.GetAsync(url);

            if (response.IsSuccessStatusCode)
            {
                var responseBody = await response.Content.ReadAsStringAsync();
                var responseData = JsonSerializer.Deserialize<dynamic>(responseBody);

                Console.WriteLine("Response:");
                Console.WriteLine(responseData);
            }
            else
            {
                Console.WriteLine($"Request failed. Status code: {response.StatusCode}");
            }
        }
        catch (HttpRequestException ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) {
        String apiKey = "API_KEY";
        String url = "https://api.ayrshare.com/api/messages/facebook";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Authorization", "Bearer " + apiKey)
                .GET()
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                String responseBody = response.body();
                System.out.println("Response:");
                System.out.println(responseBody);
            } else {
                System.out.println("Request failed. Status code: " + response.statusCode());
            }
        } catch (IOException | InterruptedException e) {
            System.out.println("Error: " + e.getMessage());
        }
    }
}

{
    "status": "success",
    "messages": [
        {
            "senderId": "106638148652444",
            "senderDetails": {
                "name": "Ayrshare"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:54:32.455Z",
            "action": "sent",
            "recipientId": "7101149746568444",
            "id": "m_JH6o-yS83JoxWmQaLrmgSaHwGtfTgQ",
            "message": "Howdy!",
            "platform": "facebook",
            "reactions": {
                "7101149746568522": "😆". // Reaction by the customer on the Howdy! message
            }
        },
        {
            "recipientDetails": {
                "name": "Sara Smith",
                "id": "736532028017333",
                "picture": "https://img.ayrshare.com/333/messages/facebook-eTZzhE2b.jpeg"
            },
            "senderId": "106638148652329",
            "attachments": [
                {
                    "type": "image",
                    "url": "https://scontent.xx.fbcdn.net/v/t1.15752-9/490986808_1193328359195158"
                }
            ],
            "conversationId": "t_3567590438533",
            "created": "2024-06-06T00:54:32.455Z",
            "action": "sent",
            "recipientId": "736532028017333",
            "id": "m_WJlfgzopxfdRM1wFTKYHKv7zh75P",
            "updated": "2024-06-06T00:54:32.455Z",
            "platform": "facebook",
            "senderDetails": {
                "name": "Ayrshare"
            }
        },
        {
            "senderId": "7101149746568444",
            "senderDetails": {
                "name": "John Smith",
                "profileImage": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:54:28.102Z",
            "action": "received",
            "recipientId": "106638148652329",
            "id": "m_HGbotYJUmf4AzyPlJ-2uZqHwGtfTgQihX",
            "message": "Look up!",
            "platform": "facebook"
        },
        {
            "senderId": "7101149746568444",
            "senderDetails": {
                "name": "John Smith",
                "profileImage": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:49:11.679Z",
            "action": "received",
            "recipientId": "106638148652444",
            "id": "m_jXoYQIwTXaq2u06PG6Z8vaHwGtfTgQ",
            "message": "How is the weather?",
            "platform": "facebook"
        }
    ],
    "lastUpdated": "2024-06-09T21:46:04.233Z",
    "nextUpdate": "2024-06-09T21:47:04.233Z"
}

{
    "status": "success",
    "messages": [
        {
            "id": "1893410668991234567",
            "conversationId": "1234567890-9876543210",
            "senderId": "9876543210",
            "created": "2024-06-09T21:30:00.000Z",
            "message": "Hey, how are you?",
            "action": "received",
            "senderDetails": {
                "name": "Jane Doe",
                "username": "janedoe"
            }
        },
        {
            "id": "1893410668991234566",
            "conversationId": "1234567890-9876543210",
            "senderId": "1234567890",
            "created": "2024-06-09T21:28:00.000Z",
            "message": "Hello!",
            "action": "sent",
            "senderDetails": {
                "name": "My Account",
                "username": "myaccount"
            }
        }
    ],
    "messagesCount": 2,
    "lastUpdated": "2024-06-09T21:46:04.233Z",
    "nextUpdate": "2024-06-09T21:46:19.233Z",
    "meta": {
        "pagination": {
            "hasMore": true,
            "limit": 5,
            "next": "eyJwYWdpbmF0aW9uVG9rZW4iOiIxODkzNDEwNjY4OTkxMjM0NTY1In0="
        }
    }
}

{
  "status": "success",
  "messages": [
    {
      "id": "wamid.HBgLMTQxNTU1NTEyMzQVAgARGBI3MEM3Q0NDQjlGRTUzMjJBNEUA",
      "conversationId": "14155551234",
      "senderId": "14155551234",
      "recipientId": "123456789012345",
      "created": "2026-05-18T17:10:02.000Z",
      "message": "When is my order shipping?",
      "action": "received",
      "platform": "whatsapp"
    },
    {
      "id": "wamid.HBgLMTQxNTU1NTEyMzQVAgARGBI4OUYxRkExNzE0M0EwQTYwM0EA",
      "conversationId": "14155551234",
      "senderId": "14155551234",
      "recipientId": "123456789012345",
      "created": "2026-05-18T17:08:41.000Z",
      "attachments": [
        {
          "type": "image",
          "url": "https://img.ayrshare.com/abc123/whatsapp/whatsapp_image_x9aB2pK7.jpg"
        }
      ],
      "action": "received",
      "platform": "whatsapp"
    }
  ],
  "lastUpdated": "2026-05-18T17:13:00.000Z",
  "nextUpdate": "2026-05-18T17:14:00.000Z"
}

{
  "status": "success",
  "conversationIds": ["14155551234", "447700900123"],
  "converstationsDetails": [
    {
      "id": "14155551234",
      "participant": {
        "id": "14155551234",
        "name": "Jane Customer"
      },
      "status": "active",
      "unread": 2
    },
    {
      "id": "447700900123",
      "participant": {
        "id": "447700900123"
      },
      "status": "active",
      "unread": 0
    }
  ],
  "lastUpdated": "2026-05-18T17:13:00.000Z",
  "nextUpdate": "2026-05-18T17:14:00.000Z"
}

{
  "status": "success",
  "conversationIds": ["t_10161117434308444", "t_356759043857444"],
  "conversationsDetails": [
    {
      "id": "t_10161117434308444",
      "participant": {
        "name": "John Smith",
        "id": "7101149746568444",
        "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
      },
      "status": "active",
      "watermark": 1717889607444
    },
    {
      "id": "t_356759043857444",
      "participant": {
        "name": "Sara Johnson",
        "id": "7365320280173444",
        "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
      },
      "status": "active"
    }
  ],
  "lastUpdated": "2024-06-09T21:46:04.233Z",
  "nextUpdate": "2024-06-09T21:47:04.233Z"
}

{
  "action": "messages",
  "status": "error",
  "code": 361,
  "message": "Messaging is not enabled for this User Profile. Please subscribe to Messaging and activate Messaging for this User Profile."
}

{
  "action": "messages",
  "status": "error",
  "code": 362,
  "message": "Соціальну мережу потрібно повторно підключити для доступу до Messaging. Будь ласка, відв'яжіть, повторно підключіть та спробуйте ще раз.",
  "resolution": {
    "relink": true,
    "platform": "facebook"
  }
}

GET

messages

:platform

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/messages/facebook

const apiKey = 'API_KEY';
const url = 'https://api.ayrshare.com/api/messages/facebook';

const headers = {
  'Authorization': `Bearer ${apiKey}`,
};

fetch(url, {
  method: 'GET',
  headers: headers,
})
  .then(response => {
    if (response.ok) {
      return response.json();
    } else {
      throw new Error(`Request failed. Status code: ${response.status}`);
    }
  })
  .then(data => {
    console.log('Response:', data);
  })
  .catch(error => {
    console.error('Error:', error.message);
  });

import requests

api_key = 'API_KEY'
url = 'https://api.ayrshare.com/api/messages/facebook'

headers = {
    'Authorization': f'Bearer {api_key}',
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    print('Response:', data)
else:
    print(f'Request failed. Status code: {response.status_code}')

<?php

$apiKey = 'API_KEY';
$url = 'https://api.ayrshare.com/api/messages/facebook';

$headers = [
    'Authorization: Bearer ' . $apiKey,
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if ($response === false) {
    $error = curl_error($ch);
    echo 'Error: ' . $error;
} else {
    $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

    if ($statusCode === 200) {
        $responseData = json_decode($response, true);
        print_r($responseData);
    } else {
        echo 'Request failed. Status code: ' . $statusCode;
    }
}

curl_close($ch);

?>

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using System.Text.Json;

class Program
{
    static async Task Main()
    {
        string apiKey = "API_KEY";
        string url = "https://api.ayrshare.com/api/messages/facebook";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);

        try
        {
            var response = await client.GetAsync(url);

            if (response.IsSuccessStatusCode)
            {
                var responseBody = await response.Content.ReadAsStringAsync();
                var responseData = JsonSerializer.Deserialize<dynamic>(responseBody);

                Console.WriteLine("Response:");
                Console.WriteLine(responseData);
            }
            else
            {
                Console.WriteLine($"Request failed. Status code: {response.StatusCode}");
            }
        }
        catch (HttpRequestException ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) {
        String apiKey = "API_KEY";
        String url = "https://api.ayrshare.com/api/messages/facebook";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Authorization", "Bearer " + apiKey)
                .GET()
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                String responseBody = response.body();
                System.out.println("Response:");
                System.out.println(responseBody);
            } else {
                System.out.println("Request failed. Status code: " + response.statusCode());
            }
        } catch (IOException | InterruptedException e) {
            System.out.println("Error: " + e.getMessage());
        }
    }
}

{
    "status": "success",
    "messages": [
        {
            "senderId": "106638148652444",
            "senderDetails": {
                "name": "Ayrshare"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:54:32.455Z",
            "action": "sent",
            "recipientId": "7101149746568444",
            "id": "m_JH6o-yS83JoxWmQaLrmgSaHwGtfTgQ",
            "message": "Howdy!",
            "platform": "facebook",
            "reactions": {
                "7101149746568522": "😆". // Reaction by the customer on the Howdy! message
            }
        },
        {
            "recipientDetails": {
                "name": "Sara Smith",
                "id": "736532028017333",
                "picture": "https://img.ayrshare.com/333/messages/facebook-eTZzhE2b.jpeg"
            },
            "senderId": "106638148652329",
            "attachments": [
                {
                    "type": "image",
                    "url": "https://scontent.xx.fbcdn.net/v/t1.15752-9/490986808_1193328359195158"
                }
            ],
            "conversationId": "t_3567590438533",
            "created": "2024-06-06T00:54:32.455Z",
            "action": "sent",
            "recipientId": "736532028017333",
            "id": "m_WJlfgzopxfdRM1wFTKYHKv7zh75P",
            "updated": "2024-06-06T00:54:32.455Z",
            "platform": "facebook",
            "senderDetails": {
                "name": "Ayrshare"
            }
        },
        {
            "senderId": "7101149746568444",
            "senderDetails": {
                "name": "John Smith",
                "profileImage": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:54:28.102Z",
            "action": "received",
            "recipientId": "106638148652329",
            "id": "m_HGbotYJUmf4AzyPlJ-2uZqHwGtfTgQihX",
            "message": "Look up!",
            "platform": "facebook"
        },
        {
            "senderId": "7101149746568444",
            "senderDetails": {
                "name": "John Smith",
                "profileImage": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:49:11.679Z",
            "action": "received",
            "recipientId": "106638148652444",
            "id": "m_jXoYQIwTXaq2u06PG6Z8vaHwGtfTgQ",
            "message": "How is the weather?",
            "platform": "facebook"
        }
    ],
    "lastUpdated": "2024-06-09T21:46:04.233Z",
    "nextUpdate": "2024-06-09T21:47:04.233Z"
}

{
    "status": "success",
    "messages": [
        {
            "id": "1893410668991234567",
            "conversationId": "1234567890-9876543210",
            "senderId": "9876543210",
            "created": "2024-06-09T21:30:00.000Z",
            "message": "Hey, how are you?",
            "action": "received",
            "senderDetails": {
                "name": "Jane Doe",
                "username": "janedoe"
            }
        },
        {
            "id": "1893410668991234566",
            "conversationId": "1234567890-9876543210",
            "senderId": "1234567890",
            "created": "2024-06-09T21:28:00.000Z",
            "message": "Hello!",
            "action": "sent",
            "senderDetails": {
                "name": "My Account",
                "username": "myaccount"
            }
        }
    ],
    "messagesCount": 2,
    "lastUpdated": "2024-06-09T21:46:04.233Z",
    "nextUpdate": "2024-06-09T21:46:19.233Z",
    "meta": {
        "pagination": {
            "hasMore": true,
            "limit": 5,
            "next": "eyJwYWdpbmF0aW9uVG9rZW4iOiIxODkzNDEwNjY4OTkxMjM0NTY1In0="
        }
    }
}

{
  "status": "success",
  "messages": [
    {
      "id": "wamid.HBgLMTQxNTU1NTEyMzQVAgARGBI3MEM3Q0NDQjlGRTUzMjJBNEUA",
      "conversationId": "14155551234",
      "senderId": "14155551234",
      "recipientId": "123456789012345",
      "created": "2026-05-18T17:10:02.000Z",
      "message": "When is my order shipping?",
      "action": "received",
      "platform": "whatsapp"
    },
    {
      "id": "wamid.HBgLMTQxNTU1NTEyMzQVAgARGBI4OUYxRkExNzE0M0EwQTYwM0EA",
      "conversationId": "14155551234",
      "senderId": "14155551234",
      "recipientId": "123456789012345",
      "created": "2026-05-18T17:08:41.000Z",
      "attachments": [
        {
          "type": "image",
          "url": "https://img.ayrshare.com/abc123/whatsapp/whatsapp_image_x9aB2pK7.jpg"
        }
      ],
      "action": "received",
      "platform": "whatsapp"
    }
  ],
  "lastUpdated": "2026-05-18T17:13:00.000Z",
  "nextUpdate": "2026-05-18T17:14:00.000Z"
}

{
  "status": "success",
  "conversationIds": ["14155551234", "447700900123"],
  "converstationsDetails": [
    {
      "id": "14155551234",
      "participant": {
        "id": "14155551234",
        "name": "Jane Customer"
      },
      "status": "active",
      "unread": 2
    },
    {
      "id": "447700900123",
      "participant": {
        "id": "447700900123"
      },
      "status": "active",
      "unread": 0
    }
  ],
  "lastUpdated": "2026-05-18T17:13:00.000Z",
  "nextUpdate": "2026-05-18T17:14:00.000Z"
}

{
  "status": "success",
  "conversationIds": ["t_10161117434308444", "t_356759043857444"],
  "conversationsDetails": [
    {
      "id": "t_10161117434308444",
      "participant": {
        "name": "John Smith",
        "id": "7101149746568444",
        "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
      },
      "status": "active",
      "watermark": 1717889607444
    },
    {
      "id": "t_356759043857444",
      "participant": {
        "name": "Sara Johnson",
        "id": "7365320280173444",
        "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
      },
      "status": "active"
    }
  ],
  "lastUpdated": "2024-06-09T21:46:04.233Z",
  "nextUpdate": "2024-06-09T21:47:04.233Z"
}

{
  "action": "messages",
  "status": "error",
  "code": 361,
  "message": "Messaging is not enabled for this User Profile. Please subscribe to Messaging and activate Messaging for this User Profile."
}

{
  "action": "messages",
  "status": "error",
  "code": 362,
  "message": "Соціальну мережу потрібно повторно підключити для доступу до Messaging. Будь ласка, відв'яжіть, повторно підключіть та спробуйте ще раз.",
  "resolution": {
    "relink": true,
    "platform": "facebook"
  }
}

Отримайте повідомлення або розмови для платформи обміну повідомленнями. Час отримання відрізняється для кожної соціальної мережі. У 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 без провідного +). Збережене вихідне повідомлення може містити значення status — sent, 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

Повернути лише конкретну розмову.

string

Повертати лише повідомлення одного напрямку. Значення: sent або received. Не вказуйте, щоб отримати обидва.

boolean

за замовчуванням:false

Повертає розмови замість повідомлень. Повертає одну сторінку розмов — для решти йдіть за meta.pagination.next. Якщо true, conversationId ігнорується.

Коли conversationsOnly=true, деталі розмов повертаються в converstationsDetails. Це написання є частиною поточної відповіді API.

integer

Розмір сторінки для повідомлень і для списків розмов: ціле число від 1 до 100, типове й максимальне значення — 100.У X/Twitter limit також визначає, який набір повідомлень ви читаєте. Не передавайте його, щоб гортати збережені повідомлення — так працюють усі інші платформи, і саме тут застосовуються status, action і conversationsOnly. Передайте його, щоб замість цього гортати живу хронологію X через власний курсор X, який не застосовує жодного з цих трьох фільтрів.Цей вибір робить лише перший запит. Коли ви вже йдете за курсором, вирішує курсор: курсор збережених повідомлень і далі повертає збережені повідомлення, навіть якщо ви передасте limit, а курсор X і далі повертає живу хронологію, навіть якщо ви його не передасте. Перемкнутися між ними посеред гортання не можна.

string

Непрозорий курсор із meta.pagination.next. Передайте його як next із тим самим профілем, платформою та фільтрами. Продовжуйте, доки meta.pagination.hasMore дорівнює true, навіть якщо відфільтрована сторінка повернулася короткою або порожньою. У наступних запитах limit можна не вказувати (типово 100); у X/Twitter курсор уже фіксує, з якого набору він походить, тож передавання або пропуск limit не перемкне вас на інший.

Отримання наступної сторінки

Почніть із GET /api/messages/instagram?limit=100. Щоб продовжити, закодуйте отримане значення meta.pagination.next для URL і надішліть GET /api/messages/instagram?limit=100&next=<opaque cursor>. Параметр називається next, а не cursor. Зберігайте той самий Profile-Key і фільтри запиту впродовж усієї пагінації. Щоб вирішити, коли зупинитися, перевіряйте meta.pagination.hasMore, а не кількість результатів. Відфільтрований запит може повернути менше за limit результатів або порожню сторінку з продовженням, оскільки кожен запит сканує обмежену частину історії. Повідомлення у збереженій історії впорядковані від найновіших до найстаріших, а рівні позиції розв’язуються за ID документа. Списки розмов упорядковані за ID документа. Пагінація — це не заморожений знімок: нові повідомлення з’являються, коли ви перезапускаєте з першої сторінки, а зміна статусів розмов може змінити відфільтровані результати. Наявні поля повідомлень і написання converstationsDetails не змінилися. Інтеграції, які раніше очікували повний список з одного запиту — чи то повідомлень, чи розмов, на будь-якій платформі — мають слідувати за курсором продовження; збільшення limit понад 100 не підтримується.

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/messages/facebook

const apiKey = 'API_KEY';
const url = 'https://api.ayrshare.com/api/messages/facebook';

const headers = {
  'Authorization': `Bearer ${apiKey}`,
};

fetch(url, {
  method: 'GET',
  headers: headers,
})
  .then(response => {
    if (response.ok) {
      return response.json();
    } else {
      throw new Error(`Request failed. Status code: ${response.status}`);
    }
  })
  .then(data => {
    console.log('Response:', data);
  })
  .catch(error => {
    console.error('Error:', error.message);
  });

import requests

api_key = 'API_KEY'
url = 'https://api.ayrshare.com/api/messages/facebook'

headers = {
    'Authorization': f'Bearer {api_key}',
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    print('Response:', data)
else:
    print(f'Request failed. Status code: {response.status_code}')

<?php

$apiKey = 'API_KEY';
$url = 'https://api.ayrshare.com/api/messages/facebook';

$headers = [
    'Authorization: Bearer ' . $apiKey,
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if ($response === false) {
    $error = curl_error($ch);
    echo 'Error: ' . $error;
} else {
    $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

    if ($statusCode === 200) {
        $responseData = json_decode($response, true);
        print_r($responseData);
    } else {
        echo 'Request failed. Status code: ' . $statusCode;
    }
}

curl_close($ch);

?>

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using System.Text.Json;

class Program
{
    static async Task Main()
    {
        string apiKey = "API_KEY";
        string url = "https://api.ayrshare.com/api/messages/facebook";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);

        try
        {
            var response = await client.GetAsync(url);

            if (response.IsSuccessStatusCode)
            {
                var responseBody = await response.Content.ReadAsStringAsync();
                var responseData = JsonSerializer.Deserialize<dynamic>(responseBody);

                Console.WriteLine("Response:");
                Console.WriteLine(responseData);
            }
            else
            {
                Console.WriteLine($"Request failed. Status code: {response.StatusCode}");
            }
        }
        catch (HttpRequestException ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) {
        String apiKey = "API_KEY";
        String url = "https://api.ayrshare.com/api/messages/facebook";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Authorization", "Bearer " + apiKey)
                .GET()
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                String responseBody = response.body();
                System.out.println("Response:");
                System.out.println(responseBody);
            } else {
                System.out.println("Request failed. Status code: " + response.statusCode());
            }
        } catch (IOException | InterruptedException e) {
            System.out.println("Error: " + e.getMessage());
        }
    }
}

{
    "status": "success",
    "messages": [
        {
            "senderId": "106638148652444",
            "senderDetails": {
                "name": "Ayrshare"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:54:32.455Z",
            "action": "sent",
            "recipientId": "7101149746568444",
            "id": "m_JH6o-yS83JoxWmQaLrmgSaHwGtfTgQ",
            "message": "Howdy!",
            "platform": "facebook",
            "reactions": {
                "7101149746568522": "😆". // Reaction by the customer on the Howdy! message
            }
        },
        {
            "recipientDetails": {
                "name": "Sara Smith",
                "id": "736532028017333",
                "picture": "https://img.ayrshare.com/333/messages/facebook-eTZzhE2b.jpeg"
            },
            "senderId": "106638148652329",
            "attachments": [
                {
                    "type": "image",
                    "url": "https://scontent.xx.fbcdn.net/v/t1.15752-9/490986808_1193328359195158"
                }
            ],
            "conversationId": "t_3567590438533",
            "created": "2024-06-06T00:54:32.455Z",
            "action": "sent",
            "recipientId": "736532028017333",
            "id": "m_WJlfgzopxfdRM1wFTKYHKv7zh75P",
            "updated": "2024-06-06T00:54:32.455Z",
            "platform": "facebook",
            "senderDetails": {
                "name": "Ayrshare"
            }
        },
        {
            "senderId": "7101149746568444",
            "senderDetails": {
                "name": "John Smith",
                "profileImage": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:54:28.102Z",
            "action": "received",
            "recipientId": "106638148652329",
            "id": "m_HGbotYJUmf4AzyPlJ-2uZqHwGtfTgQihX",
            "message": "Look up!",
            "platform": "facebook"
        },
        {
            "senderId": "7101149746568444",
            "senderDetails": {
                "name": "John Smith",
                "profileImage": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
            },
            "conversationId": "t_10161117434308444",
            "created": "2024-06-06T00:49:11.679Z",
            "action": "received",
            "recipientId": "106638148652444",
            "id": "m_jXoYQIwTXaq2u06PG6Z8vaHwGtfTgQ",
            "message": "How is the weather?",
            "platform": "facebook"
        }
    ],
    "lastUpdated": "2024-06-09T21:46:04.233Z",
    "nextUpdate": "2024-06-09T21:47:04.233Z"
}

{
    "status": "success",
    "messages": [
        {
            "id": "1893410668991234567",
            "conversationId": "1234567890-9876543210",
            "senderId": "9876543210",
            "created": "2024-06-09T21:30:00.000Z",
            "message": "Hey, how are you?",
            "action": "received",
            "senderDetails": {
                "name": "Jane Doe",
                "username": "janedoe"
            }
        },
        {
            "id": "1893410668991234566",
            "conversationId": "1234567890-9876543210",
            "senderId": "1234567890",
            "created": "2024-06-09T21:28:00.000Z",
            "message": "Hello!",
            "action": "sent",
            "senderDetails": {
                "name": "My Account",
                "username": "myaccount"
            }
        }
    ],
    "messagesCount": 2,
    "lastUpdated": "2024-06-09T21:46:04.233Z",
    "nextUpdate": "2024-06-09T21:46:19.233Z",
    "meta": {
        "pagination": {
            "hasMore": true,
            "limit": 5,
            "next": "eyJwYWdpbmF0aW9uVG9rZW4iOiIxODkzNDEwNjY4OTkxMjM0NTY1In0="
        }
    }
}

{
  "status": "success",
  "messages": [
    {
      "id": "wamid.HBgLMTQxNTU1NTEyMzQVAgARGBI3MEM3Q0NDQjlGRTUzMjJBNEUA",
      "conversationId": "14155551234",
      "senderId": "14155551234",
      "recipientId": "123456789012345",
      "created": "2026-05-18T17:10:02.000Z",
      "message": "When is my order shipping?",
      "action": "received",
      "platform": "whatsapp"
    },
    {
      "id": "wamid.HBgLMTQxNTU1NTEyMzQVAgARGBI4OUYxRkExNzE0M0EwQTYwM0EA",
      "conversationId": "14155551234",
      "senderId": "14155551234",
      "recipientId": "123456789012345",
      "created": "2026-05-18T17:08:41.000Z",
      "attachments": [
        {
          "type": "image",
          "url": "https://img.ayrshare.com/abc123/whatsapp/whatsapp_image_x9aB2pK7.jpg"
        }
      ],
      "action": "received",
      "platform": "whatsapp"
    }
  ],
  "lastUpdated": "2026-05-18T17:13:00.000Z",
  "nextUpdate": "2026-05-18T17:14:00.000Z"
}

{
  "status": "success",
  "conversationIds": ["14155551234", "447700900123"],
  "converstationsDetails": [
    {
      "id": "14155551234",
      "participant": {
        "id": "14155551234",
        "name": "Jane Customer"
      },
      "status": "active",
      "unread": 2
    },
    {
      "id": "447700900123",
      "participant": {
        "id": "447700900123"
      },
      "status": "active",
      "unread": 0
    }
  ],
  "lastUpdated": "2026-05-18T17:13:00.000Z",
  "nextUpdate": "2026-05-18T17:14:00.000Z"
}

{
  "status": "success",
  "conversationIds": ["t_10161117434308444", "t_356759043857444"],
  "conversationsDetails": [
    {
      "id": "t_10161117434308444",
      "participant": {
        "name": "John Smith",
        "id": "7101149746568444",
        "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
      },
      "status": "active",
      "watermark": 1717889607444
    },
    {
      "id": "t_356759043857444",
      "participant": {
        "name": "Sara Johnson",
        "id": "7365320280173444",
        "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic/"
      },
      "status": "active"
    }
  ],
  "lastUpdated": "2024-06-09T21:46:04.233Z",
  "nextUpdate": "2024-06-09T21:47:04.233Z"
}

{
  "action": "messages",
  "status": "error",
  "code": 361,
  "message": "Messaging is not enabled for this User Profile. Please subscribe to Messaging and activate Messaging for this User Profile."
}

{
  "action": "messages",
  "status": "error",
  "code": 362,
  "message": "Соціальну мережу потрібно повторно підключити для доступу до Messaging. Будь ласка, відв'яжіть, повторно підключіть та спробуйте ще раз.",
  "resolution": {
    "relink": true,
    "platform": "facebook"
  }
}

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

Отримати повідомлення

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

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

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

Отримання наступної сторінки

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

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

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

​Отримання наступної сторінки

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

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

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

Отримання наступної сторінки