Aller au contenu
Twexapi
Français
Esc
naviguerouvrir⌘Japerçu
Sur cette page

Zapier

Construisez une automatisation Twitter Zapier pour la recherche de tweets, le lookup utilisateur, les tweets tendance, les webhooks de plateforme et les handoffs sûrs avec curseurs via TwexAPI.

Construisez une automatisation Twitter Zapier avec TwexAPI. Recherchez des tweets, consultez des utilisateurs, lisez les tweets tendance et routez des lignes vers Slack, Sheets, Airtable, HubSpot ou email. TwexAPI utilise une clé API et l’URL de base REST https://api.twexapi.io.

Choisir un modèle d’intégration Zapier

Nœud communautaire + agent MCP

Utilisez un agent compatible MCP pour la découverte, puis POSTez du JSON strict vers un Catch Hook Zapier.

Actions HTTP Request

Appelez la REST TwexAPI directement depuis Webhooks by Zapier ou une intégration privée.

Nœud communautaire style n8n

Préférez le nœud communautaire n8n dédié lorsque votre équipe exécute déjà n8n.

L’application native Zapier X a été décommissionnée. TwexAPI reste disponible via Catch Hooks, HTTP Request ou une application Zapier privée.

Prérequis

  • Clé API TwexAPI
  • Compte Zapier avec Webhooks by Zapier
  • Destination Slack, Google Sheets, Airtable, HubSpot ou Gmail optionnelle
  • Agent compatible MCP connecté à https://api.twexapi.io/mcp optionnel

Authentification clé API

Créez un identifiant réutilisable pour les appels REST TwexAPI :

Authentification

Sélectionnez Header Auth ou headers personnalisés dans HTTP Request.

Nom du header

Définissez le nom du header à Authorization.

Valeur du header

Collez Bearer YOUR_API_KEY comme valeur d’identifiant.

Pour les étapes AI Agent compatibles MCP en dehors de Zapier, configurez https://api.twexapi.io/mcp avec le header x-api-key: YOUR_API_KEY.

Forme d’intégration

Créer un Catch Hook

Utilisez Webhooks by Zapier et choisissez Catch Hook pour les handoffs agent ou POSTs externes.

Collecter les lignes TwexAPI

Utilisez MCP, HTTP Request ou un worker externe pour produire du JSON strict.

Mapper les champs stables

Utilisez tweet_id comme clé de déduplication. Mappez le texte, l’auteur, l’URL et les champs curseur.

Router vers les destinations

Envoyez les lignes vers Slack, Sheets, Airtable, HubSpot ou email.

Actions de démarrage

Utilisez HTTP Request ou une application Zapier privée pour ces lectures courantes :

Rechercher des tweets

POST /twitter/advanced_search/page avec searchTerms, sortBy et nextCursor.

Obtenir le profil utilisateur

GET /twitter/{screen_name}/about

Rechercher des utilisateurs

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

Obtenir les tendances

GET /twitter/global-trending/tweets avec filtres country, topic et content.

Obtenir les abonnés

POST /v3/twitter/users/followers avec username et pagination par curseur.

Créer un tweet

POST /twitter/tweets/create après approbation humaine et configuration cookie.

Exemple HTTP Request : recherche 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": ""
  }
}

Handoff de résultats

Utilisez une étape Formatter ou Code lorsque l’étape Zap suivante n’a besoin que de champs de handoff stables.

Page de recherche de tweets

Stockez la requête ; mappez chaque tweet id vers tweet_id, plus text, username d’auteur et created_at ; gardez has_next_page et next_cursor.

Lignes de profil utilisateur

Stockez le id source comme user_id, plus username, name, compteurs d’abonnés et entrée de lookup.

Lignes de tendances

Stockez le pays, le sujet, le tag de contenu et les lignes de tweet avec les métadonnées d’exécution du workflow.

Écriture de tweet ou réponse

Prévisualisez avec le CLI --dry-run avant de publier depuis Zapier. Les actions d’écriture nécessitent un cookie ou auth_token.

Recette 1 : recherche agent MCP vers Slack

Prompt agent MCP suggéré :

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.

Étapes Zap :

  1. Catch Hook reçoit le payload JSON.
  2. Loop ou line-item sur tweets.
  3. Filtrez les lignes vides.
  4. Envoyez un message Slack avec auteur, texte et URL.

Recette 2 : recherche de tweets planifiée vers Google Sheets

  1. Planifiez le Zap quotidiennement ou horairement.
  2. HTTP Request appelle POST /twitter/advanced_search/page.
  3. Loop sur les tweets retournés.
  4. Ajoutez tweet_id, auteur, texte, created_at et URL construite à Sheets.
  5. Stockez next_cursor dans Storage by Zapier si un Zap ultérieur doit continuer la pagination.

Recette 3 : alerte tweets tendance

{
  "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
  }
}

Routez le texte de résumé vers Slack ou email après filtrage par engagement.

Gestion des erreurs

Statut Comportement Zap
400 Arrêtez et corrigez le mapping de requête.
401 Échouez le Zap et alertez ops pour remplacer la clé API.
403 Pausez jusqu’à correction de l’accès au compte ou des crédits.
429 Retardez et réessayez avec le replay intégré de Zapier.
5xx Réessayez avec prudence ; préservez le curseur.

Blueprint d’intégration privée

Si vous packagez TwexAPI comme intégration Zapier privée, commencez avec une surface petite et fiable :

Ressource Actions
Tweets Rechercher tweets, obtenir détail tweet, créer tweet après approbation
Users Obtenir utilisateur, rechercher utilisateurs
Trends Obtenir tweets tendance globaux
Followers Obtenir page abonnés v3

Utilisez REST pour les actions packagées et MCP pour les workflows de découverte pilotés par agent.

Checklist de test

  • Testez le Catch Hook avec un payload de handoff TwexAPI réel.
  • Confirmez que chaque requête REST inclut Authorization: Bearer YOUR_API_KEY.
  • Utilisez tweet_id comme clé de déduplication avant écriture vers une app de destination.
  • Stockez next_cursor dans Storage by Zapier pour les Zaps de suivi.
  • Gardez les actions d’écriture comme drafts jusqu’à approbation humaine du texte final.

Prochaines étapes

Cette page vous a-t-elle été utile ?