API de Account Activity

Recibe en tiempo real la actividad de la cuenta mediante webhooks

La Account Activity API proporciona eventos de actividad de la cuenta en tiempo real a tu webhook. Suscríbete a cuentas de usuario y recibe notificaciones cuando publiquen, reciban mensajes directos (DM), consigan nuevos seguidores y más.

​

Descripción general

Entrega con webhooks

Eventos entregados a tu servidor

En tiempo real

Notificaciones de eventos al instante

Completo

Publicaciones, DMs, seguidores, Me gusta y más

Basado en suscripciones

Suscríbete a cuentas de usuario

---

​

Cómo funciona

1. Registrar webhook — Registra la URL del webhook
2. Suscribir usuarios — Añade suscripciones de usuario
3. Recibir eventos — Obtén eventos de actividad mediante solicitudes POST
4. Procesar eventos — Procesa los eventos en la aplicación

---

​

Tipos de eventos

Categoría	Eventos
Publicaciones	Crear, eliminar, marcar como favorito, quitar de favoritos
Mensajes directos	Recibido, enviado, indicador de escritura
Seguimientos	Seguir, dejar de seguir
Bloqueos	Bloquear, desbloquear
Silencios	Silenciar, dejar de silenciar

---

​

Seguridad de los webhooks

Todas las solicitudes de webhook incluyen:

• Validación CRC — Verificar la autenticidad del webhook
• Encabezado de firma — x-twitter-webhooks-signature
• HTTPS obligatorio — Todas las URL de webhook deben utilizar HTTPS

---

​

Ejemplo: registrar un webhook

curl -X POST "https://api.x.com/1.1/account_activity/all/env-name/webhooks.json?\
url=https%3A%2F%2Fyour-server.com%2Fwebhook" \
  -H "Authorization: OAuth oauth_consumer_key=..."

---

​

Primeros pasos

Requisitos previos

• Una cuenta de desarrollador aprobada
• Un Proyecto y App en la Consola de desarrollador
• Un endpoint de webhook HTTPS accesible públicamente

Flujo de actividad

Alternativa mediante streaming a los webhooks

Guía de migración

Migra desde v1.1

Referencia de la API

Documentación completa del endpoint