Obtenir les messages

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": "Le réseau social doit être re-lié pour accéder à Messaging. Veuillez délier, re-lier, puis réessayer.",
  "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": "Le réseau social doit être re-lié pour accéder à Messaging. Veuillez délier, re-lier, puis réessayer.",
  "resolution": {
    "relink": true,
    "platform": "facebook"
  }
}

Obtenez les messages ou les conversations pour une plateforme de messagerie. Les délais de récupération diffèrent selon les réseaux sociaux. Sur Facebook, Instagram et WhatsApp, les messages sont disponibles via Ayrshare en temps réel. Sur X/Twitter, il y a un délai pouvant aller jusqu’à 3 minutes pour voir les nouvelles mises à jour de messages. Veuillez contacter le support pour en savoir plus sur le Plan Enterprise si vous avez besoin d’un accès en temps réel aux messages X/Twitter.

Mise en cache des réponses : pour Facebook et Instagram, les réponses sont mises en cache pendant 60 secondes. Pour X/Twitter, les réponses sont mises en cache pendant 15 secondes afin de mieux prendre en charge le polling. WhatsApp lit les messages déjà reçus via les webhooks de Meta, de sorte qu’un nouveau message reçu peut apparaître dès qu’Ayrshare traite son webhook. La réponse inclut toujours les métadonnées lastUpdated et nextUpdate.

La récupération initiale de l’historique des messages pour Facebook et Instagram est limitée aux 20 derniers messages. Veuillez consulter la section Récupération de l’historique des messages pour Facebook et Instagram pour plus d’informations.

Les conversations WhatsApp sont identifiées par le numéro de téléphone du correspondant (chiffres uniquement, au format E.164 sans le + initial). Un message sortant stocké peut inclure une valeur status égale à sent, delivered, read ou failed.

Les messages WhatsApp envoyés via Envoyer un message ne sont pas actuellement ajoutés à l’historique de Get Messages. Les messages WhatsApp entrants reçus via les webhooks sont stockés et retournés ici.

Paramètres d’en-tête

Paramètres de chemin

string

requis

La plateforme pour obtenir le message : facebook, instagram, twitter, whatsapp

Paramètres de requête

string

défaut:"active"

requis

Retourne les conversations actives ou les conversations archivées. Valeurs : active ou archived.

string

Retourne uniquement la conversation spécifique.

string

Ne renvoyer que les messages d’un seul sens. Valeurs : sent ou received. Omettez pour renvoyer les deux.

boolean

défaut:false

Renvoie les conversations plutôt que les messages. Renvoie une page de conversations — suivez meta.pagination.next pour le reste. Si true, conversationId est ignoré.

Lorsque conversationsOnly=true, les détails de la conversation sont retournés dans converstationsDetails. Cette orthographe fait partie de la réponse actuelle de l’API.

integer

Taille de page pour les messages et pour les listes de conversations : entier de 1 à 100, valeur par défaut et maximum 100.Sur X/Twitter, limit détermine aussi quel ensemble de messages vous lisez. Omettez-le pour parcourir vos messages stockés, ce que font toutes les autres plateformes et le seul cas où status, action et conversationsOnly s’appliquent. Fournissez-le pour parcourir à la place le fil en direct de X via le curseur propre à X, qui n’applique aucun de ces trois filtres.Ce choix n’est fait que par la première requête. Dès lors que vous suivez un curseur, c’est le curseur qui décide : un curseur de messages stockés continue de renvoyer des messages stockés même si vous envoyez limit, et un curseur X continue de renvoyer le fil en direct même si vous l’omettez. Vous ne pouvez pas passer de l’un à l’autre en cours de pagination.

string

Curseur opaque provenant de meta.pagination.next. Envoyez-le comme next avec le même profil, la même plateforme et les mêmes filtres. Continuez tant que meta.pagination.hasMore vaut true, même si une page filtrée revient courte ou vide. limit peut être omis lors des requêtes suivantes (100 par défaut) ; sur X/Twitter, le curseur enregistre déjà l’ensemble dont il provient, si bien qu’envoyer ou omettre limit ne vous fera pas basculer vers l’autre.

Récupérer la page suivante

Commencez par GET /api/messages/instagram?limit=100. Pour continuer, encodez en URL la valeur meta.pagination.next renvoyée et envoyez GET /api/messages/instagram?limit=100&next=<opaque cursor>. Le paramètre est next, pas cursor. Conservez la même Profile-Key et les mêmes filtres de requête tout au long de la pagination. Vérifiez meta.pagination.hasMore, et non le nombre de résultats, pour décider quand vous arrêter. Une requête filtrée peut renvoyer moins de limit résultats, ou une page vide avec une continuation, car chaque requête parcourt une portion bornée de l’historique. Les messages de l’historique stocké sont triés du plus récent au plus ancien, l’ID de document départageant les égalités. Les listes de conversations sont triées par ID de document. La pagination n’est pas un instantané figé : de nouveaux messages apparaissent lorsque vous repartez de la première page, et des changements de statut de conversation peuvent modifier les résultats filtrés. Les champs de message existants et l’orthographe converstationsDetails sont inchangés. Les intégrations qui attendaient auparavant une liste complète en une seule requête — qu’il s’agisse de messages ou de conversations, sur n’importe quelle plateforme — doivent suivre le curseur de continuation ; augmenter limit au-delà de 100 n’est pas pris en charge.

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": "Le réseau social doit être re-lié pour accéder à Messaging. Veuillez délier, re-lier, puis réessayer.",
  "resolution": {
    "relink": true,
    "platform": "facebook"
  }
}

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

Paramètres d’en-tête

Paramètres de chemin

Paramètres de requête

Récupérer la page suivante

​Paramètres d’en-tête

​Paramètres de chemin

​Paramètres de requête

​Récupérer la page suivante

Paramètres d’en-tête

Paramètres de chemin

Paramètres de requête

Récupérer la page suivante