Docs

TMPL-X-001

X(Twitter)投稿自動化テンプレート

Xintermediatemidverified: 2026-02

sanitized snapshot

Last synced: 2026-02-14

要約

投稿自動化と運用確認の基本フローを、共有可能な形で整理した。
投稿品質と運用継続性の両立を狙い、確認ポイントを明示している。
固有情報を含めないため、外部共有にそのまま利用できる。

決定事項

  • 投稿処理と結果確認を同一フロー内で管理する
  • 失敗時は手動投稿へ戻せる導線を確保する
  • 認証情報は本文に記載しない

未決

  • 投稿文面レビューをどの役割で行うか
  • 失敗通知の一次対応を誰が担うか
  • 投稿停止判断の運用基準をどこに置くか

次アクション

  • 実装担当: 投稿処理と確認処理のテンプレートを整備する
  • 運用担当: 失敗時の手動切替手順を定義する
  • 監督担当: レビュー基準をガイド化する

リスク

  • 投稿品質レビュー不足で誤配信が起こる
  • 停止条件が曖昧だと運用判断が遅れる
  • 認証管理の不備があると安全性が低下する

参照ID

  • TMPL-X-001
  • GUIDE-001

概要

コンテンツカレンダーに基づいてX(Twitter)への投稿を自動化し、手動投稿の負荷を削減する。

対象ユーザー

  • SNS運用を定期的に行うマーケティング担当者
  • 投稿スケジュールを一元管理したいチーム

前提条件

  • X開発者ポータルでプロジェクト/アプリが作成済みであること
  • APIアクセスレベルがツイート投稿を許可していること
  • 自動化ツールがHTTPリクエストを送信可能であること

構成（ノード/データフロー）

  1. スケジュールトリガー — 設定した日時に自動起動
  2. コンテンツ取得 — データストアから投稿内容を取得
  3. 投稿組立 — テキスト＋メディアURLを組み合わせ
  4. X API送信 — POST tweets エンドポイントで投稿
  5. 結果記録 — 投稿ID・ステータスをログに記録

セットアップ

Step 1: X Developer Portal設定

  • X Developer Portalにログイン
  • プロジェクト → アプリ → 「User authentication settings」を設定
  • OAuth 2.0を有効化し、必要なスコープ（tweet.write, tweet.read）を付与
  • APIキー/シークレットを取得（値はツール側に安全に保管、記載禁止）

Step 2: 自動化ツールの設定

  • スケジュールトリガーノードを作成（Cron式 or カレンダー指定）
  • データストア参照ノードで投稿キューの先頭を取得
  • HTTP Requestノードで POST /2/tweets を設定
  • Authorizationヘッダーに Bearer Token を設定（環境変数参照）
  • Body に { "text": "投稿内容" } を設定

Step 3: テスト

  • テスト用アカウントで手動実行
  • 投稿が正しく表示されることを確認
  • レート制限に達しないことを確認（日次上限あり）

運用（監視・例外・復旧）

  • 監視: 投稿ログを日次チェック。失敗投稿があれば通知
  • 例外: API制限到達時は次のスケジュール枠にリトライ
  • 復旧: 自動投稿を一時停止し、手動投稿に切り替え

詰まりTOP5

  1. OAuth2.0のスコープ不足で403エラー
  2. レート制限到達（投稿数/時間制限）に気づかず投稿失敗
  3. 投稿内容の文字数超過（ポスト制限）
  4. Bearer TokenとOAuth 1.0aの使い分けミス
  5. メディア添付時のアップロードエンドポイント指定忘れ

反証3（失敗条件）

  1. APIポリシー変更: X社のAPI利用規約変更で自動投稿が制限される可能性。定期的に規約確認
  2. コンテンツ品質低下: 自動化に頼りすぎてエンゲージメント低下。定期的な効果測定が必要
  3. アカウント凍結リスク: 短時間大量投稿は規約違反。投稿間隔を十分に確保

トラブルシュート

症状原因対処
403 Forbiddenスコープ不足/トークン無効Developer Portal → アプリ設定 → スコープ/トークン再確認
429 Too Many Requestsレート制限到達投稿間隔を広げる/リトライロジック追加
投稿が重複するリトライ時の冪等性未考慮投稿IDで重複チェック
メディアが添付されないupload→attach の2段階が必要media/upload → media_id を tweets エンドポイントに渡す

Secrets注意

  • APIキー、APIシークレット、Bearer Token、Access Tokenは絶対に記事に記載しない
  • OAuth Callback URLも非公開
  • テスト用アカウントのユーザー名も記載禁止

ロールバック（停止/戻し）

  1. 即時停止: 自動化ツールのスケジュールトリガーを無効化
  2. 投稿削除: X API DELETE /2/tweets/:id で誤投稿を削除
  3. 完全戻し: 自動化ツールのワークフローを削除、Developer Portalでアプリのキーをリボーク

FAQ10

  1. Q: 無料で使えるか? A: X APIのFreeティアで月間投稿数に制限あり。要件に応じてプラン選択
  2. Q: 画像付き投稿は? A: media/uploadエンドポイントで先にアップロードし、media_idを指定
  3. Q: スレッド投稿は? A: 1件目の投稿IDをreply.in_reply_to_tweet_idに指定して連投
  4. Q: 予約投稿とリアルタイム投稿の切り替えは? A: トリガーノードの種類で切り替え
  5. Q: 投稿内容の承認フローは? A: データストアにステータス列を追加し、「承認済み」のみ投稿
  6. Q: 複数アカウントに対応できるか? A: アカウントごとにトークンを分け、ループ処理で投稿
  7. Q: ハッシュタグの自動付与は? A: テンプレート側でカテゴリ別ハッシュタグ辞書を用意
  8. Q: 投稿結果の分析は? A: GET /2/tweets/:id でインプレッション取得（要追加スコープ）
  9. Q: 夜間投稿を避けるには? A: スケジュールトリガーに時間帯制限を設定
  10. Q: APIが廃止された場合は? A: 本テンプレートを無効化し手動運用に戻す。ロールバック手順参照

変更履歴

日付変更内容関連ID
2026-02初版作成TMPL-X-001

last_verified

2026-02