Saltar al contenido principal
GET
Obtén los mensajes o conversaciones de una plataforma de mensajería. Los tiempos de recuperación varían en cada red social. En Facebook e Instagram, los mensajes están disponibles a través de Ayrshare en tiempo real. En X/Twitter hay un retraso de hasta 3 minutos para ver las nuevas actualizaciones de mensajes. Ponte en contacto con soporte para obtener más información sobre el Enterprise Plan si necesitas acceso en tiempo real a los mensajes de X/Twitter.
Caché de respuestas: las respuestas de GET messages se almacenan en caché para optimizar el rendimiento. Para Facebook e Instagram, las respuestas se cachean durante 60 segundos. Para X/Twitter, se cachean durante 15 segundos para soportar mejor el sondeo (polling). Los campos lastUpdated y nextUpdate en la respuesta indican cuándo se obtuvieron los datos por última vez y cuándo estarán disponibles datos nuevos.
La recuperación inicial del historial de mensajes para Facebook e Instagram está limitada a los últimos 20 mensajes. Consulta la sección Recuperación del historial de mensajes para Facebook e Instagram para obtener más información.

Parámetros de cabecera

Parámetros de ruta

platform
string
requerido
La plataforma de la que obtener el mensaje: facebook, instagram, twitter

Parámetros de consulta

status
string
predeterminado:"active"
requerido
Devuelve conversaciones activas o archivadas. Valores: active o archived.
conversationId
string
Devuelve únicamente la conversación especificada.
conversationsOnly
boolean
predeterminado:false
Devuelve todas las conversaciones. Si es true, se ignora el campo conversationId.
limit
integer
Solo X/Twitter. Limita el número de mensajes devueltos por solicitud (1–100). Permite un sondeo eficiente sin sincronizar todo el historial. Úsalo junto con next para paginación. Si se omite, se utiliza el comportamiento predeterminado (recuperación completa de mensajes).
next
string
Solo X/Twitter. Cursor de paginación cifrado devuelto por el campo meta.pagination.next de una solicitud anterior. Úsalo junto con limit para obtener la siguiente página de resultados.