Skip to main content
La Account Activity API (AAA) está siendo deprecada. Consulta la X Activity API (XAA) para la entrega de actividad de usuario en tiempo real en el futuro.
Este endpoint se ha actualizado para incluir metadatos de edición de Posts. Aprende más sobre estos metadatos en la página de fundamentos “Editar Posts”.Este endpoint se usa a menudo con los endpoints de Mensajes Directos. Hemos lanzado nuevos endpoints v2 de Mensajes Directos. Ten en cuenta que las Account Activity APIs Enterprise y Premium admiten mensajes uno a uno v2, pero aún no admiten conversaciones grupales.
Descripción general Enterprise La Account Activity API te brinda la capacidad de suscribirte a actividades en tiempo real relacionadas con una cuenta de usuario a través de webhooks. Esto significa que puedes recibir en tiempo real Posts, Mensajes Directos y otros eventos de cuenta de una o más de tus cuentas propias o suscritas a través de una única conexión. Recibirás todas las actividades relacionadas siguientes para cada suscripción de usuario en tu registro de webhook: Ten en cuenta - No entregamos datos de home timeline a través de la Account Activity API. Usa GET statuses/home_timeline para obtener estos datos.

Serie de videos

Consulta nuestra serie de videos de cuatro partes sobre la Account Activity API para ponerte al día.

Resumen de funcionalidades

Gestionar webhooks y usuarios suscritos

⏱ 10 min de lectura La Account Activity API enterprise te proporciona mensajes JSON basados en webhooks cada vez que hay eventos asociados a las cuentas de X suscritas a tu servicio. X entrega esas actividades a tu webhook registrado. En los siguientes pasos, aprenderás a gestionar webhooks y usuarios suscritos. Aprenderás a registrar, ver y eliminar, tanto webhooks como usuarios suscritos. Usaremos comandos cURL simples para hacer solicitudes a los distintos endpoints de la API. cURL es una herramienta de línea de comandos para obtener o enviar solicitudes usando la sintaxis de URL. Necesitarás: Antes de comenzar, te recomendamos que consultes nuestro repo de Github aquí que proporciona una app web de ejemplo y scripts auxiliares para empezar con la Account Activity API de X

Gestión de un webhook:

El uso de un webhook te brinda la capacidad de suscribirte a actividades en tiempo real relacionadas con una cuenta de usuario a través de una única conexión.
Empecemos registrando una nueva URL de webhook para el contexto de aplicación dado.La URL se validará mediante una solicitud CRC antes de guardar. Una vez que hayas registrado un webhook, asegúrate de documentar el ID del webhook, ya que lo necesitarás más adelante.Copia la siguiente solicitud cURL en tu línea de comandos después de realizar cambios en lo siguiente:
  • URL <URL> p. ej. https://yourdomain.com/webhooks/twitter/
  • Consumer key <CONSUMER_KEY> p. ej. xvz1evFS4wEEPTGEFPHBog
  • Access token <ACCESS_TOKEN> p. ej. 370773112-GmHxMAgYyLbNEtIKZeRNFsMKPR9EyMZeS9weJAEb

Gestión de usuarios suscritos:

Una vez que hayas registrado un Webhook, puedes agregar un usuario suscrito a la Account Activity API para comenzar a recibir sus actividades de cuenta.
Comenzaremos suscribiendo a un usuario para que recibas todos los tipos de eventos.Copia la siguiente solicitud cURL en tu línea de comandos después de realizar cambios en lo siguiente:
  • Webhook ID <:WEBHOOK_ID> p. ej. 1234567890
  • Nombre de la Consumer key <CONSUMER_KEY> p. ej. xvz1evFS4wEEPTGEFPHBog
  • Access token del usuario que se suscribe <SUBSCRIBING_USER'S_ACCESS_TOKEN> p. ej. 370773112-GmHxMAgYyLbNEtIKZeRNFsMKPR9EyMZeS9weJAEb
¡Buen trabajo! Ahora deberías poder gestionar tus webhooks y usuarios suscritos.

Artículos referenciados

Un video tutorial de la Account Activity API

En este video tutorial, aprenderás sobre las capacidades de los niveles premium y enterprise de la Account Activity API. Al final de este video, aprenderás sobre