Skip to main content
GET
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.
boolean
défaut:false
Retourne toutes les conversations. Si true, le champ 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
X/Twitter uniquement. Limite le nombre de messages renvoyés par requête (1–100). Permet un polling efficace sans synchronisation complète de l’historique. À utiliser avec next pour la pagination. S’il est omis, le comportement par défaut (récupération complète des messages) est utilisé.
string
X/Twitter uniquement. Curseur de pagination chiffré retourné par le champ meta.pagination.next d’une requête précédente. À utiliser avec limit pour récupérer la page de résultats suivante.