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. Para ver um JSON de exemplo de cada tipo, consulte Payloads de eventos.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 curtida
Os eventos de curtida são acionados quando um usuário curte um Post ou quando um dos Posts do próprio usuário é curtido.Filtro de direção: O evento
like.create suporta um filtro direction opcional definido como outbound ou inbound. Use outbound para curtidas feitas pelo usuário e inbound para curtidas recebidas pelos Posts do usuário. Se nenhuma direction for especificada, tanto os eventos de curtida de entrada quanto os de saída serão entregues.Evento privado: like.create é um evento privado e requer autenticação no contexto do usuário (OAuth 2.0). Consulte Privacidade e autenticação de eventos abaixo.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.Eventos de silenciamento
Os eventos de silenciamento são acionados quando o usuário filtrado silencia ou dessilencia outro usuário.Eventos privados: Os eventos de silenciamento são privados e requerem autenticação no contexto do usuário (OAuth 2.0) com o escopo
mute.read. O filtro user_id corresponde ao usuário que executa a ação de silenciar ou dessilenciar — você não pode assinar notificações sobre um usuário sendo silenciado. Consulte Privacidade e autenticação de eventos abaixo.Eventos de bloqueio
Os eventos de bloqueio são acionados quando o usuário filtrado bloqueia ou desbloqueia outro usuário.Eventos privados: Os eventos de bloqueio são privados e requerem autenticação no contexto do usuário (OAuth 2.0) com o escopo
block.read. O filtro user_id corresponde ao usuário que executa a ação de bloquear ou desbloquear — você não pode assinar notificações sobre um usuário sendo bloqueado. Consulte Privacidade e autenticação de eventos abaixo.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. Eventos privados atuais:- Curtidas (
like.create) - Chat criptografado recebido (
chat.received) - Chat criptografado enviado (
chat.sent) - DM recebido (
dm.received) - DM enviado (
dm.sent) - DM lido (
dm.read) - Indicador de digitação de DM (
dm.indicate_typing) - Menções em Posts (
post.mention.create) - Silenciamentos (
mute.mute,mute.unmute) — requer o escopomute.read - Bloqueios (
block.block,block.unblock) — requer o escopoblock.read
- 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.