social-media-publisher

ソーシャルメディアパブリッシャー

このスキルを使用して、PostPlus が管理するソーシャルパブリッシングワークスペースを通じて、ソーシャル投稿の作成、更新、一覧表示、削除、スケジュール設定、または公開を行います。

所有権と認証の境界

PostPlus は、プラットフォームが所有するソーシャルパブリッシングワークスペースを保持します。エンドユーザーは別途パブリッシングサービスのアカウントを用意する必要はなく、サードパーティのパブリッシングサービスの認証情報をエージェントに提供すべきではありません。

チャネルのオンボーディングには PostPlus の招待リンクパスを使用します。

1. PostPlus Cloud が対象のソーシャルプラットフォーム用の招待リンクを作成します。
2. ユーザーがプラットフォームの OAuth 画面で自分のソーシャルアカウントを認可します。
3. 生成されたチャネルトークンが PostPlus のソーシャルパブリッシングワークスペースに格納されます。
4. PostPlus がそのチャネルにユーザーの PostPlus アカウント id をラベル付けします。

スクリプトは、非公開のサーバー認証情報ではなく、PostPlus がホストするリクエストエンベロープを受け取ります。

コマンド

1 回の呼び出しにつき 1 つの操作を実行します。操作はサブコマンドです。

postplus publish <operation> --request <input.json> --output <result.json>

<input.json> は、その操作のパブリッシング input オブジェクトです。CLI が operationId を発行し、PostPlus のソーシャルパブリッシングワークスペースに投稿します。

副作用を伴う操作(create、schedule、publish、delete)は、支出の前に見積もり確認チャレンジを返すことがあります。その場合は、postplus quote confirm --json --challenge-file <challenge.json> を実行し、同じコマンドを --quote-confirmation-token <token> を付けて再試行してください。

postplus publish analytics --request request.json --output result.json

CLI の構造化された結果と報告された次のアクションに従ってください。フリーテキストのメッセージから復旧を推測しないでください。 要求された場合は、ユーザーの明示的な承認を待ってください。アクションは、支出、公開、または上書きを承認するものではありません。 返されたチェックポイントまたはアクションを通じて同じ操作を再開してください。不確実な作業を再送信したり、尽くした復旧を繰り返したり、障害を回避するためにプロバイダーを切り替えたりしないでください。

必須入力

• 選択した操作に対応するパブリッシング input オブジェクト: ワークスペース/アカウントの識別情報、integration id、コンテンツ/メディア、および必要に応じて投稿またはグループの id。

デフォルトのワークフロー

1. チャネルが招待リンクフローを通じてオンボーディングされたことを確認します。
2. チャネルを一覧表示して、正確な integration id を確認します。
3. 操作のパブリッシング input を作成し、コマンドを実行します。
4. ユーザーがスケジュール設定または公開を明示的に承認しない限り、レビュー可能な作業は draft のままにしてください。実際の公開/スケジュール設定には、人間による承認と現在のチャネルの証跡が必要です。

ユーザー向けのブロッカー

次の場合は停止して説明してください。

• PostPlus の認証/セッションが利用できない場合、
• チャネルが招待リンクフローを通じてオンボーディングされていない場合、
• integration id が欠落しているか、オンボーディング済みのチャネルでない場合、
• 必要なコンテンツ、メディア、投稿 id、またはグループ id が欠落している場合、
• 承認または見積もり確認が必要な場合、
• 公開のようなアクションに対して、権利または現在のチャネルの証跡が欠落している場合、
• ホストされたサービスが安定した製品エラーを返す場合。

サーバー側の実装名を公開したり、サードパーティのパブリッシングサービスの認証情報を求めたりしないでください。見積もり確認や承認の境界を回避しないでください。

ハンドオフ

構造化されたプレビュー/結果 JSON、必要な場合は承認または見積もり確認のコマンド、または正確な製品エラーと次の境界を返してください。

公開コマンドの境界

• ユーザー入力から最小の一致する操作を選択し、それを直接実行します。

• 準備状況の診断: postplus doctor --skill social-media-publisher。

• 未知のリクエスト形状を構築または修復する場合にのみ、postplus publish schema --json を使用してください。

• 承認の境界は明示的なままにしてください。人間による承認と現在のチャネルの証跡なしに、不可逆的な公開を実行しないでください。