Guía de migración a la Account Activity API v2

Esta guía te ayuda a migrar desde la Account Activity API Enterprise heredada a la Account Activity API V2. La funcionalidad principal sigue siendo la misma, pero las estructuras de endpoints y los métodos de autenticación se han actualizado para mantener la coherencia con la X API v2.

​

Resumen de cambios

• Formato de la API: Los endpoints utilizan la ruta base /2/account_activity/ en lugar de /1.1/account_activity/.
• Gestión de webhooks: La creación, listado, validación (CRC) y eliminación de webhooks se gestionan mediante la V2 Webhooks API.
• Autenticación: Los endpoints V2 requieren uno de los siguientes:
  • OAuthUser (OAuth de 3 pasos) para acciones específicas de usuario (por ejemplo, suscribir a un usuario).
  • OAuth2 App Only (Bearer Token) para acciones a nivel de app (por ejemplo, listar/eliminar suscripciones).
  • V1.1 utilizaba requisitos variables, a menudo OAuth 1.0a.
• Mapeo de endpoints:

• Formatos de respuesta: Revisa las estructuras de respuesta de éxito y error en la documentación de la AAAPI.

Al migrar, actualiza tu código para usar las nuevas rutas base, ajusta los flujos de autenticación y gestiona los webhooks mediante la V2 Webhooks API.

​

Cómo migrar

• Decide un paquete:
  • Elige el paquete Enterprise o Self-serve para el acceso a la Account Activity API, teniendo en cuenta:
    • Número de webhooks necesarios.
    • Suscripciones actuales/proyectadas o usuarios autorizados.
    • Número de aplicaciones cliente de X.
    • Nivel de soporte deseado (foro vs. soporte enterprise gestionado 1:1).
    • Detalles de precios (contacta con ventas para Enterprise).
• Actualiza tu autenticación a OAuth 2.0:
  • Asegúrate de que tu X App tenga los permisos “Read, Write, and Access Direct Messages”.
  • Actualiza a OAuth 2.0 para los endpoints V2. Vuelve a autorizar a los usuarios si los scopes han cambiado.
  • Utiliza la Developer Console para gestionar:
    • OAuth 2.0 Access Token.
    • Client ID y Client Secret.
• Verifica o reconfigura tu webhook:
  • Utiliza tu URL de webhook existente o configura una nueva (por ejemplo, https://your\_domain.com/webhook/twitter).
  • Sigue la documentación de la V2 Webhooks API para registrar y gestionar tu webhook.
• Apps de ejemplo:
  • Servidor de webhook simple
    • Un único script de Python que muestra cómo responder a la verificación CRC y aceptar eventos POST.
  • Dashboard de ejemplo de la Account Activity API
    • Una app web escrita con bun.sh que te permite gestionar webhooks, suscripciones y recibir eventos en vivo directamente en la app.