profile.update.bio, post.create, post.delete, etc., y filtrar por el User ID cuyos eventos quiera recibir. Los eventos coincidentes para ese User ID se entregarán a tu app con una latencia inferior a un segundo.
Mecanismos de entrega
La X Activity API admite actualmente los siguientes mecanismos de entrega para enviar eventos a tu app:- Stream HTTP persistente
- Webhook
Tipos de eventos admitidos
Actualmente, la X Activity API admite los siguientes tipos de eventos, organizados por categoría:Eventos de Post
Los eventos de Post se activan cuando un usuario crea o elimina un Post.Eventos de Post mediante XAA vs Filtered Stream: La X Activity API admite los eventos
post.create y post.delete. Suscríbete por user_id para recibir notificaciones en tiempo real cuando los usuarios creen o eliminen Posts.Si necesitas filtrado dirigido por palabras clave, lógica booleana, segmentación geográfica, filtros de idioma o cualquiera de los demás operadores que admite el Filtered Stream, utiliza en su lugar el endpoint Filtered Stream.Eventos de seguimiento
Los eventos de seguimiento se activan cuando el usuario filtrado sigue a otro usuario, o cuando es seguido por otro usuario.Eventos de perfil
Los eventos de perfil se activan cuando un usuario realiza cambios en la información de su perfil.Eventos de chat
Los eventos de chat corresponden a la nueva pila de mensajería cifrada, o XChat.Eventos heredados de DM
Los eventos heredados de DM corresponden al sistema heredado de DM sin cifrar.Eventos de noticias
Los eventos de noticias proporcionan actualizaciones sobre tendencias y titulares seleccionados por Grok.Solo Enterprise: El evento
news.new solo está disponible actualmente para cuentas de los niveles Enterprise y Partner.Eventos de Spaces
Los eventos de Spaces se activan cuando un usuario inicia o finaliza un Space.
En futuras versiones, XAA se ampliará para admitir más tipos de eventos, incluyendo interacciones sociales, interacción con contenido, funciones de monetización y mucho más. Seguiremos actualizando nuestra documentación cuando estén disponibles nuevos tipos de eventos.
Privacidad de los eventos y autenticación
La X Activity API distingue entre eventos públicos y eventos privados con paridad respecto a la app de X, como se explica a continuación.Eventos públicos
Los eventos públicos son actividades que una cuenta de usuario pública realiza de forma pública y que son visibles para todos los usuarios de X. Estos eventos son visibles para todos los usuarios en la plataforma X y no requieren autenticación OAuth por parte del usuario para poder visualizarse. Eventos públicos actuales:- Actualizaciones de perfil (biografía, foto, banner, ubicación, URL, cambios de nombre de usuario)
- Creación de Posts (
post.create) y eliminación (post.delete)
Eventos privados
Los eventos privados son actividades que requieren el consentimiento explícito del usuario mediante autenticación OAuth. El usuario debe autenticarse a través de X y dar permiso explícito a una app de desarrollador para acceder a estos eventos. Eventos privados actuales:- Me gusta (
like.create) - Chat cifrado recibido (
chat.received) - Chat cifrado enviado (
chat.sent) - DM recibido (
dm.received) - DM enviado (
dm.sent) - DM leído (
dm.read) - Indicador de escritura de DM (
dm.indicate_typing) - Menciones en Posts (
post.mention.create)
- El usuario debe autenticar tu aplicación mediante OAuth 2.0
- Tu aplicación debe obtener los scopes de OAuth correspondientes
- El usuario debe otorgar permiso explícito para que tu app acceda a estos eventos
- Las suscripciones a eventos privados solo se pueden crear para usuarios que hayan autorizado tu aplicación
Límites de suscripción
La X Activity API tiene distintos límites de suscripción según el nivel de tu cuenta:Endpoints
Configuración de la cuentaPara acceder a estos endpoints, necesitarás:
- Una cuenta de desarrollador aprobada.
- Autenticarte usando las claves y tokens de una App de desarrollador que esté ubicada dentro de un Project.