profile.update.bio, post.create, post.delete etc., e filtrar pelo User ID cujos eventos deseja receber. Os eventos correspondentes a esse User ID serão entregues ao seu app com latência inferior a um segundo.
Mecanismos de entrega
Atualmente, a X Activity API oferece suporte aos seguintes mecanismos de entrega para enviar eventos ao seu app:- Stream HTTP persistente
- Webhook
Tipos de evento suportados
Atualmente, a X Activity API oferece suporte aos seguintes tipos de evento, organizados por categoria:Eventos de Post
Os eventos de Post são acionados quando um usuário cria ou exclui um Post.Eventos de Post via XAA vs Filtered Stream: A X Activity API oferece suporte aos eventos
post.create e post.delete. Assine por user_id para receber notificações em tempo real quando os usuários criarem ou excluírem Posts.Se você precisa de filtragem direcionada por palavras-chave, lógica booleana, segmentação geográfica, filtros de idioma ou qualquer um dos outros operadores que o Filtered Stream suporta, use o endpoint Filtered Stream em vez disso.Eventos de seguir
Os eventos de seguir são acionados quando o usuário filtrado segue outro usuário ou é seguido por outro usuário.Eventos de perfil
Os eventos de perfil são acionados quando um usuário faz alterações nas informações do seu perfil.Eventos de chat
Os eventos de chat referem-se à nova camada de mensagens criptografadas, ou XChat.Eventos de DM legados
Os eventos de DM legados referem-se ao sistema de DM legado, sem criptografia.Eventos de notícias
Os eventos de notícias fornecem atualizações sobre tópicos em alta e manchetes selecionados pelo Grok.Apenas Enterprise: O evento
news.new está disponível somente para contas nos níveis Enterprise e Partner no momento.Eventos de Spaces
Os eventos de Spaces são acionados quando um usuário inicia ou encerra um Space.
Em versões futuras, a XAA será expandida para oferecer suporte a tipos de evento adicionais, incluindo interações sociais, engajamento com conteúdo, recursos de monetização e muito mais. Continuaremos atualizando nossa documentação à medida que novos tipos de evento se tornarem disponíveis.
Privacidade e autenticação de eventos
A X Activity API distingue entre eventos públicos e eventos privados, em paridade com o app do X, conforme explicado abaixo.Eventos públicos
Os eventos públicos são atividades que uma conta de usuário pública realiza publicamente e que são visíveis a todos os usuários do X. Esses eventos são visíveis a todos os usuários na plataforma X e não exigem autenticação OAuth do usuário para serem visualizados. Eventos públicos atuais:- Atualizações de perfil (bio, foto, banner, localização, URL, alterações de nome de usuário)
- Criação de Post (
post.create) e exclusão (post.delete)
Eventos privados
Os eventos privados são atividades que exigem consentimento explícito do usuário por meio de autenticação OAuth. Um usuário precisa autenticar-se via X e conceder permissão explícita a um app de desenvolvedor para acessar esses eventos. Requisitos de autenticação para eventos privados:- O usuário precisa autenticar a sua aplicação via OAuth 2.0
- A sua aplicação precisa obter os escopos OAuth apropriados
- O usuário precisa conceder explicitamente permissão para que o seu app acesse esses eventos
- Assinaturas para eventos privados só podem ser criadas para usuários que autorizaram a sua aplicação
Limites de assinatura
A X Activity API tem diferentes limites de assinatura com base no nível da sua conta:Endpoints
Configuração da contaPara acessar esses endpoints, você precisará de:
- Uma conta de desenvolvedor aprovada.
- Autenticar-se usando as chaves e os tokens de um App de desenvolvedor que esteja localizado dentro de um Project.