Pular para o conteúdo principal
GET
Obtenha mensagens ou conversas de uma plataforma de mensagens. Os tempos de recuperação diferem em cada rede social. No Facebook e Instagram, as mensagens estão disponíveis via Ayrshare em tempo real. No X/Twitter, há um atraso de até 3 minutos para ver novas atualizações de mensagens. Entre em contato com o suporte para saber mais sobre o Enterprise Plan se você precisar de acesso em tempo real às mensagens do X/Twitter.
Cache de respostas: as respostas do GET messages são armazenadas em cache para otimizar o desempenho. Para Facebook e Instagram, as respostas são armazenadas em cache por 60 segundos. Para X/Twitter, as respostas são armazenadas em cache por 15 segundos para suportar melhor o polling. Os campos lastUpdated e nextUpdate na resposta indicam quando os dados foram buscados pela última vez e quando dados atualizados estarão disponíveis.
A recuperação inicial do histórico de mensagens para Facebook e Instagram é limitada às últimas 20 mensagens. Consulte a seção Recuperação do histórico de mensagens para Facebook e Instagram para mais informações.

Parâmetros do header

Parâmetros de path

platform
string
obrigatório
A plataforma para obter a mensagem: facebook, instagram, twitter

Parâmetros de query

status
string
padrão:"active"
obrigatório
Retorna conversas ativas ou arquivadas. Valores: active ou archived.
conversationId
string
Retorna apenas a conversa específica.
conversationsOnly
boolean
padrão:false
Retorna todas as conversas. Se true, o campo conversationId é ignorado.
limit
integer
Apenas X/Twitter. Limita o número de mensagens retornadas por requisição (1–100). Permite polling eficiente sem uma sincronização completa do histórico. Use com next para paginação. Se omitido, o comportamento padrão (recuperação completa de mensagens) é usado.
next
string
Apenas X/Twitter. Cursor de paginação criptografado retornado do campo meta.pagination.next de uma requisição anterior. Use com limit para buscar a próxima página de resultados.