投稿を公開
Publication → Post[] を作成書き込みUnified近日公開TikTok、Instagram、YouTube ほか 6 つのプラットフォームに 1 回のリクエストで投稿できます。結果は各プラットフォームから個別に返り、公開された投稿だけが課金されます。X への投稿は、Direct API の AIsa X actions で現在利用できます。
1 回のリクエストで全プラットフォームへ
一度書けば、各プラットフォームが個別に結果を返す
テキスト、メディア、投稿先アカウント、タイミングは共通です。1 つのプラットフォームにしかない設定は、tiktok.privacy や instagram.format のように専用のプレフィックスの下に置きます。アカウントごとに短いキャプションを付けることもできます。
- プラットフォーム
- 9
- 失敗または事前チェックで停止した投稿
- $0
- 公開された投稿 1 件あたり
- [$Z]
投稿先ごとに個別に結果が返る
例 · 架空のブランド Acme Home
pub_01JB8W3K一部公開| アカウント | 形式 | ステータス | 結果 | 課金 |
|---|---|---|---|---|
TikToktiktok:acme.home | 動画 | 公開済み | tiktok:[post id]09:00 PT に公開 | 課金 |
Instagraminstagram:acme.home | リール | 公開済み | instagram:[post id]09:00 PT に公開 | 課金 |
Xx:acme_home | テキスト + 動画 | 公開済み | x:[post id]短いキャプションを使用 | 課金 |
YouTubeyoutube:acmehome | ショート | 公開中 | —アップロードを処理中 | — |
LinkedInlinkedin:acme-home | 動画 | 予約済み | —次の空き枠、11:00 PT | — |
Pinterestpinterest:acmehome | 動画ピン | 失敗 | connection_expired自分で修正可能:再接続してから、この投稿先を再試行 | 課金なし |
Publication のステータスは、下書き、予約済み、公開中、公開済み、一部公開、失敗、取り下げのいずれかです。失敗した投稿先だけを同じ冪等キーで再試行でき、二重に投稿されることはありません。
接続から投稿まで
- 01 · Connection
一度だけ接続
アカウント所有者が AIsa にアクセスを許可します。スコープ、状態、有効期限をいつでも確認でき、期限が切れる前に警告が届きます。
- 02 · Preflight
投稿前にチェック
文字数、メディアのサイズ、形式、アカウントの種類を各プラットフォームの基準でチェックします。不合格でも費用はかかりません。
- 03 · Approval
先に人が確認
公開、削除、DM は人の承認を待つように設定できます。AI 運用スタッフでは初期設定で有効です。
- 04 · Publication
投稿、またはキューへ
今すぐ、指定時刻、次の空き枠のいずれかで投稿するか、下書きとして保存します。タイムゾーンは常に明示します。
- 05 · Event
通知を受け取る
投稿の公開や失敗、新しいコメントと DM、期限切れ間近の接続を webhook で通知します。
9 件の呼び出しを予定近日公開
AIsa が独自に作成したパスの下書きで、まだレビューを経ていません。各呼び出しは、許可した Connection を通じて記載のプラットフォームで動作します。まだどれもデプロイされていません。
- POST
/1 件の投稿を複数のアカウントへ送信:今すぐ、指定時刻、またはキューへ全 9 のソーシャルプラットフォーム下書きv1/ social/ publications - POST
/文字数、メディア、アカウントの種類を各プラットフォームのルールで事前チェック全 9 のソーシャルプラットフォーム下書きv1/ social/ publications/ precheck - GET
/1 件の Publication と、各プラットフォームでのステータス全 9 のソーシャルプラットフォーム下書きv1/ social/ publications/ {publicationId} - GET
/下書き、予約済み、送信済みの Publication全 9 のソーシャルプラットフォーム下書きv1/ social/ publications - PUT
/下書きまたは予約済みの Publication を編集全 9 のソーシャルプラットフォーム下書きv1/ social/ publications/ {publicationId} - POST
/失敗したプラットフォームを再試行全 9 のソーシャルプラットフォーム下書きv1/ social/ publications/ {publicationId}/ retry - DELETE
/下書きを削除、または予約送信を取り消す全 9 のソーシャルプラットフォーム下書きv1/ social/ publications/ {publicationId} - POST
/CSV ファイルから多数の Publication を作成全 9 のソーシャルプラットフォーム下書きv1/ social/ publications/ bulk-upload - GET
/投稿できるプラットフォームとその制限全 9 のソーシャルプラットフォーム下書きv1/ social/ platforms
各プラットフォームでできること
同じ表はエンドポイントとしても提供し、プラットフォームの変更に合わせてバージョン管理しています:GET /v1/social/platforms
| プラットフォーム | 公開 | コメントと DM | 自分の統計 | ステータス |
|---|---|---|---|---|
| X | テキスト、画像、動画、スレッド、投票 | コメント。DM は近日対応 | あり | 提供中 |
| TikTok | 動画 | コメント。DM は返信のみ | あり | 近日公開 |
| 投稿、リール、ストーリーズ、カルーセル | コメント、DM | あり | 近日公開 | |
| Facebook ページ | テキスト、画像、動画、リール | コメント、DM、ページのレビュー | あり | 近日公開 |
| YouTube | 動画、ショート | コメント | あり | 近日公開 |
| テキスト、画像、動画、ドキュメント | 企業ページのコメント | あり | 近日公開 | |
| 画像ピン、動画ピン | Pinterest では非対応 | あり | 近日公開 | |
| Threads | テキスト、画像、動画 | コメント | あり | 近日公開 |
| テキスト、画像、動画、リンク | コメント、DM | 一部のみ | 近日公開 |
エラーには修正できる側を明記
エラーコードは AIsa 独自のものです。上流のコードやメッセージがそのまま届くことはないため、プラットフォームの背後の経路が変わってもコードを変更する必要はありません。
- 自分で修正可能再試行なし · 課金なし
- connection_expired
- content_spec_mismatch
- account_type_unsupported
- プラットフォーム自動で再試行
- platform_rate_limited
- platform_unavailable
- AIsa再試行 · AIsa が負担
- aisa_internal
アカウントを守る安全対策
- 投稿頻度は、アカウントごとに各プラットフォームの上限未満に抑えます。
- 多数のアカウントに同じ投稿を送る場合は、先に審査します。
- 新しく接続したアカウントは少ない頻度から始め、徐々に増やします。
- コメントと DM は個人データとして扱い、顧客をまたいで共有することはありません。
料金
- 接続したアカウント(統計付き)
- [$] / 月
- 公開された投稿 1 件ごと
- [$Z]
- コメントまたは DM の返信 1 件ごと
- [$]
- X
- X API の呼び出しごと(別途掲載)
エージェントは x402 で投稿ごとに支払えます。アカウントやプランは不要です。