Saltar al contenido
Twexapi
Español
Esc
navegarabrir⌘Jvista previa
En esta página

Zapier

Automatiza Twitter en Zapier para búsqueda de tweets, consulta de usuarios, tendencias, webhooks de plataforma y entregas seguras con cursor a través de TwexAPI.

Automatiza Twitter en Zapier con TwexAPI. Busca tweets, consulta usuarios, lee tweets en tendencia y enruta filas a Slack, Sheets, Airtable, HubSpot o email. TwexAPI usa una sola API key y la URL base REST https://api.twexapi.io.

Elige un patrón de integración en Zapier

Nodo comunitario + agente MCP

Usa un agente compatible con MCP para descubrimiento, luego haz POST de JSON estricto a un Catch Hook de Zapier.

Acciones HTTP Request

Llama a la REST de TwexAPI directamente desde Webhooks by Zapier o una integración privada.

Nodo comunitario estilo n8n

Prefiere el nodo comunitario de n8n dedicado cuando tu equipo ya ejecuta n8n.

La app nativa de X en Zapier fue descontinuada. TwexAPI sigue disponible mediante Catch Hooks, HTTP Request o una app privada de Zapier.

Requisitos previos

  • API key de TwexAPI
  • Cuenta de Zapier con Webhooks by Zapier
  • Destino opcional de Slack, Google Sheets, Airtable, HubSpot o Gmail
  • Agente opcional compatible con MCP conectado a https://api.twexapi.io/mcp

Autenticación con API key

Crea una credencial reutilizable para llamadas REST de TwexAPI:

Autenticación

Selecciona Header Auth o encabezados personalizados en HTTP Request.

Nombre del encabezado

Configura el nombre del encabezado como Authorization.

Valor del encabezado

Pega Bearer YOUR_API_KEY como valor de la credencial.

Para pasos de AI Agent compatibles con MCP fuera de Zapier, configura https://api.twexapi.io/mcp con el encabezado x-api-key: YOUR_API_KEY.

Forma de la integración

Crea un Catch Hook

Usa Webhooks by Zapier y elige Catch Hook para entregas de agentes o POSTs externos.

Recopila filas de TwexAPI

Usa MCP, HTTP Request o un worker externo para producir JSON estricto.

Mapea campos estables

Usa tweet_id como clave de deduplicación. Mapea texto, autor, URL y campos de cursor.

Enruta a destinos

Envía filas a Slack, Sheets, Airtable, HubSpot o email.

Acciones iniciales

Usa HTTP Request o una app privada de Zapier para estas lecturas comunes:

Buscar tweets

POST /twitter/advanced_search/page con searchTerms, sortBy y nextCursor.

Obtener perfil de usuario

GET /twitter/{screen_name}/about

Buscar usuarios

GET /twitter/search-user/{keyword}/{target_count}

Obtener tendencias

GET /twitter/global-trending/tweets con filtros de país, tema y contenido.

Obtener seguidores

POST /v3/twitter/users/followers con nombre de usuario y paginación por cursor.

Crear tweet

POST /twitter/tweets/create después de aprobación humana y configuración de cookie.

Ejemplo HTTP Request: búsqueda de tweets

{
  "method": "POST",
  "url": "https://api.twexapi.io/twitter/advanced_search/page",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  "body": {
    "searchTerms": ["AI agents lang:en"],
    "sortBy": "Latest",
    "nextCursor": ""
  }
}

Entrega de resultados

Usa un paso Formatter o Code cuando el siguiente paso del Zap solo necesite campos estables de entrega.

Página de búsqueda de tweets

Guarda la consulta; mapea el id de cada tweet a tweet_id, más text, nombre de usuario del autor y created_at; conserva has_next_page y next_cursor.

Filas de perfil de usuario

Guarda el id de origen como user_id, más username, name, conteos de seguidores y entrada de búsqueda.

Filas de tendencias

Guarda país, tema, etiqueta de contenido y filas de tweets con metadatos de la ejecución del flujo.

Escritura de tweet o respuesta

Previsualiza con el CLI --dry-run antes de publicar desde Zapier. Las acciones de escritura requieren una cookie o auth_token.

Receta 1: investigación con agente MCP a Slack

Prompt sugerido para agente MCP:

Find recent posts about AI agents in fintech, group them by theme, and list 5 accounts worth monitoring.
Return only JSON with route_used, tweets, has_more, and next_cursor.
Each tweet must include tweet_id, author_username, text, created_at, and public_url.
Do not call write endpoints.

Pasos del Zap:

  1. Catch Hook recibe el payload JSON.
  2. Loop o line-item sobre tweets.
  3. Filtra filas vacías.
  4. Envía mensaje a Slack con autor, texto y URL.

Receta 2: búsqueda programada de tweets a Google Sheets

  1. Programa el Zap diaria o por hora.
  2. HTTP Request llama a POST /twitter/advanced_search/page.
  3. Itera sobre los tweets devueltos.
  4. Añade tweet_id, autor, texto, created_at y URL construida a Sheets.
  5. Guarda next_cursor en Storage by Zapier si un Zap posterior debe continuar la paginación.

Receta 3: alerta de tweets en tendencia

{
  "method": "GET",
  "url": "https://api.twexapi.io/twitter/global-trending/tweets",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  },
  "query": {
    "country": "United States",
    "topic": "Sports",
    "content": "NFL",
    "count": 20
  }
}

Enruta texto resumen a Slack o email después de filtrar por engagement.

Manejo de errores

Estado Comportamiento del Zap
400 Detén y corrige el mapeo de la solicitud.
401 Falla el Zap y alerta a operaciones para reemplazar la API key.
403 Pausa hasta que se corrija el acceso a la cuenta o los créditos.
429 Retrasa y reintenta usando el replay integrado de Zapier.
5xx Reintenta con precaución; conserva el cursor.

Blueprint de integración privada

Si empaquetas TwexAPI como integración privada de Zapier, empieza con una superficie pequeña y confiable:

Recurso Acciones
Tweets Buscar tweets, obtener detalle de tweet, crear tweet después de aprobación
Usuarios Obtener usuario, buscar usuarios
Tendencias Obtener tweets en tendencia global
Seguidores Obtener página de seguidores v3

Usa REST para acciones empaquetadas y MCP para flujos de descubrimiento impulsados por agentes.

Lista de verificación de pruebas

  • Prueba el Catch Hook con un payload real de entrega TwexAPI.
  • Confirma que cada solicitud REST incluye Authorization: Bearer YOUR_API_KEY.
  • Usa tweet_id como clave de deduplicación antes de escribir en una app de destino.
  • Guarda next_cursor en Storage by Zapier para Zaps de seguimiento.
  • Mantén acciones de escritura como borradores hasta que un humano apruebe el texto final.

Próximos pasos

¿Te ha resultado útil esta página?