Skip to main content

​
X

Shanoneのx連携は、投稿・エンゲージメント、タイムライン・検索、リスト、ダイレクトメッセージ、Spacesをカバーする67個のツールをエージェントに提供します。

​
はじめに

1

OAuthで接続する

エージェントにX関連の作業を依頼(例: 「新機能のリリースについて投稿して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Xアカウントを許可する

Shanoneに操作させたいアカウントについて、XのOAuth同意画面を承認します。
3

リクエストを再実行する

接続が完了すると、x_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

Shanoneはx向けに67個のツールを、以下のカテゴリに整理して提供しています。
x_create_post, x_delete_post, x_get_post, x_search_posts, x_get_user_posts, x_get_posts_by_ids, x_get_quote_posts, x_get_reposted_by, x_get_liking_users, x_get_liked_posts, x_get_post_counts, x_hide_reply
x_create_list, x_get_list, x_update_list, x_delete_list, x_add_list_member, x_remove_list_member, x_get_list_members, x_get_list_followers, x_get_list_posts, x_follow_list, x_unfollow_list, x_pin_list, x_unpin_list, x_get_owned_lists, x_get_followed_lists
x_follow_user, x_unfollow_user, x_get_followers, x_get_following, x_block_user, x_unblock_user, x_mute_user, x_unmute_user, x_get_blocked_users, x_get_muted_users
x_send_dm, x_send_dm_to_conversation, x_create_group_dm, x_get_dm_events, x_get_dm_conversation_events, x_get_dm_event, x_delete_dm
x_search_spaces, x_get_space, x_get_spaces_by_ids, x_get_spaces_by_creators, x_get_space_posts, x_get_space_buyers
x_upload_media, x_upload_media_init, x_upload_media_append, x_upload_media_finalize, x_get_media_upload_status
x_like_post, x_unlike_post, x_repost, x_undo_repost, x_bookmark_post, x_remove_bookmark, x_get_bookmarks
x_get_home_timeline, x_get_mentions, x_get_me, x_get_user_by_username, x_get_users_by_ids

​
よくあるユースケース

コンテンツのスケジューリング & 投稿

投稿を作成し、必要に応じてアップロードしたメディアと共に公開する

ブランドメンション監視

最近の投稿を検索したりメンションを確認し、会話を見つけて対応する

コミュニティリストの整備

ターゲットとするエンゲージメント用にアカウント(顧客、パートナーなど)のリストを構築・維持する

DMでのサポート対応

サポートやコミュニティ用アカウントに届いたダイレクトメッセージを読んで返信する

​
トラブルシューティング

大きなメディアはチャンクアップロードフローが必要です — x_upload_media_initを呼び、続けて1回以上x_upload_media_appendを呼び、x_upload_media_finalizeを呼んでから、投稿にメディアIDを添付する前にx_get_media_upload_statusでポーリングしてください。
メディアの処理が完了(x_get_media_upload_statusで確認)してから、そのメディアIDをx_create_postで参照できます — 処理中のアップロードを添付すると失敗します。
Xの検索APIは標準ティアで保存期間・レート制限があります。非常に古い投稿や大量のクエリでは結果が部分的になることがあります。クエリを絞るか、x_get_post_countsで想定される件数を事前に確認してください。
XのOAuth 2.0アクセストークンには有効期限があります。呼び出しが認証エラーで失敗し始めた場合は、接続が永続すると考えず連携画面から再接続してトークンを更新してください。