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.
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
-
¿Tienes preguntas? ¿Encontraste errores?
- Lee nuestras Preguntas frecuentes o la Guía de solución de errores.
-
Explora nuestro código de ejemplo:
- Panel de la Account Activity API enterprise, una app web node que muestra eventos de webhook usando el nivel enterprise de la Account Activity API e incluye funcionalidad Replay.
- El chatbot SnowBot, una app web Ruby construida sobre las APIs enterprise Account Activity y Direct Message.
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:- Una app de X registrada - regístrate aquí
- Un bearer token - más información
- Un webhook que pase una Challenge-Response Check (CRC) - más información
- Una cuenta enterprise - [solicítala aquí]https://developer.x.com/en/products/x-api/enterprise
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.- Añadir un webhook
- Ver un webhook
- Eliminar un webhook
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.- Añadir una suscripción
- Ver suscripciones
- Eliminar una suscripción
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
Artículos referenciados
- Descripción general del Challenge-Response Check (CRC)
- Tipos de datos de Account Activity
- Gestión de Webhooks y suscripciones