}
}
]
}
```
#### user\_event
```
{
"user_event": {
"revoke": {
"date_time": "2018-05-24T09:48:12+00:00",
"target": {
"app_id": "13090192"
},
"source": {
"user_id": "63046977"
}
}
}
}
```
#### direct\_message\_events
```
{
"for_user_id": "4337869213",
"direct_message_events": [{
"type": "message_create",
"id": "954491830116155396",
"created_timestamp": "1516403560557",
"message_create": {
"target": {
"recipient_id": "4337869213"
},
"sender_id": "3001969357",
"source_app_id": "13090192",
"message_data": {
"text": "Hello World!",
"entities": {
"hashtags": [],
"symbols": [],
"user_mentions": [],
"urls": []
}
}
}
}],
"apps": {
"13090192": {
"id": "13090192",
"name": "FuriousCamperTestApp1",
"url": "https://x.com/furiouscamper"
},
"users": {},
"3001969357": {
"id": "3001969357",
"created_timestamp": "1422556069340",
"name": "Jordan Brinks",
"screen_name": "furiouscamper",
"location": "Boulder, CO",
"description": "Alter Ego - X PE opinions-are-my-own",
"url": "https://t.co/SnxaA15ZuY",
"protected": false,
"verified": false,
"followers_count": 22,
"friends_count": 45,
"statuses_count": 494,
"profile_image_url": "null",
"profile_image_url_https": "https://pbs.twimg.com/profile_images/851526626785480705/cW4WTi7C_normal.jpg"
},
"4337869213": {
"id": "4337869213",
"created_timestamp": "1448312972328",
"name": "Harrison Test",
"screen_name": "Harris_0ff",
"location": "Burlington, MA",
"protected": false,
"verified": false,
"followers_count": 8,
"friends_count": 8,
"profile_image_url": "null",
"statuses_count": 240,
"profile_image_url_https": "https://abs.twimg.com/sticky/default_profile_images/default_profile_normal.png"
}
}
}
```
#### direct\_message\_indicate\_typing\_events
```
{
"for_user_id": "4337869213",
"direct_message_indicate_typing_events": [{
"created_timestamp": "1518127183443",
"sender_id": "3284025577",
"target": {
"recipient_id": "3001969357"
}
}],
"users": {
"3001969357": {
"id": "3001969357",
"created_timestamp": "1422556069340",
"name": "Jordan Brinks",
"screen_name": "furiouscamper",
"location": "Boulder, CO",
"description": "Alter Ego - X PE las-opiniones-son-mías",
"url": "https://t.co/SnxaA15ZuY",
"protected": false,
"verified": false,
"followers_count": 23,
"friends_count": 47,
"statuses_count": 509,
"profile_image_url": "null",
"profile_image_url_https": "https://pbs.twimg.com/profile_images/851526626785480705/cW4WTi7C_normal.jpg"
},
"3284025577": {
"id": "3284025577",
"created_timestamp": "1437281176085",
"name": "Bogus Bogart",
"screen_name": "bogusbogart",
"protected": true,
"verified": false,
"followers_count": 1,
"friends_count": 4,
"statuses_count": 35,
"profile_image_url": "null",
"profile_image_url_https": "https://pbs.twimg.com/profile_images/763383202857779200/ndvZ96mE_normal.jpg"
}
}
}
```
#### direct\_message\_mark\_read\_events
```
{
"for_user_id": "4337869213",
"direct_message_mark_read_events": [{
"created_timestamp": "1518452444662",
"sender_id": "199566737",
"target": {
"recipient_id": "3001969357"
},
"last_read_event_id": "963085315333238788"
}],
"users": {
"199566737": {
"id": "199566737",
"created_timestamp": "1286429788000",
"name": "Le Braat",
"screen_name": "LeBraat",
"location": "Denver, CO",
"description": "data by day @X, design by dusk",
"protected": false,
"verified": false,
"followers_count": 299,
"friends_count": 336,
"statuses_count": 752,
"profile_image_url": "null",
"profile_image_url_https": "https://pbs.twimg.com/profile_images/936652894371119105/YHEozVAg_normal.jpg"
},
"3001969357": {
"id": "3001969357",
"created_timestamp": "1422556069340",
"name": "Jordan Brinks",
"screen_name": "furiouscamper",
"location": "Boulder, CO",
"description": "Alter Ego - X PE opinions-are-my-own",
"url": "https://t.co/SnxaA15ZuY",
"protected": false,
"verified": false,
"followers_count": 23,
"friends_count": 48,
"statuses_count": 510,
"profile_image_url": "null",
"profile_image_url_https": "https://pbs.twimg.com/profile_images/851526626785480705/cW4WTi7C_normal.jpg"
}
}
}
```
```
{
"for_user_id": "930524282358325248",
"tweet_delete_events": [
{
"status": {
"id": "1045405559317569537",
"user_id": "930524282358325248"
},
"timestamp_ms": "1432228155593"
}
]
}
```
## API de Reproducción de Actividad de Cuenta
`Enterprise`
La API de Reproducción de Actividad de Cuenta es una herramienta de recuperación de datos que te permite recuperar eventos de hasta cinco días atrás. Debe utilizarse para recuperar datos en escenarios en los que tu servidor de [webhook](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#enterprise-account-activity-api) deja de recibir eventos, ya sea debido a desconexiones que duren más que la [ventana de reintentos](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#retries), o en aquellos escenarios de recuperación ante desastres en los que necesitas unos días para restaurar tu sistema a la normalidad.
La API de Reproducción de Actividad de Cuenta se desarrolló para cualquier escenario en el que no puedas ingestar [actividades](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity) durante un período de tiempo. Entrega actividades al mismo webhook utilizado para la entrega original en tiempo real de las actividades. Este producto es una herramienta de recuperación y no una herramienta de carga histórica (backfill), lo que significa que los eventos solo se reproducirán si se intentó una entrega previa de los mismos. La API de Reproducción de Actividad de Cuenta no puede entregar eventos correspondientes a un período anterior al momento de creación de una suscripción.
### Uso de Account Activity Replay API
Si tu cuenta está configurada con la funcionalidad de Replay, puedes realizar solicitudes de manera similar a las solicitudes a Account Activity API. Es importante tener en cuenta que tu solicitud debe especificar un parámetro webhook id para indicar las actividades de qué webhook deseas reproducir. En otras palabras, una solicitud de Replay le pide a Account Activity Replay API que recupere eventos desde una fecha y hora de inicio hasta una fecha y hora de finalización basándose en el webhook id y el application id.
Ten en cuenta que se espera la hora en UTC. Estas actividades se entregan a través del webhook registrado asociado con el id a una velocidad de hasta 2.500 eventos por segundo. Ten también en cuenta que solo puede estar en ejecución un trabajo de Replay por webhook a la vez, aunque todas las suscripciones que estuvieron activas durante el intervalo de fecha y hora especificado en ese webhook serán reproducidas.
Los eventos se entregan comenzando por el primer (más antiguo) minuto del período de tiempo especificado, continuando de forma cronológica (en la medida de lo posible) hasta que se entrega el último minuto. En ese momento, Replay entregará un [evento de finalización del trabajo](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#job-completed-successfully-message) al webhook. Debido a que trabajamos de forma cronológica al entregar actividades, si hay pocos o ningún resultado coincidente cerca de la hora de inicio, probablemente habrá un período de tiempo antes de que se entreguen los primeros resultados.
### Limitaciones
Replay está diseñado como una herramienta para recuperar fácilmente actividades de los últimos cinco días, pero no entregará eventos anteriores al momento en que se creó una suscripción. Por ejemplo, si hace tres días se añadió una nueva suscripción y se ejecutó un trabajo de Replay con una ventana de los cinco días anteriores a hoy, solo se recibirían datos de los tres días en que esta nueva suscripción estuvo activa.
### Disponibilidad de datos y tipos
Las actividades de la Account Activity Replay API están disponibles durante cinco días desde el inicio de la solicitud, y los datos nuevos pasan a estar disponibles aproximadamente 10 minutos después de que se crea una actividad determinada. Podrás realizar solicitudes especificando un intervalo de tiempo dentro de esta ventana de cinco días usando los parámetros from\_date y to\_date en la solicitud. Los eventos que se entregaron originalmente antes de tener acceso a Replay no se pueden reproducir. Por ejemplo, si se habilitó el acceso de tu cuenta a la Account Activity Replay API el 1 de junio de 2019 a las 3:30 p. m. UTC, no podrías usar Replay para recuperar ningún evento anterior a esa fecha y hora.
Sigue con la [Referencia de la Account Activity Replay API](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#delete-account-activity-webhooks-webhook-id-subscriptions-all-deprecated)
## Introducción a la migración
**Retiramos los productos Site Streams, User Streams y la versión beta estándar de Account Activity API - DM Only en 2018. Si habías estado usando esos productos, asegúrate de migrar a la versión premium o enterprise de Account Activity API.**
\*\*También hemos retirado los endpoints heredados de Mensajes Directos. Si habías estado usando esos endpoints, asegúrate de migrar a los nuevos endpoints de DM o a la versión premium o enterprise de Account Activity API. \*\*
**Revisa [este anuncio](https://devcommunity.x.com/t/details-and-what-to-expect-from-the-api-deprecations-this-week-on-august-16-2018/110746) para obtener más información.**
Estos son los endpoints que se verán afectados por estos cambios:
* User Streams
* Site Streams
* GET direct\_messages
* GET direct\_messages/sent
* GET direct\_messages/show
* POST direct\_messages/new
* POST direct\_messages/destroy
Contamos con nuevos endpoints y servicios que proporcionan un acceso similar y, en el caso de los Mensajes Directos, funcionalidad adicional:
* Account Activity API [enterprise](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#enterprise-account-activity-api) y [premium](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#account-activity-api-reference-index)
* [GET direct\_messages/events/list](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/list-events)
* [GET direct\_messages/events/show](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/get-event)
* [POST direct\_messages/events/new](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/new-event)
* [POST direct\_messages/events/destroy](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/delete-message-event)
Para ayudarte a realizar una migración fluida a estos nuevos endpoints y servicios, disponemos de dos guías de migración:
* [Guía de migración de Account Activity API](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#migration-guide-moving-from-user-streams-site-streams-to-account-activity-api) para quienes pasan de User Streams y Site Streams a nuestro nuevo servicio basado en webhooks
* [Guía de migración de Mensajes Directos](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/guides/direct-message-migration) para quienes migran entre endpoints REST de Mensajes Directos
Además, contamos con una [serie de vídeos](https://www.youtube.com/playlist?list=PLFKjcMIU2WshGG6Yj940XM7Z6BFs1zfBg) sobre Account Activity API y cómo empezar.
Y, por último, tenemos ejemplos de código para ampliar tu comprensión y ayudarte a comenzar rápidamente:
* El [Account Activity Dashboard](https://github.com/xdevplatform/Account-Activity-dashboard) es una aplicación web de Node.js de ejemplo con scripts auxiliares para comenzar a usar Account Activity API.
* [SnowBot](https://github.com/xdevplatform/SnowBotDev) es un chatbot de ejemplo que usa Account Activity API y endpoints REST de Mensajes Directos. Está escrito en Ruby, utiliza el framework web Sinatra y se despliega en Heroku.
## Guía de migración: migrar de User Streams/Site Streams a Account Activity API
**A partir del 23 de agosto de 2018, retiramos tanto Site Streams como User Streams. Asegúrate de migrar a Account Activity API.**
**Revisa [este anuncio](https://devcommunity.x.com/t/details-and-what-to-expect-from-the-api-deprecations-this-week-on-august-16-2018/110746) para obtener más información.**
Esta guía está diseñada para ayudarte a migrar de las API heredadas de User Streams y Site Streams a su reemplazo, Account Activity API. A continuación encontrarás un resumen de los cambios, una lista de nuevas funcionalidades, así como las diferencias y consideraciones clave para ayudarte con la transición. Para obtener orientación sobre la migración desde endpoints básicos de DM, consulta la [guía de migración de Direct Message](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/guides/direct-message-migration).
### Resumen de los cambios
La API Account Activity te enviará eventos de cuentas autenticadas y suscritas a través de webhooks, en lugar de mediante una conexión de streaming como en User Streams y Site Streams.
#### APIs en desuso
GET user
GET site (incluidos los streams de control: GET site/c/:stream\_id, GET site/c/:stream\_id/info.json, GET site/c/:stream\_id/friends/ids.json, POST site/c/:stream\_id/add\_user.json, POST /site/c/:stream\_id/remove\_user.json)
#### APIs de sustitución
[Enterprise Account Activity API - Todas las actividades](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#enterprise-account-activity-api)
### Diferencias y consideraciones de migración
**Formato de la API:** La nueva Account Activity API funciona de manera diferente a User Streams y Site Streams. Deberás modificar tu aplicación web para recibir datos mediante webhooks. Puedes encontrar más información sobre webhooks [aquí](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#getting-started-with-webhooks).
**Datos disponibles:** Otra diferencia clave que notarás se refiere a los datos que se entregan. X ya no enviará eventos de personas a las que sigues en X (es decir, tu cronología de inicio). Este fue un cambio intencional y no es algo que tengamos previsto modificar en el futuro.
**Fiabilidad:** A diferencia del streaming, los webhooks permiten la confirmación de la entrega y ofrecen opciones para reintentar actividades enviadas mediante solicitudes POST que no lleguen a la URL del webhook. Esto proporciona una mayor garantía de que la aplicación está recibiendo todas las actividades pertinentes, incluso si hay breves desconexiones o períodos de inactividad.
### Nuevas funcionalidades
La Account Activity API ofrece muchas funcionalidades nuevas, en particular que ahora los datos se entregan mediante webhooks en lugar de streaming. Los webhooks ofrecen muchas ventajas en comparación con el streaming, pero las más destacadas son la velocidad y la fiabilidad. La API te enviará datos en forma de eventos JSON a medida que estén disponibles y ya no necesitarás mantener una conexión activa ni realizar sondeos al endpoint. Esto reduce la necesidad de funcionalidades de redundancia y aumenta la eficiencia en general. Puedes encontrar más información sobre webhooks en la [documentación técnica](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#getting-started-with-webhooks).
### Gestión de suscripciones de usuario
La API de actividad de cuentas permite múltiples suscripciones para un solo webhook registrado. Esto permite que las actividades de suscripción de varios usuarios se entreguen en el mismo destino, de forma similar a la arquitectura de Site Streams, pero mediante webhooks. Esto significa que puedes hacer un seguimiento de las suscripciones, en relación con tus límites de suscripción, de forma independiente de la conexión del webhook. Esto también permite escalar desde una o unas pocas suscripciones hasta miles de suscripciones para un solo webhook.
### **Cómo migrar**
### **Sigue los pasos a continuación para migrar fácilmente de la Site Streams API a la Account Activity API**
**Paso 1: Elige un paquete**
Según cómo estés operando actualmente con User Streams o Site Streams, deberías considerar pasar a la versión enterprise o premium de la Account Activity API. Ten en cuenta el número de aplicaciones o usuarios autorizados que estás gestionando actualmente y ajusta la escala de acuerdo con el volumen y la confiabilidad necesarios. Al decidir sobre el paquete que mejor se adapte a tus necesidades, algunos aspectos que vale la pena considerar son:
* Número de webhooks necesarios
* Suscripciones/usuarios autorizados actuales/proyectados gestionados en tu aplicación
* Número actual de aplicaciones cliente de X
* El nivel de soporte que prefieres por parte de X (soporte mediante foro o soporte enterprise gestionado 1:1)
* El precio de cada paquete
**Paso 2:** **Verifica la configuración de tu app de X en la Consola de desarrollador**
La [app de X](/es/resources/fundamentals/developer-apps) que se utiliza actualmente para User Streams o Site Streams aparecerá en la lista para el usuario propietario dentro de la [Consola de desarrollador](/es/resources/fundamentals/developer-portal). Esta app de X también puede usarse para Account Activity API para conservar los usuarios autorizados de esa aplicación. También se puede crear una nueva app y los usuarios pueden volver a autorizar esta nueva app si se desea. Si estás creando una nueva app en nombre de una empresa, se recomienda que crees la app con una cuenta corporativa de X @handle.
* Habilita “Read, Write and Access direct messages” en la pestaña de [permissions](/es/resources/fundamentals/developer-apps#app-permissions) de la página de tu app de X.
\*Ten en cuenta que cambiar estas opciones no es retroactivo; cualquier usuario autorizado conservará la configuración de autorización del momento en que fue autorizado. Si un usuario aún no te ha otorgado acceso de lectura, escritura y mensajes directos, deberás hacer que ese usuario vuelva a autorizar tu aplicación.
* Si no estás familiarizado con [X Sign-in](/es/resources/fundamentals/authentication#log-in-with-x) y cómo funcionan los contextos de usuario con la X API, revisa [Obtaining Access Tokens](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#getting-started-with-webhooks).
* Genera tokens de acceso para el propietario de la app de X en la parte inferior de la pestaña “Keys and Tokens”. En esta misma pestaña, toma nota de tu Consumer Key, Consumer Secret, Access Token y Access Token Secret. Los necesitarás para usar la API.
* Genera un Bearer Token usando tu Consumer Key y Consumer Secret para métodos de la API en modo [application-only](/es/resources/fundamentals/authentication#bearer-token-also-known-as-app-only).
**Paso 3: Configura tus webhooks**
* Crea una aplicación web con un endpoint para usar como tu webhook y recibir eventos (por ejemplo, [https://your\_domain.com/webhook/twitter](https://your\_domain.com/webhook/twitter) o [https://webhooks.your\_domain.com](https://webhooks.your\_domain.com)).
* Usa tu Consumer Key, Consumer Secret, Access Token y Access Token Secret al crear tu webhook. Ten en cuenta que tu endpoint debe devolver una respuesta JSON con un `response_token` que sea un hash HMAC SHA-256 codificado en base64 creado a partir del `crc_token` y el Consumer Secret de tu app.
* Revisa la documentación de [Securing Webhooks](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#securing-webhooks), prestando especial atención a los requisitos de Challenge Response Check (CRC).
* Asegúrate de que tu webhook admita solicitudes POST para eventos entrantes y solicitudes GET para el CRC.
* Asegúrate de que tu webhook tenga baja latencia (\<3 segundos para responder a solicitudes POST)
**Paso 4: Valida la configuración de tu webhook**
* Las Webhook APIs protegerán tus webhooks de dos maneras:
- Requerir comprobaciones de desafío-respuesta para validar que el propietario del webhook es el propietario de la aplicación web.
- Un encabezado de firma en cada solicitud POST para que tu aplicación web valide el origen.
* Para verificar que eres tanto el propietario de la aplicación web como de la URL del webhook, X realizará un Challenge Response Check (CRC), que no debe confundirse con una comprobación de redundancia cíclica.
* Se enviará una solicitud GET con un parámetro llamado `crc_token` a la URL de tu webhook. Tu endpoint debe devolver una respuesta JSON con un `response_token` que sea un hash HMAC SHA-256 codificado en base64 creado a partir del `crc_token` y el Consumer Secret de tu app.
* Se debe esperar que el `crc_token` cambie en cada solicitud de CRC entrante. El `crc_token` debe usarse como mensaje en el cálculo, donde tu Consumer Secret es la clave.
* En caso de que la respuesta sea inválida, se dejarán de enviar eventos al webhook registrado.
**Paso 5: Crea suscripciones para cada usuario autorizado de User Streams o Site Streams**
Conversión desde User Streams a la Account Activity API:
* Genera una lista de tus suscripciones de usuario actuales en User Streams
* Configura tus nuevas suscripciones de Account Activity API mediante la solicitud: *POST account\_activity/all/:env\_name/subscriptions*
* Confirma tus suscripciones de Account Activity API mediante la solicitud: \_GET account\_activity/all/:env\_name/subscriptions/list
\_
Conversión a Account Activity API desde Site Streams (usando control streams):
* Genera una lista de tus suscripciones actuales en Site Streams mediante la solicitud: *GET /1.1/site/c/:stream\_id/info.json*
* Configura tus nuevas suscripciones de Account Activity API mediante la solicitud: *POST account\_activity/all/:env\_name/subscriptions*
* Confirma tus suscripciones de Account Activity API mediante la solicitud: \_GET account\_activity/all/:env\_name/subscriptions/list
\_
Registro de un webhook y creación de suscripciones (sin migrar desde Site Streams o User Streams)
* Registra la URL de tu webhook con tu App usando [POST webhooks](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#enterprise-account-activity-api) y recibe un webhook\_id.
* Usa el webhook\_id devuelto para agregar suscripciones de usuario con [POST webhooks/:webhook\_id/subscriptions/all](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#post-account-activity-webhooks-webhook-id-subscriptions-all).
### El panel de Account Activity (aplicación de ejemplo de Account Activity API)
Hemos creado una aplicación de ejemplo para que probar Account Activity API sea un poco más rápido:
* Descarga la aplicación de ejemplo Account Activity Dashboard [aquí](https://github.com/xdevplatform/Account-Activity-dashboard) (usa Node.js)
* Sigue las instrucciones del README para instalar e iniciar la aplicación
* Una vez que la aplicación se haya iniciado, puedes usar la interfaz de usuario para configurar fácilmente tu webhook y crear una nueva suscripción
### Actividades disponibles
| Tipo de mensaje | Detalles |
| :--------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [tweet\_create\_events](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#tweet-create-events-posts-retweets-replies-quotetweets) | Carga útil del estado de la Publicación cuando se realiza cualquiera de las siguientes acciones por parte del usuario de la suscripción o dirigidas a él: Publicaciones, Retweets, respuestas, menciones @, Tweets citados |
| [favorite\_events](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#favorite-events) | Evento de favorito (like) con el usuario y el objetivo. |
| [follow\_events](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#follow-events) | Evento de seguir con el usuario y el objetivo. |
| [block\_events](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#block-events) | Evento de bloqueo con el usuario y el objetivo. |
| [mute\_events](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#mute-events) | Evento de silenciar con el usuario y el objetivo. |
| [direct\_message\_events](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#direct-message-events) | Evento de mensaje directo con el usuario y el objetivo. |
| [direct\_message\_indicate\_typing\_events](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#direct-message-indicate-typing-events) | Evento de escritura en mensaje directo con el usuario y el objetivo. |
| [direct\_message\_mark\_read\_events](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#direct-message-mark-read-events) | Evento de lectura de mensaje directo con el usuario y el objetivo. |
### Tipos de mensajes de streaming en desuso
| | |
| :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Blank lines | Las líneas en blanco ya no se entregarán en Account Activity API, ya que se utilizaban como mensajes de mantenimiento de la conexión en User Streams y Site Streams. |
| Limit notices | Los avisos de límite ya no se enviarán al webhook correspondiente. En su lugar, los usuarios pueden llamar a la API para obtener el uso actual de los identificadores disponibles. Esto se incluirá en la Consola de desarrollador en algún momento en el futuro. |
| Disconnect messages | Los avisos de desconexión ya no serán necesarios, ya que los webhooks no dependen de una conexión activa. |
| Stall warnings | Las advertencias de bloqueo ya no serán necesarias, ya que los webhooks no dependen de una conexión activa capaz de manejar grandes cantidades de mensajes entrantes. |
| Friends list | Las listas de amigos ya no se enviarán de forma proactiva. Ahora habrá un endpoint REST para obtener esta información. |
### Tipos de eventos obsoletos
| | | | | |
| :-------------------------------------------------------- | :----------------------- | :--------------------------------- | :---------------------- | :-------------------- |
| **Descripción** | **Nombre del evento** | **Origen** | **Destino** | **Objeto de destino** |
| El usuario elimina una publicación | delete | Usuario actual | Usuario actual | Publicación |
| Un usuario seguido elimina una publicación | delete | Usuario seguido | Usuario seguido | Publicación |
| El usuario quita de favoritos una publicación | unfavorite | Usuario actual | Autor de la publicación | Publicación |
| Se quita de favoritos la publicación de un usuario | unfavorite | Usuario que quita de favoritos | Usuario actual | Publicación |
| El usuario deja de seguir a alguien | unfollow | Usuario actual | Usuario seguido | Null |
| El usuario crea una lista | list\_created | Usuario actual | Usuario actual | Lista |
| El usuario elimina una lista | list\_destroyed | Usuario actual | Usuario actual | Lista |
| El usuario edita una lista | list\_updated | Usuario actual | Usuario actual | Lista |
| El usuario agrega a alguien a una lista | list\_member\_added | Usuario actual | Usuario agregado | Lista |
| El usuario es agregado a una lista | list\_member\_added | Usuario que agrega | Usuario actual | Lista |
| El usuario quita a alguien de una lista | list\_member\_removed | Usuario actual | Usuario eliminado | Lista |
| El usuario es quitado de una lista | list\_member\_removed | Usuario que elimina | Usuario actual | Lista |
| El usuario se suscribe a una lista | list\_user\_subscribed | Usuario actual | Propietario de la lista | Lista |
| Se suscriben a la lista de un usuario | list\_user\_subscribed | Usuario que se suscribe | Usuario actual | Lista |
| El usuario cancela la suscripción a una lista | list\_user\_unsubscribed | Usuario actual | Propietario de la lista | Lista |
| Se cancela la suscripción a la lista de un usuario | list\_user\_unsubscribed | Usuario que cancela la suscripción | Usuario actual | Lista |
| El usuario actualiza su perfil | user\_update | Usuario actual | Usuario actual | Null |
| El usuario actualiza el estado de protección de su cuenta | user\_update | Usuario actual | Usuario actual | Null |
## Guía de migración de Mensajes Directos
**El 17 de septiembre de 2018 retiramos los endpoints heredados de Mensajes Directos.
Si estabas utilizando esos endpoints, asegúrate de migrar a los nuevos endpoints de Mensajes Directos o a la Account Activity API.**
**Consulta [este anuncio](https://devcommunity.x.com//t/details-and-what-to-expect-from-the-api-deprecations-this-week-on-august-16-2018/110746) para obtener más información.**
Esta guía está diseñada para ayudarte a migrar desde las APIs REST heredadas de Mensajes Directos a sus reemplazos mejorados, que han salido de la fase beta. A continuación encontrarás un resumen de los cambios, una lista de nuevas funciones y las diferencias y consideraciones clave para facilitar la transición. Los nuevos endpoints de Mensajes Directos ya están disponibles para todos los desarrolladores. Para obtener orientación sobre cómo migrar desde User Streams o Site Streams, consulta la [guía de migración a Account Activity API](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#migration-guide-moving-from-user-streams-site-streams-to-account-activity-api).
* [Resumen de cambios](#summary)
* [Nuevas funciones](#features)
* [Envío de Mensajes Directos](#sending)
* [Recepción de Mensajes Directos](#receiving)
* [Eliminación de Mensajes Directos](#deleting)
### Resumen de los cambios
Si todavía usas los siguientes endpoints de MD, deberás migrar a los endpoints más recientes.
| Endpoint en desuso | Nueva alternativa de migración |
| :------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [POST direct\_messages/new](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/new-event) | [POST direct\_messages/events/new](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/new-event) |
| [GET direct\_messages/show](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/get-event) | [GET direct\_messages/events/show](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/get-event) |
| [GET direct\_messages](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/list-events) | [GET direct\_messages/events/list](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/list-events) |
| [GET direct\_messages/sent](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/get-event) | [GET direct\_messages/events/list](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/list-events) |
| [POST direct\_messages/destroy](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/delete-message-event) | [DELETE direct\_messages/events/destroy](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/delete-message-event "GET direct_messages/events/list") |
### Nuevas funciones
Los nuevos endpoints de la API de Mensajes Directos incorporan varias funcionalidades nuevas y ofrecen un acceso mejorado a Mensajes Directos anteriores. Las nuevas funciones incluyen:
* Compatibilidad con archivos multimedia adjuntos (imagen, GIF y video).
* Posibilidad de solicitar a los usuarios respuestas estructuradas con una lista de opciones predefinida.
* Hasta 30 días de acceso a Mensajes Directos anteriores.
Para ver la lista completa de las nuevas funciones de Mensajes Directos y de los nuevos endpoints de la API, consulta la [documentación técnica](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/overview).
### Diferencias y consideraciones de migración
Los nuevos endpoints de la API se comportan de manera muy diferente a los anteriores. Simplemente actualizar las URL de los endpoints dará lugar a errores en tu aplicación. Ten en cuenta lo siguiente al actualizar tu aplicación para la migración.
#### Nuevo objeto de Mensaje Directo
Lo primero que probablemente notarás es la nueva estructura de objeto de los Mensajes Directos. Esta nueva estructura de objeto Message Create se ha introducido para admitir nuevas funcionalidades como [Quick Replies](https://developer.x.com/en/docs/x-api/v1/direct-messages/quick-replies/overview) y [Attachments](https://developer.x.com/en/docs/x-api/v1/direct-messages/message-attachments/overview). El nuevo objeto también contiene un objeto de usuario más pequeño y condensado. Será necesario actualizar tu aplicación para tener en cuenta esta nueva estructura de objeto al analizarlo y, potencialmente, en los modelos de datos o en el almacenamiento. Para obtener descripciones de cada propiedad, consulta la [documentación completa sobre el Message Create Object](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/guides/message-create-object).
**Ejemplo de objeto Message Create**
```json theme={null}
{
"type": "message_create",
"id": "1234858592",
"created_timestamp": "1392078023603",
"initiated_via": {
"tweet_id": "123456",
"welcome_message_id": "456789"
},
"message_create": {
"target": {
"recipient_id": "1234858592"
},
"sender_id": "3805104374",
"source_app_id": "268278",
"message_data": {
"text": "Blue Bird",
"entities": {
"hashtags": [],
"symbols": [],
"urls": [],
"user_mentions": [],
},
"quick_reply_response": {
"type": "options",
"metadata": "external_id_2"
},
"attachment": {
"type": "media",
"media": {
...
}
}
}
}
```
#### Resumen
* Estructura de objeto de Mensaje Directo completamente nueva.
* Objeto de usuario simplificado.
* Nueva información disponible (respuestas a respuestas rápidas, archivos adjuntos, etc.).
### Envío de Mensajes Directos
[POST direct\_messages/events/new](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/new-event) es un sustituto directo para enviar Mensajes Directos. La diferencia más significativa con este endpoint es que ahora toda la información se envía como JSON en el cuerpo de la solicitud POST en lugar de como parámetros POST individuales.
**Ejemplo de solicitud Twurl**
```bash theme={null}
twurl -A 'Content-type: application/json' -X POST /1.1/direct\_messages/events/new.json -d '{"event": {"type": "message\_create", "message\_create": {"target": {"recipient\_id": "4534871"}, "message_data": {"text": "Hello World!"}}}}'
```
Ten en cuenta en la solicitud anterior que el content-type está configurado como application/json en lugar de application/x-www-form-urlencoded. Además, si estás construyendo la firma OAuth 1.0a, ten en cuenta que el cuerpo JSON no se incluye en la generación de la firma. La mayoría de las bibliotecas de OAuth ya contemplan esto. Si estás usando [twurl](https://github.com/twitter/twurl), asegúrate de usar al menos la versión 0.9.3.
#### Resumen
* El mensaje se define en el cuerpo de la solicitud POST en formato JSON
* El encabezado Content-Type debe establecerse en application/json
* El cuerpo JSON no se incluye en la generación de la firma de OAuth
### Recuperar Mensajes Directos
La recuperación de Mensajes Directos anteriores ahora se realiza con un único endpoint de API: [GET direct\_messages/events/list](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/list-events). La diferencia importante con este nuevo endpoint es que ahora devuelve tanto los mensajes enviados como los recibidos en orden cronológico inverso. Esto puede facilitar la reconstrucción de una conversación. Sin embargo, si solo buscas mensajes enviados o recibidos, deberás posprocesar la respuesta consultando la propiedad sender\_id.
La paginación ahora se basa en un valor de cursor en lugar del id de un Mensaje Directo. En cada respuesta se devuelve una propiedad cursor. [GET direct\_messages/events/list](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/list-events) devolverá hasta 30 días de mensajes anteriores, independientemente de cuántos mensajes existan dentro de esos 30 días. Cuando no se devuelve un cursor, no hay más mensajes que recuperar. El método para acceder a Mensajes Directos individuales con [GET direct\_messages/events/show](https://developer.x.com/en/docs/x-api/v1/direct-messages/sending-and-receiving/api-reference/get-event) sigue siendo el mismo, aunque el objeto de Mensaje Directo devuelto tiene una estructura diferente, como se describió anteriormente.
Por último, el acceso en tiempo real a Mensajes Directos ahora se realizará mediante webhook con la [Account Activity API](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity). Para obtener orientación sobre la migración desde User Streams o Site Streams, consulta la guía de migración de Account Activity API para obtener más información.
#### Resumen
* Los mensajes enviados y recibidos ahora se devuelven en el mismo endpoint.
* Se devuelven mensajes de hasta 30 días de antigüedad.
* Paginación basada en cursores.
* Acceso en tiempo real a Mensajes Directos mediante webhook.
### Eliminación de Mensajes Directos
Ahora se pueden eliminar Mensajes Directos con DELETE direct\_messages/events/destroy. La interfaz es prácticamente la misma y requiere el id del mensaje que se va a eliminar. La diferencia clave es que ahora el endpoint requiere una solicitud DELETE en lugar de una solicitud POST.
La forma en que los Mensajes Directos eliminados se reflejan en los clientes oficiales de X sigue siendo la misma. Los Mensajes Directos solo se eliminan de la interfaz del usuario cuyo contexto se utiliza. Otros miembros de la conversación aún pueden acceder a los Mensajes Directos.
#### Resumen
* Para eliminar un mensaje directo se requiere el id.
* El nuevo endpoint requiere una solicitud DELETE.
* La forma en que los mensajes directos eliminados se reflejan en los clientes oficiales de X permanece sin cambios.
\*\*¿Tienes preguntas sobre cómo migrar a los nuevos endpoints de mensajes directos?
\*\*Publica tu pregunta en el foro de la comunidad de desarrolladores en [devcommunity.com](https://devcommunity.x.com/).
## Preguntas frecuentes
### General
**¿Cuáles son las ventajas de usar la Account Activity API?**
La Account Activity API usa webhooks, lo que significa que, a diferencia de las APIs de streaming, no necesitas mantener una conexión abierta para que podamos enviarte información. Los webhooks también son diferentes de las APIs REST porque no tienes que hacernos cientos de solicitudes cada 15 minutos para obtener los datos que te interesan. Esto aumenta la eficiencia entre un usuario y tu app, ya que entrega los datos cuando ocurren.
La Account Activity API tiene varias ventajas:
1. **Velocidad**: entregamos los datos a la velocidad de X.
2. **Simplicidad**: entregamos todos los eventos de una cuenta a través de una única conexión de webhook. Las actividades entregadas en la API incluyen Publicaciones, @menciones, respuestas, Retweets, Quote Tweets, Retweets de Quote Tweets, favoritos, mensajes directos enviados, mensajes directos recibidos, follows, blocks y mutes.
3. **Escalabilidad**: recibes todas las actividades de una cuenta que administras sin estar restringido por ningún límite de tasa ni topes de eventos.
La Account Activity API está disponible como una oferta de sandbox premium, premium de pago y enterprise, por lo que puedes escalar según necesites más cuentas para funciones de responsabilidad o funcionalidad adicional.
Para comenzar, descarga fragmentos de código de ejemplo desde [GitHub](https://github.com/xdevplatform/account-activity-dashboard).
**¿Cómo identifico qué nivel de producto es mejor para mí?**
Lee nuestra página de [Account Activity API Overview](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity) para obtener más información sobre las diferencias entre las opciones Premium y la opción Enterprise.
**¿Cuál es la diferencia entre un entorno Premium y un webhook Enterprise?**
No hay ninguna diferencia. Cada entorno Premium tendrá su propio webhook\_id.
**Necesito entornos de desarrollo, staging y producción para Account Activity API, ¿es esto posible?**
¡Sí! Con los niveles de pago de Account Activity API (Premium de pago y Enterprise), es posible registrar varias URL de webhook y administrar las suscripciones por separado para cada una mediante los métodos de la API. Además, se pueden agregar varias apps cliente a una allowlist para mantener la autorización de tus usuarios autorizados actuales.
**¿Tienen alguna guía paso a paso sobre cómo configurar la Account Activity API?**
De hecho, ¡sí tenemos!
* Si recién estás comenzando, te recomendamos que visites nuestra guía [Getting started with webhooks](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#getting-started-with-webhooks)
* Sigue nuestros scripts proporcionados por X Dev:
* [Account Activity API dashboard](https://github.com/xdevplatform/account-activity-dashboard), una aplicación web Node que muestra eventos de webhook.
* El [chatbot SnowBot](https://github.com/xdevplatform/SnowBotDev), una aplicación web Ruby creada sobre las Account Activity y Direct Message APIs. Este código base incluye un [script](https://github.com/xdevplatform/SnowBotDev/wiki/Account-Activity-API-setup-script) para ayudar a configurar los webhooks de Account Activity API.
**¿Hay alguna forma de recuperar datos si nuestro sistema deja de funcionar durante un período de tiempo?**
Con los niveles de pago de Account Activity API (Premium de pago y Enterprise), nuestro sistema [reintentará](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#retries) enviarte las actividades varias veces durante un período de cuatro horas. Si tu sistema no responde dentro de ese período de cuatro horas, la actividad se perderá y tendrás que usar otros endpoints REST para recuperar datos dentro de un plazo de 7 días.
Te sugerimos que uses tus distintos webhooks, o entornos, como herramienta de redundancia, como la [Account Activity Replay API](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#account-activity-replay-api), para asegurarte de no perder ninguna actividad si uno de tus sistemas deja de funcionar.
**¿Qué autenticación tengo que usar con la Account Activity API?**
Los métodos de autorización requeridos para Account Activity API se describen por método en las [páginas de referencia de la API](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#account-activity-api-reference-index). Si recién estás comenzando con la autenticación de X, te recomendamos que leas [esta sección](/es/resources/fundamentals/authentication).
**¿Qué es una comprobación de desafío-respuesta (CRC)?**
La verificación de respuesta al desafío de la Account Activity API es una función de seguridad implementada para garantizar que las actividades de la Account Activity API se envíen al desarrollador adecuado. También puede ser utilizada por los desarrolladores para asegurarse de que los datos que están recibiendo provienen de X. X enviará automáticamente un CRC a tu URL de webhook una vez cada 24 horas, a partir de la última vez que se validó la URL del webhook. Tu sistema debe responder con una respuesta válida en un plazo de 3 segundos para seguir validado.
Visita la página [Protección de webhooks](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#securing-webhooks) para obtener más detalles.
**¿Hay algo que invalidaría inmediatamente mi URL de webhook?**
Si ocurre una de las siguientes situaciones, marcaremos inmediatamente tu webhook como inválido:
* El servidor responde a un CRC con un token incorrecto. En este caso, nuestro sistema no [reintentará](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#retries) enviarte la actividad.
* La URL del webhook tiene configurado un certificado incorrecto. En este caso, nuestro sistema no [reintentará](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#retries) enviarte la actividad.
* Tu servidor devuelve un código de respuesta que no es 2XX, 4XXX ni 5XXX.
* Especificas el uso de gzip sin enviarlo realmente.
* No especificas el uso de gzip, pero en realidad lo envías en la respuesta.
**¿Recibiré actividades duplicadas si estoy suscrito a usuarios que interactúan entre sí?**
Sí. Si tu aplicación web tiene suscripciones activas para el Usuario A y el Usuario B, y el Usuario A menciona al Usuario B en una Publicación, se enviarán dos actividades POST al webhook registrado. Cada actividad tendrá un indicador "for\_user\_id" para mostrar a qué suscripción pertenece la actividad.
\*\*Cuando creo una suscripción a mi webhook, ¿puedo reemplazar la parte `/all/` del siguiente endpoint con otros objetos de datos de Account Activity para limitar las actividades que entrega la API? \*\*`POST https://api.x.com/1.1/account_activity/all/:env_name/subscriptions.json`
No, esto no es posible. En la situación actual, solo tenemos disponible el producto `/all/`.
\*\*¿Hay alguna forma de usar la Account Activity API sin solicitar permisos de Mensajes Directos a los usuarios? \*\*
En este momento, se requieren permisos de Mensajes Directos porque no existe ninguna forma de "filtrar" las actividades de Mensajes Directos para esta API.
**¿Existe una versión sandbox de la Account Activity API?**
Sí, ofrecemos una opción de sandbox para pruebas. Nuestra opción de sandbox está limitada a un único webhook con un máximo de 15 suscripciones. Puedes leer más sobre la opción de sandbox en [nuestra documentación](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity).
\*\*¿Es posible usar la Account Activity API para obtener Retweets de Publicaciones que mencionan a usuarios suscritos? \*\*
Lamentablemente, esto no forma parte de las actividades entregadas con esta API. Para esto, sugerimos usar la Streaming API.
**¿Cuáles son los posibles tipos de actividad que están representados por un tweet\_create\_event?**
Se enviará una carga útil de tweet\_create\_event:
Si el usuario suscrito realiza cualquiera de las siguientes acciones:
* Crea una Publicación
* Hace Retweet
* Responde a una Publicación
Si otro usuario:
* @menciona\* al usuario suscrito
* Cita un Tweet creado por el usuario suscrito
\*Nota: La Account Activity API solo entrega eventos cuando el usuario suscrito recibiría una notificación de X y podría ver el evento públicamente. Esto significa que, si la cuenta mencionada (@userA) sigue a la cuenta protegida (@userB), entonces UserA recibirá una notificación de que UserB lo mencionó. Si UserA no sigue a UserB (y no ha sido aprobado por UserB), UserA no recibirá una notificación, y por lo tanto no se enviaría un tweet\_create\_event a través de AAA si @userA tuviera una suscripción.
**Si un usuario bloqueado menciona a mi usuario suscrito, ¿cómo puedo identificarlo?**
Verás un campo booleano `user_has_blocked` en el nivel superior de la respuesta JSON, establecido en "true" o "false". Este campo solo se expondrá en menciones en Publicaciones.
Enterprise
**¿Cómo puedo añadir mi App a una allowlist o comprobar si mi App ya está en la allowlist?**
Para gestionar las [X apps](/es/resources/fundamentals/developer-apps) que has añadido a una allowlist para el acceso mediante las Enterprise APIs, ponte en contacto con tu account manager y facilítale tu app ID. Puedes encontrar tu app ID yendo a la página ["Apps"](/es/resources/fundamentals/developer-apps) en la [Consola de desarrollador](/es/resources/fundamentals/developer-portal).
**Si tengo acceso a tres webhooks, ¿puedo usar tres webhooks para cada una de las apps que he registrado para uso empresarial?**
El límite de webhooks se establece a nivel de cuenta, no a nivel de app. Si tienes acceso a tres webhooks y dos apps registradas para uso empresarial, puedes usar dos webhooks en una app y el tercero en la otra app, pero no tres en cada app.
**¿Puedo especificar qué tipos de eventos se volverán a entregar usando la Account Activity Replay API?**
Los tipos de eventos a reproducir no se pueden especificar. Se volverán a reproducir todos los eventos entregados durante el intervalo de fecha y hora especificado.
**¿Habrá reintentos si mi aplicación no logra procesar un evento de la Account Activity Replay API?**
No, no habrá reintentos. Si una aplicación no logra procesar un evento enviado por la Account Activity Replay API, se puede enviar otro Replay job para el mismo período de tiempo para intentar la reentrega de cualquier Replay event que se haya perdido.
**¿Qué debo hacer cuando recibo un evento de finalización con éxito parcial (partial success)?**
Sugerimos que tomes nota de las marcas de tiempo (timestamps) de los eventos que se recibieron y solicites otro Replay job para los eventos que faltaron.
**¿Cuántos Replay jobs de Account Activity Replay API puedo tener en ejecución al mismo tiempo?**
Solo puede estar en ejecución un Replay job de Account Activity Replay API por webhook a la vez.
**¿Cómo puedo diferenciar los eventos de Account Activity Replay API de los eventos de producción en tiempo real a medida que se entregan a mi webhook?**
Dado que la Account Activity Replay API siempre entregará eventos del pasado, los eventos se pueden diferenciar de los eventos de producción en tiempo real en función de la marca de tiempo del evento.
**¿Con qué rapidez puedo empezar a usar la Account Activity Replay API para volver a entregar una actividad que mi aplicación descartó o se perdió?**
Una actividad pasa a estar disponible para su reentrega aproximadamente 10 minutos después de que se creó.
### Guía para solucionar errores
#### Code 32
Este error generalmente significa que algo está mal definido en la solicitud, los encabezados, la autorización o la URL que estás especificando. Este no es un error de la Account Activity API, es un error de autorización y X no está recibiendo la configuración correcta de OAuth ni la URL adecuada.
* **Enterprise** - Asegúrate de que las consumer keys y los access tokens que estás utilizando pertenezcan a una [App de X](/es/resources/fundamentals/developer-apps) que haya sido registrada para el uso de productos Enterprise. Si no tienes tus consumer keys y access tokens, o necesitas agregar tu App de X a la allowlist, ponte en contacto con tu account manager.
* Si te autenticas con contexto de usuario, asegúrate de haber [autorizado correctamente tu solicitud](/es/resources/fundamentals/authentication#authorizing-a-request) con los valores correctos para `oauth nonce`, `oauth_signature` y `oauth_timestamp`.
* Asegúrate de que tus access tokens tengan el nivel de permisos adecuado.
* En la pestaña 'Keys and tokens' del [app dashboard](/es/resources/fundamentals/developer-apps), asegúrate de que tus access tokens tengan el nivel de permisos 'Read, write, and direct messages' [permission level](/es/resources/fundamentals/developer-apps#app-permissions).
* Si el nivel de permisos de los tokens está configurado en algo menor que esto, ve a la pestaña 'Permissions', ajusta el permiso de acceso a 'Read, write, and direct messages' y luego vuelve a generar tus access tokens y secret desde la pestaña 'Keys and tokens'.
* Asegúrate de que tu URL esté formada correctamente.
* Ten en cuenta que `:env_name` distingue entre mayúsculas y minúsculas.
#### Código 200 - Prohibido
* **Premium** - Asegúrate de que tienes una [cuenta de desarrollador](/es/resources/fundamentals/developer-portal) aprobada antes de intentar realizar una solicitud a la API. También debes usar el :env\_name correcto en la solicitud, que puedes configurar en la página de [entornos de desarrollo](/es/resources/fundamentals/developer-portal).
* **Enterprise** - Asegúrate de que tu gestor de cuenta te haya habilitado el acceso a la Account Activity API.
* Asegúrate de haber configurado correctamente tu URI. Este error puede producirse si has introducido una URI incorrecta en tu solicitud.
#### Código 214 - La URL del webhook no cumple con los requisitos.
* Asegúrate de usar HTTPS.
* La URL de tu webhook podría estar mal formada.
* Obtén más información sobre cómo configurar la URL de tu webhook en la sección [Develop webhook consumer app](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#3-develop-webhook-consumer-app) de la página [Getting started with webhooks](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#getting-started-with-webhooks).
#### Código 214 - Alta latencia en la solicitud GET de CRC. Tu webhook debe responder en menos de 3 segundos.
* Esto significa que tu servidor es lento. Asegúrate de responder al CRC en un plazo máximo de 3 segundos.
#### Código 214 - Código de respuesta distinto de 200 durante la solicitud GET de CRC (es decir, 404, 500, etc.).
* Tu servidor está caído. Asegúrate de que tu servidor esté funcionando correctamente.
#### Código 214 - Ya se han creado demasiados recursos.
* **Enterprise** - Ya has usado todos tus webhooks. Utiliza el endpoint [GET webhooks](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#get-account-activity-webhooks) con cada una de tus Apps registradas para identificar en qué Apps están configurados tus webhooks.
#### Código 261 - La aplicación no puede realizar acciones de escritura.
* La App que estás utilizando con la API no tiene configurado el [nivel de permiso](/es/resources/fundamentals/developer-apps#app-permissions) adecuado para su access token y access token secret. Dirígete a la pestaña «Keys and tokens» en el panel de [X apps](/es/resources/fundamentals/developer-apps) y comprueba los niveles de permiso asignados a tu access token y access token secret. Si está configurado en cualquier valor distinto de «Read, write and Direct Messages», tendrás que ajustar la configuración en la pestaña «Permission» y regenerar tu access token y access token secret para aplicar la nueva configuración.
* Como alternativa, es posible que estés intentando registrar un webhook utilizando autenticación solo de App, lo cual no es compatible. Autentícate con contexto de usuario tal como se indica en las secciones de Referencia de la API para registrar un webhook para la [Enterprise Account Activity API](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#post-account-activity-webhooks).
## Índice de referencia de la Account Activity API
| | |
| :------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Purpose** | Enterprise |
| Registra una URL de webhook / genera un webhook\_id | [POST
webhooks](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#enterprise-account-activity-api) |
| Devuelve todas las URL de webhook y sus estados | [GET
webhooks](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#get-account-activity-webhooks) |
| Activa manualmente una comprobación de respuesta al desafío | [PUT
webhooks/:webhook\_id](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#put-account-activity-webhooks-webhook-id) |
| Suscribe una aplicación a los eventos de una cuenta | [POST
webhooks/:webhook\_id/subscriptions/all](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#post-account-activity-webhooks-webhook-id-subscriptions-all) |
| Devuelve el número de suscripciones activas actualmente | [GET
subscriptions/count](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#get-account-activity-subscriptions-count) |
| Comprueba si un webhook está suscrito a una cuenta | [GET
webhooks/:webhook\_id/subscriptions/all](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#get-account-activity-webhooks-webhook-id-subscriptions-all) |
| Devuelve una lista de suscripciones activas actualmente | [GET
webhooks/:webhook\_id/subscriptions/all/list](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#get-account-activity-subscriptions-count) |
| Elimina el webhook | [DELETE
webhooks/:webhook\_id](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#delete-account-activity-webhooks-webhook-id) |
| Desactiva una suscripción usando OAuth de 3 patas (EN DESUSO) | [DELETE
webhooks/:webhook\_id/subscriptions/all](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#delete-account-activity-webhooks-webhook-id-subscriptions-all-deprecated) |
| Desactiva una suscripción usando OAuth solo para aplicaciones | [DELETE
webhooks/:webhook\_id/subscriptions/:user\_id/all.json](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#delete-account-activity-webhooks-webhook-id-subscriptions-user-id-all-json) |
| Reenvía las actividades a un webhook | [POST
replay/webhooks/:webhook\_id/subscriptions/all](/es/x-api/enterprise-gnip-2.0/fundamentals/account-activity#delete-account-activity-webhooks-webhook-id-subscriptions-all-deprecated) |
### API de actividad de cuentas empresariales
#### POST account\_activity/webhooks[](#post-account-activity-webhooks "Enlace permanente a este encabezado")
Registra una nueva URL de webhook para el contexto de la aplicación especificado. La URL se validará mediante una solicitud CRC antes de guardarse. En caso de que la validación falle, se devolverá un mensaje de error detallado al solicitante.
El número de webhooks permitidos lo determina el paquete de facturación.
### URL del recurso[](#resource-url "Permalink to this headline")
`https://api.x.com/1.1/account_activity/webhooks.json`
### Información del recurso[](#resource-information "Permalink to this headline")
| | |
| :------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Formato de la respuesta | JSON |
| Requiere autenticación | Sí (contexto de usuario: todos los tokens de consumidor y de acceso) |
| Sujeto a límite de frecuencia | Sí |
| Solicitudes / ventana de 15 minutos (autenticación de usuario) | 15 |
| Compatibilidad con edición de Tweets | Todos los objetos de Tweet incluirán metadatos de edición de Tweet que describen el historial de ediciones del Tweet. Consulta la página ["Aspectos fundamentales de las ediciones de Tweet"](/es/x-api/enterprise-gnip-2.0/fundamentals/edit-tweets) para obtener más detalles. |
### Parámetros[](#parameters "Permalink to this headline")
| | |
| :---------------- | :--------------------------------------- |
| url (obligatorio) | URL codificada del endpoint de callback. |
### Ejemplo de solicitud[](#example-request "Enlace permanente a este título")
\$ curl --request POST
\--url '[https://api.x.com/1.1/account\_activity/webhooks.json?url=https%3A%2F%2Fyour\_domain.com%2Fwebhooks%2Ftwitter%2F0\'](https://api.x.com/1.1/account\_activity/webhooks.json?url=https%3A%2F%2Fyour\_domain.com%2Fwebhooks%2Ftwitter%2F0\');
\--header 'authorization: OAuth oauth\_consumer\_key="CONSUMER\_KEY", oauth\_nonce="GENERATED", oauth\_signature="GENERATED", oauth\_signature\_method="HMAC-SHA1", oauth\_timestamp="GENERATED", oauth\_token="ACCESS\_TOKEN", oauth\_version="1.0"'
### Respuestas HTTP[](#http-responses "Permalink to this headline")
| Código HTTP | Mensaje |
| :---------- | :------------------------------------------------------------------------------------- |
| 200 | La URL del webhook está registrada en la aplicación proporcionada |
| 403 | Hay un error en tu solicitud. Consulta la sección de mensajes de error a continuación. |
### Ejemplo de respuesta: éxito[](#example-response-success "Permalink to this headline")
```json theme={null}
_HTTP 200_
{
"id": "1234567890",
"url": "https://your_domain.com/webhook/twitter/0",
"valid": true,
"created_at": "2016-06-02T23:54:02Z"
}
```
### Mensajes de error[](#error-messages "Enlace permanente a este encabezado")
| Código | Mensaje |
| :----- | :------------------------------------------------------------------------------------------------- |
| 214 | La URL del webhook no cumple los requisitos. |
| 214 | Ya se han creado demasiados recursos. |
| 214 | La URL del webhook no cumple los requisitos. Token CRC o formato de respuesta JSON no válidos. |
| 214 | Alta latencia en la solicitud GET de CRC. El webhook debe responder en menos de 3 segundos. |
| 214 | Código de respuesta distinto de 200 durante la solicitud GET de CRC (por ejemplo, 404, 500, etc.). |
*HTTP 403*
```json theme={null}
{
"errors": [
{
"code": 214,
"message": "Too many resources already created."
}
]
}
```
#### GET account\_activity/webhooks[](#get-account-activity-webhooks "Permalink to this headline")
Devuelve todas las URL y sus estados para la aplicación indicada.
Marcamos una URL como no válida si falla la comprobación diaria de validación. Para volver a habilitar la URL, llama al endpoint de actualización.
### URL del recurso[](#resource-url "Enlace permanente a este encabezado")
`https://api.x.com/1.1/account_activity/webhooks.json`
### Información del recurso[](#resource-information "Permalink to this headline")
| | |
| :--------------------------------------------------------- | :--------------------------- |
| Formato de respuesta | JSON |
| Requiere autenticación | Sí (solo App - Bearer Token) |
| Con límite de uso | Sí |
| Solicitudes / ventana de 15 minutos (autenticación de App) | 15 |
### Ejemplo de solicitud[](#example-request "Permalink to this headline")
```bash theme={null}
$ curl --request GET
--url https://api.x.com/1.1/account_activity/webhooks.json
--header 'authorization: Bearer TOKEN'
```
### Ejemplo de respuesta[](#example-response "Permalink to this headline")
*HTTP 200 OK*
```json theme={null}
[
{
"id": "1234567890",
"url": "https://your_domain.com/webhook/twitter/0",
"valid": true,
"created_at": "2016-06-02T23:54:02Z"
}
{
"id": "2468013579",
"url": "https://your_domain2.com/webhook/twitter/0",
"valid": true,
"created_at": "2016-06-04T22:31:29Z"
}
]
```
### Mensajes de error[](#error-messages "Permalink to this headline")
| Código | Mensaje |
| :----- | :------------------------------- |
| 99 | No tienes acceso a este recurso. |
#### PUT account\_activity/webhooks/:webhook\_id[](#put-account-activity-webhooks-webhook-id "Permalink to this headline")
Activa la comprobación de desafío-respuesta (CRC) para la URL del webhook especificado. Si la comprobación se realiza correctamente, devuelve un 204 y vuelve a habilitar el webhook estableciendo su estado en `valid`.
### URL del recurso[](#resource-url "Enlace permanente a este encabezado")
`https://api.x.com/1.1/account_activity/webhooks/:webhook_id.json`
### Información del recurso[](#resource-information "Permalink to this headline")
| | |
| :------------------------------------------------------------- | :------------------------------------------------------------------- |
| Formato de respuesta | JSON |
| Requiere autenticación | Sí (contexto de usuario: todos los tokens de consumidor y de acceso) |
| Con límite de frecuencia | Sí |
| Solicitudes / ventana de 15 minutos (autenticación de usuario) | 15 |
### Parámetros[](#parameters "Enlace permanente a este encabezado")
| | |
| :--------------------- | :------------------------------------------------ |
| webhook\_id (required) | ID del webhook. Se define en la ruta del recurso. |
### Ejemplo de solicitud[](#example-request "Permalink to this headline")
```json theme={null}
$ curl --request PUT
--url https://api.x.com/1.1/account_activity/webhooks/:WEBHOOK_ID.json
--header 'authorization: OAuth oauth_consumer_key="CONSUMER_KEY", oauth_nonce="GENERATED", oauth_signature="GENERATED", oauth_signature_method="HMAC-SHA1", oauth_timestamp="GENERATED", oauth_token="ACCESS_TOKEN", oauth_version="1.0"'
```
### Respuesta[](#response "Permalink to this headline")
*HTTP 204 OK*
```
{ }
```
### Mensajes de error[](#error-messages "Permalink to this headline")
| Código | Mensaje |
| :----- | :------------------------------------------------------------------------------------------------- |
| 34 | El webhook no existe o está asociado con una aplicación de X distinta. |
| 214 | La URL del webhook no cumple los requisitos. |
| 214 | La URL del webhook no cumple los requisitos. Token CRC o formato de respuesta JSON no válidos. |
| 214 | Alta latencia en la solicitud GET de CRC. Tu webhook debe responder en menos de 3 segundos. |
| 214 | Código de respuesta distinto de 200 durante la solicitud GET de CRC (por ejemplo, 404, 500, etc.). |
#### POST account\_activity/webhooks/:webhook\_id/subscriptions/all[](#post-account-activity-webhooks-webhook-id-subscriptions-all "Permalink to this headline")
Suscribe la aplicación proporcionada a todos los eventos del contexto de usuario proporcionado para todos los tipos de mensajes. Después de la activación, todos los eventos para el usuario que realiza la solicitud se enviarán al webhook de la aplicación mediante una solicitud POST.
Actualmente, las suscripciones están limitadas en función de la configuración de tu cuenta. Si necesitas añadir más suscripciones, ponte en contacto con tu administrador de cuenta.
### URL del recurso[](#resource-url "Enlace permanente a este título")
`https://api.x.com/1.1/account_activity/webhooks/:webhook_id/subscriptions/all.json`
### Información del recurso[](#resource-information "Permalink to this headline")
| | |
| :--------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
| Formato de respuesta | JSON |
| Requiere autenticación | Sí (OAuth de 3 participantes: clave de consumidor en lista de permitidos y token de acceso del usuario suscriptor) |
| Con límite de frecuencia | Sí |
| Solicitudes / ventana de 15 min (autenticación de usuario) | 500 |
### Parámetros[](#parameters "Permalink to this headline")
| | |
| :---------------------- | :---------------------------------------------------------- |
| webhook\_id (requerido) | Identificador del webhook. Definido en la ruta del recurso. |
### Ejemplo de solicitud[](#example-request "Enlace permanente a este encabezado")
```bash theme={null}
$ curl --request POST
--url https://api.x.com/1.1/account_activity/webhooks/:WEBHOOK_ID/subscriptions/all.json
--header 'authorization: OAuth oauth_consumer_key="WHITELISTED_CONSUMER_KEY", oauth_nonce="GENERATED", oauth_signature="GENERATED", oauth_signature_method="HMAC-SHA1", oauth_timestamp="GENERATED", oauth_token="SUBSCRIBING_USER'S_ACCESS_TOKEN", oauth_version="1.0"'
```
### Respuesta de ejemplo - satisfactoria[](#example-response-success "Permalink to this headline")
*HTTP 204 SIN CONTENIDO*
```
{}
```
### Mensajes de error[](#error-messages "Permalink to this headline")
| Código | Mensaje |
| :----- | :--------------------------------------------------------------------------------------------------- |
| 34 | El webhook no existe o está asociado a otra aplicación de X. |
| 348 | La aplicación cliente no tiene permiso para acceder a las suscripciones de webhooks de este usuario. |
#### GET account\_activity/subscriptions/count[](#get-account-activity-subscriptions-count "Permalink to this headline")
Devuelve el número de suscripciones que están activas actualmente en tu cuenta. Ten en cuenta que el endpoint /count requiere OAuth de solo aplicación, por lo que debes realizar las solicitudes usando un Bearer Token en lugar de usar el contexto de usuario.
### URL del recurso[](#resource-url "Enlace permanente a este encabezado")
`https://api.x.com/1.1/account_activity/subscriptions/count.json`
### Información del recurso[](#resource-information "Permalink to this headline")
| | |
| :----------------------------------------------------------- | :--------------------------- |
| Formato de respuesta | Código de respuesta HTTP |
| Requiere autenticación | Sí (solo App - Bearer Token) |
| Con límite de frecuencia | Sí |
| Solicitudes por ventana de 15 minutos (autenticación de App) | 15 |
### Códigos de respuesta HTTP[](#http-response-codes "Permalink to this headline")
| | |
| :--- | :---------------------------------------------------------------------------------- |
| Code | Mensaje |
| 200 | Correcto. Se devolverá el número de suscripciones del webhook solicitado. |
| 401 | Tu aplicación no tiene permiso para ver las suscripciones del webhook especificado. |
### Ejemplo de solicitud[](#example-request "Enlace permanente a este encabezado")
```bash theme={null}
$ curl --request GET
--url https://api.x.com/1.1/account_activity/subscriptions/count.json
--header 'authorization: Bearer TOKEN'
```
### Ejemplo de respuesta - éxito[](#example-response-success "Enlace permanente a este título")
*HTTP 200*
```bash theme={null}
{
"account_name":"my-account",
"subscriptions_count_all":"1",
"subscriptions_count_direct_messages":"0",
"provisioned_count":"50"
}
```
### Mensajes de error[](#error-messages "Permalink to this headline")
| Código | Mensaje |
| :----- | :---------------------------------- |
| 32 | No se pudo autenticar tu identidad. |
*HTTP 401*
```abash theme={null}
{
"errors": [
{
"code": 32,
"message": "Could not authenticate you."
}
]
}
```
#### GET account\_activity/webhooks/:webhook\_id/subscriptions/all[](#get-account-activity-webhooks-webhook-id-subscriptions-all "Enlace permanente a este título")
Proporciona un método para determinar si una configuración de webhook está suscrita a los eventos del usuario indicado. Si el contexto de usuario indicado tiene una suscripción activa con la aplicación indicada, devuelve 204 OK. Si el código de respuesta no es 204, entonces el usuario no tiene una suscripción activa. Consulta el código de respuesta HTTP y los mensajes de error a continuación para obtener más detalles.
### URL del recurso[](#resource-url "Permalink to this headline")
`https://api.x.com/1.1/account_activity/webhooks/:webhook_id/subscriptions/all.json`
### Información del recurso[](#resource-information "Permalink to this headline")
| | |
| :------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- |
| Formato de respuesta | JSON |
| Requiere autenticación | Sí (OAuth de 3 partes: clave de consumidor en lista de permitidos y token de acceso del usuario suscriptor) |
| Con límite de frecuencia | Sí |
| Solicitudes / ventana de 15 minutos (autenticación de usuario) | 500 |
### Parámetros[](#parameters "Permalink to this headline")
| | |
| :--------------------- | :--------------------------------------------------------- |
| webhook\_id (required) | Identificador de webhook. Definido en la ruta del recurso. |
### Ejemplo de solicitud[](#example-request "Enlace permanente a este encabezado")
\$ curl --request GET
\--url [https://api.x.com/1.1/account\_activity/webhooks/:WEBHOOK\_ID/subscriptions/all.json](https://api.x.com/1.1/account\_activity/webhooks/:WEBHOOK\_ID/subscriptions/all.json)
\--header 'authorization: OAuth oauth\_consumer\_key="WHITELISTED\_CONSUMER\_KEY", oauth\_nonce="GENERATED", oauth\_signature="GENERATED", oauth\_signature\_method="HMAC-SHA1", oauth\_timestamp="GENERATED", oauth\_token="SUBSCRIBING\_USER'S\_ACCESS\_TOKEN", oauth\_version="1.0"'
### Ejemplo de respuesta - Éxito[](#example-response-success "Permalink to this headline")
*HTTP 204 SIN CONTENIDO*
```
{ }
```
#### GET account\_activity/webhooks/:webhook\_id/subscriptions/all/list[](#get-account-activity-webhooks-webhook-id-subscriptions-all-list "Permalink to this headline")
Devuelve una lista de las suscripciones actuales del tipo All Activity para el webhook especificado. Ten en cuenta que el endpoint /list requiere OAuth solo de aplicación, por lo que las solicitudes deben realizarse usando un Bearer Token en lugar de usar el contexto de usuario.
### URL del recurso[](#resource-url "Permalink to this headline")
`https://api.x.com/1.1/account_activity/webhooks/:webhook_id/subscriptions/all/list.json`
### Información del recurso[](#resource-information "Permalink to this headline")
| | |
| :--------------------------------------------------------------- | :---------------------------------- |
| Formato de la respuesta | Código de respuesta HTTP |
| Requiere autenticación | Sí (solo aplicación - Bearer Token) |
| Sujeto a límites de frecuencia | Sí |
| Solicitudes / ventana de 15 min (autenticación de la aplicación) | 50 |
### Parámetros[](#parameters "Permalink to this headline")
| | |
| :--------------------- | :----------------------------------------------- |
| webhook\_id (required) | ID del webhook. Definido en la ruta del recurso. |
### Códigos de respuesta HTTP[](#http-response-codes "Permalink to this headline")
| Código | Mensaje |
| :----- | :----------------------------------------------------------------------------------- |
| 200 | Éxito. Se devolverá una lista de suscripciones del webhook solicitado. |
| 401 | Tu aplicación no tiene permisos para ver las suscripciones del webhook especificado. |
### Ejemplo de solicitud[](#example-request "Enlace permanente a este encabezado")
\$ curl --request GET
\--url [https://api.x.com/1.1/account\_activity/webhooks/:WEBHOOK\_ID/subscriptions/all/list.json](https://api.x.com/1.1/account\_activity/webhooks/:WEBHOOK\_ID/subscriptions/all/list.json)
\--header 'authorization: Bearer TOKEN'
### Ejemplo de respuesta - correcta[](#example-response-success "Permalink to this headline")
*HTTP 200*
```bash theme={null}
{
"webhook_id": "1234567890",
"webhook_url": "https://your_domain.com/webhook/twitter/0",
"application_id": "11231812",
"subscriptions": [{
"user_id": "20212306"
}]
}
```
### Mensajes de error[](#error-messages "Permalink to this headline")
| Code | Message |
| :--- | :------------------------------- |
| 32 | No se pudo autenticar tu cuenta. |
*HTTP 401*
```bash theme={null}
{
"errors": [
{
"code": 32,
"message": "Could not authenticate you."
}
]
}
```
#### DELETE account\_activity/webhooks/:webhook\_id[](#delete-account-activity-webhooks-webhook-id "Enlace permanente a este encabezado")
Elimina el webhook de la configuración de la aplicación proporcionada. El identificador del webhook se puede obtener mediante una llamada a GET /1.1/account\_activity/webhooks.
### URL del recurso[](#resource-url "Permalink to this headline")
`https://api.x.com/1.1/account_activity/webhooks/:webhook_id.json`
### Información del recurso[](#resource-information "Permalink to this headline")
| | |
| :--------------------------------------------------------- | :------------------------------------------------------------------- |
| Formato de respuesta | JSON |
| Requiere autenticación | Sí (contexto de usuario: todos los tokens de consumidor y de acceso) |
| Con límite de frecuencia | Sí |
| Solicitudes / ventana de 15 min (autenticación de usuario) | 15 |
### Parámetros[](#parameters "Permalink to this headline")
| | |
| :------------------------ | :---------------------------------------------------------- |
| webhook\_id (obligatorio) | Identificador del webhook. Definido en la ruta del recurso. |
### Ejemplo de solicitud[](#example-request "Enlace permanente a este encabezado")
```bash theme={null}
$ curl --request DELETE
--url https://api.x.com/1.1/account_activity/webhooks/:WEBHOOK_ID.json
--header 'authorization: OAuth oauth_consumer_key="CONSUMER_KEY", oauth_nonce="GENERATED", oauth_signature="GENERATED", oauth_signature_method="HMAC-SHA1", oauth_timestamp="GENERATED", oauth_token="ACCESS_TOKEN", oauth_version="1.0"'
```
### Respuesta[](#response "Enlace permanente a este encabezado")
*HTTP 204 OK*
```
{ }
```
#### DELETE account\_activity/webhooks/:webhook\_id/subscriptions/all (OBSOLETO)[](#delete-account-activity-webhooks-webhook-id-subscriptions-all-deprecated- "Enlace permanente a este encabezado")
Desactiva las suscripciones del contexto de usuario y de la aplicación proporcionados. Después de la desactivación, todos los eventos del usuario que realiza la solicitud dejarán de enviarse a la URL del webhook.
### URL del recurso[](#resource-url "Permalink to this headline")
`https://api.x.com/1.1/account_activity/webhooks/:webhook_id/subscriptions/all.json`
### Información del recurso[](#resource-information "Permalink to this headline")
| | |
| :------------------------------------------------------------- | :--------------------------------------------------------------------------------------- |
| Formato de respuesta | JSON |
| Requiere autenticación | Sí (OAuth de 3 partes: consumer key en lista blanca y access token del usuario suscrito) |
| Con límite de frecuencia | Sí |
| Solicitudes / ventana de 15 minutos (autenticación de usuario) | 500 |
### Parámetros[](#parameters "Permalink to this headline")
| | |
| :--------------------- | :---------------------------------------------------------- |
| webhook\_id (required) | Identificador del webhook. Definido en la ruta del recurso. |
### Ejemplo de solicitud[](#example-request "Permalink to this headline")
```bash theme={null}
$ curl --request DELETE
--url https://api.x.com/1.1/account_activity/webhooks/:WEBHOOK_ID/subscriptions/all.json
--header 'authorization: OAuth oauth_consumer_key="WHITELISTED_CONSUMER_KEY", oauth_nonce="GENERATED", oauth_signature="GENERATED", oauth_signature_method="HMAC-SHA1", oauth_timestamp="GENERATED", oauth_token="SUBSCRIBED_USER'S_ACCESS_TOKEN", oauth_version="1.0"'
```
Ejemplo de solicitud
```
{ }
```
#### DELETE /account\_activity/webhooks/:webhook\_id/subscriptions/:user\_id/all.json[](#delete-account-activity-webhooks-webhook-id-subscriptions-user-id-all-json "Permalink to this headline")
Desactiva la suscripción para el webhook y la ID de usuario especificados. Después de la desactivación, todos los eventos para el usuario que realiza la solicitud dejarán de enviarse a la URL del webhook. Ten en cuenta que este endpoint requiere OAuth de solo aplicación, por lo que las solicitudes deben realizarse usando un Bearer Token en lugar de un contexto de usuario.
### URL del recurso[](#resource-url "Permalink to this headline")
`https://api.x.com/1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/all.json`
### Información del recurso[](#resource-information "Permalink to this headline")
| | |
| :------------------------------------ | :--------------------------- |
| Formato de respuesta | JSON |
| Requiere autenticación | Sí (solo App - Bearer Token) |
| Sujeto a límite de frecuencia | Sí |
| Solicitudes por ventana de 15 minutos | 500 |
### Ejemplo de solicitud[](#example-request "Permalink to this headline")
```bash theme={null}
$ curl --request DELETE
--url https://api.x.com/1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/all.json
--header 'authorization: Bearer TOKEN'
```
### Respuesta[](#response "Enlace permanente a este encabezado")
*HTTP 204 NO CONTENT*
### Mensajes de error[](#error-messages "Enlace permanente a este encabezado")
| Código | Mensaje |
| :----- | :------------------------------------------------------------------------------------------------------------------------- |
| 404 | Lo sentimos, esa página no existe. - Esto suele ocurrir cuando el id de usuario especificado en realidad no está suscrito. |
### Replay API
**POST /1.1/account\_activity/replay/webhooks/:webhook\_id/subscriptions/all.json [¶](#post-1-1-account-activity-replay-webhooks-webhook-id-subscriptions-all-json- "Enlace permanente a este encabezado")**
Envía una solicitud para recuperar actividades de hasta los últimos cinco días de todas las suscripciones presentes durante las ventanas de fecha y hora especificadas en la solicitud. Si tu webhook tiene suscripciones de usuario activas, también recibirás esos eventos de forma simultánea. Nota: realizamos un CRC antes de entregar eventos de replay.
| | |
| :-------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Request Method** | HTTP POST |
| **URL** | /1.1/account\_activity/replay/webhooks/:webhook\_id/subscriptions/all.json?from\_date=yyyymmddhhmm\&to\_date=yyyymmddhhmm |
| **Response Format** | JSON |
| **Requires Authentication** | Sí (solo aplicación - Bearer Token) |
| **Rate Limit** | 5 solicitudes cada 15 minutos. Actualmente no existe un límite máximo para la cantidad de jobs de replay que se pueden solicitar. |
| **from\_date** | La marca de tiempo UTC más antigua (inicial) a partir de la cual se proporcionarán los eventos; debe estar en el formato 'yyyymmddhhmm'. La marca de tiempo tiene granularidad de minutos y es inclusiva (es decir, 12:00 incluye el minuto 00). Las horas válidas deben estar dentro de los últimos 5 días, en hora UTC, y no ser más recientes que 31 minutos antes del momento actual. Se recomienda que from\_date y to\_date estén dentro de un intervalo de aproximadamente 2 horas. |
| **to\_date** | La marca de tiempo UTC más reciente (final) hasta la cual se proporcionarán los eventos; debe estar en el formato 'yyyymmddhhmm'. La marca de tiempo tiene granularidad de minutos y es exclusiva (es decir, 12:30 no incluye el minuto 30 de la hora). Las horas válidas deben estar dentro de los últimos 5 días, en hora UTC, y no ser más recientes que 10 minutos antes del momento actual. |
#### Respuestas
Las siguientes respuestas pueden ser devueltas por la API. La mayoría de los códigos de error se devuelven con una cadena que incluye detalles adicionales en el cuerpo. Para respuestas que no sean 200, debes resolver el error e intentarlo de nuevo.
| Status | Text | Error Code | Description | Message |
| :----- | :-------------------- | :--------- | :----------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------- |
| 202 | Accepted | N/A | La solicitud se realizó correctamente y se enviarán las actividades. | N/A |
| 400 | Bad Request | 214 | El webhook se ha marcado como no válido. | El webhook está marcado como no válido y requiere una verificación CRC. |
| 400 | Bad Request | 357 | Falta un parámetro de consulta. | : queryParam es obligatorio. |
| 400 | Bad Request | 358 | La ruta o el parámetro de consulta tiene un formato incorrecto. | No se puede analizar el parámetro. |
| 400 | Bad Request | 360 | El parámetro de ruta es negativo. | webhook\_id: \[] no es mayor o igual que 0. |
| 400 | Bad Request | 368 | from\_date o to\_date no está en el pasado. | : \[\] no está en el pasado. |
| 400 | Bad Request | 356 | from\_date debe ser anterior a to\_date. | from\_date debe ser anterior a to\_date. |
| 400 | Bad Request | 356 | from\_date debe estar dentro de los últimos 5 días. | from\_date debe estar dentro de los últimos 5 días. |
| 401 | Unauthorized | 32 | La autenticación HTTP falló porque se proporcionó autenticación OAuth de 3 patas (3-legged OAuth). | Método de autenticación no válido. Usa únicamente autenticación de aplicación. |
| 401 | Unauthorized | 61 | El Client no tiene permiso para solicitar este método. | El Client no tiene permiso para solicitar este método. |
| 403 | Forbidden | 200 | El Client no tiene una cuenta empresarial con Replay habilitado. | Se requiere una cuenta empresarial de Account Activity API con Replay. Confirma que tienes una cuenta empresarial y que Replay está habilitado. |
| 404 | Not Found | 34 | webhook\_id inexistente; desajuste entre webhook\_id y application\_id. | El webhook no existe o está asociado con una aplicación de X diferente. |
| 409 | Conflict | 355 | Hay una solicitud en curso y deberá terminar de procesarse antes de realizar otra. | Ya hay un trabajo de Replay en curso para este webhook. |
| 429 | Too Many Requests | 88 | Límite de frecuencia alcanzado (se alcanzó el límite del número de solicitudes por período de tiempo). | Demasiadas solicitudes. Reduce la frecuencia de tus solicitudes a la API. |
| 500 | Internal Server Error | 0 | Error interno del servidor. | Error interno del servidor. |
| 503 | Service Unavailable | 67 | Uno o más servicios dependientes en X no están disponibles. | Error del servidor de X. Reintenta usando un patrón de reintentos exponenciales. |
#### Mensaje de "Job completed successfully”
Una vez que el job se complete correctamente, la API Account Activity Replay entregará el siguiente evento de finalización de job. Cuando recibas este evento, el job habrá terminado de ejecutarse y podrás enviar otro.
```json theme={null}
{
"replay\_job\_status": {
"webhook_id": "1234577122340233217",
"job_state": "Complete",
"job\_state\_description": "Job completed successfully"
"job_id": "1095098195724558337"
}
}
```
#### Mensaje "Job failed to complete"
En caso de que tu job no se complete correctamente, devolveremos el siguiente mensaje para animarte a volver a intentar tu job de Replay. Una vez que recibas este evento, el job habrá terminado de ejecutarse y podrás enviar otro.
```json theme={null}
{
"replay\_job\_status": {
"webhook_id": "123451374207332352",
"job_state": "Incomplete",
"job\_state\_description": "Job failed to deliver all events, please retry your replay job",
"job_id": "1093226942650736640"
}
}
```
#### Ejemplo de solicitud con curl
```bash theme={null}
curl --request POST --url 'https://api.x.com/1.1/account_activity/replay/webhooks/:webhook_id/subscriptions/all.json?from_date=yyyymmddhhmm&to_date=yyyymmddhhmm'
--header 'authorization: Bearer TOKEN'
```
#### Ejemplo de respuesta
HTTP 202
```bash theme={null}
{
"job_id": "1234567890",
"created_at": "2016-06-02T23:54:02Z"
}
```