managing-subscriptions

サブスクリプションの管理

サブスクリプションでは、固定スケジュールでプロダクトデータを配信します。 インサイトのスナップショット、ダッシュボードのスナップショット、AI プロンプトレポートに対応しています。

関連するリファレンスを読む

• リソースタイプを選択または変更する前に、subscription-types.mdを読んでください。
• 配信先を作成または変更する前に、destinations.mdを読んでください。
• スケジュール、上限、課金、配信確認、失敗については、operations.mdを読んでください。
• 詳細なプロンプトレポート作成ワークフローについては、creating-ai-subscriptionを使用してください。

適切なプロダクトを選ぶ

• 「毎週月曜日にこのダッシュボードを送信する」のような定期配信には、サブスクリプションを使用してください。
• 「コンバージョンが10%を下回ったら通知する」のような条件には、プロダクトアラートを使用してください。
• 後でリソースを確認するための非公開プロンプトをユーザーが求めている場合は、リマインダーを使用してください。
• エージェントが報告すべき重要事項を判断する必要がある場合は、Signals scoutを使用してください。

サブスクリプションでは、しきい値、回復、連続した超過、通知停止時間を評価しません。 スナップショットのサブスクリプションは、保存された結果に変化がない場合でも、スケジュールされた各回の配信を試みます。

ツール

ツール	目的
posthog:subscriptions-list	サブスクリプションを検索する
posthog:subscriptions-retrieve	1件のサブスクリプションを読み取る
posthog:subscriptions-create	サブスクリプションを作成する
posthog:subscriptions-partial-update	サブスクリプションを変更、一時停止、または再開する
posthog:subscriptions-test-delivery-create	テスト配信を送信する
posthog:subscriptions-deliveries-list	配信試行を一覧表示する
posthog:subscriptions-deliveries-retrieve	1件の配信を読み取る
posthog:subscriptions-delete	今後の配信をすべて停止する
posthog:integrations-list	Slack インテグレーションを検索する
posthog:integrations-channels-retrieve	Slack チャンネルを検索する
posthog:dashboard-get	ダッシュボードのタイルを読み取る
posthog:insight-get	インサイト ID を解決する

サブスクリプションを作成する

1. posthog:subscriptions-listを呼び出し、重複がないか確認します。
2. subscription-types.mdからリソースタイプを1つ選択します。
3. destinations.mdを参照して配信先を解決します。
4. operations.mdを参照してスケジュールを解決します。
5. すぐに配信するかどうかをユーザーに確認します。
6. ユーザーの選択に応じてsend_test_nowを設定します。
7. posthog:subscriptions-createを呼び出します。
8. 保存されたサブスクリプションを読み取り、依頼された各フィールドを確認します。
9. ユーザーが即時配信を承認した場合は、その配信記録を確認します。

作成がタイムアウトした場合や、結果が不確かな場合は、再試行する前に一致するサブスクリプションを一覧表示してください。 作成は冪等ではありません。 無条件に再試行すると、サブスクリプションや即時配信が重複する可能性があります。

受信者、チャンネル、時刻、タイムゾーンが不明な場合は、推測しないでください。 作成前にこれらの値を確認してください。

既存のサブスクリプションを検索する

曖昧さを減らせる場合は、次の一覧フィルターを使用します。

• resource_type：insight、dashboard、またはai_prompt。
• target_type：email、slack、またはteams。
• insightまたはinsights：1つのインサイト ID、またはカンマ区切りの ID リスト。
• dashboard：1つのダッシュボード ID。
• dashboard_tiles：1つのダッシュボードにあるライブタイル用のインサイトサブスクリプション。
• created_by：1つの作成者 UUID。

重複を確認する

ユーザーからタイトル、インサイト名、ダッシュボード名、またはプロンプトのテキストが提供された場合は、search を使用します。 プロンプトのサブスクリプションは、タイトルとプロンプトのテキストに一致します。 リソース、配信先の種類、ターゲット、スケジュール、有効状態を比較します。

Teams の結果に含まれるのは Webhook のホストのみです。 1 つのホストで複数のチャネルに対応できます。 重複を特定するためにホストを使用しないでください。

Teams の候補に一致するものがある場合は、タイトル、スケジュール、作成者、作成日を表示します。 これらの項目でサブスクリプションを特定できる場合は、ユーザーに選択してもらいます。 ターゲットのチャネルを特定できる項目がない場合は、新しいサブスクリプションを作成します。

保存結果を確認する

作成後、次のフィールドを確認します。

• resource_type が insight、dashboard、または ai_prompt と一致している。
• target_type と安全なターゲットラベルがリクエストと一致している。
• enabled が true である。
• next_delivery_date がスケジュールとタイムゾーンに一致している。
• AI と配信のオプションがユーザーの選択と一致している。

サブスクリプションを変更する

更新のたびに、先に posthog:subscriptions-retrieve を呼び出します。 配信を送信する可能性のある更新の前に、現在の配信 ID を一覧表示します。 その後、変更するフィールドを指定して posthog:subscriptions-partial-update を呼び出します。

即時配信を送信する可能性のある更新については、ユーザーに確認します。 MCP の更新ツールでは、これらの変更に対する即時配信を抑止できません。 ユーザーが配信を承認しない場合は、更新しないでください。

• 配信を一時停止するには、enabled: false を設定します。
• 配信を再開するには、enabled: true を設定します。
• 受信者を変更する場合は、新しいターゲット全体を指定します。
• 配信先の種類を変更する場合は、target_type と target_value を一緒に指定します。
• 保存済みの Teams Webhook URL を維持する場合は、target_value を省略します。
• Teams Webhook URL を置き換える場合は、新しい URL 全体を指定します。

リソースの種類は変更できません。 ユーザーが別のリソースの種類を希望する場合は、新しいサブスクリプションを作成します。

スケジュールを更新した後は、新しい next_delivery_date を確認します。 スケジュールを使い切った場合、ユーザーが終了条件を延長または削除するまで再開できません。

配信を送信する更新の後は、新しい target_change 配信 ID がないか確認します。 その配信が最終状態に達するまで読み取ります。 次に、サブスクリプションを取得し、最終的な enabled 値を確認します。

配信をテストして確認する

1. ユーザーがすでにテストをリクエストしている場合を除き、承認を求めます。
2. 現在の配信 ID を一覧表示します。
3. posthog:subscriptions-test-delivery-create を呼び出します。
4. 新しい手動配信 ID がないか確認します。
5. 一覧の結果だけでは詳細がわからない場合は、新しい配信を読み取ります。

ポーリングの間隔を空け、2 分後に停止します。 配信が最終状態に達しない場合は、最後の状態を報告し、後でもう一度確認するよう提案します。

テストでは実際のメッセージが送信されます。 配信がキューに登録されると、ツールは 202 を返します。 別のテストが実行中の場合、またはサブスクリプションが無効の場合は、409 を返します。

配信状態は starting、completed、failed、skipped です。 失敗を調査する場合は、配信一覧を status でフィルタリングします。 ワークフローがキューに登録されても、配信が成功した証拠にはなりません。 配信が完了していても、一部の受信者への送信に失敗している場合があります。 MCP ツールでは受信者ごとの結果は表示されません。 各受信者への送信が成功したと断言しないでください。

サブスクリプションを停止する

サブスクリプション ID と安全な配信先ラベルを確認します。 ユーザーがすでに削除または登録解除をリクエストしている場合を除き、承認を求めます。 その後、posthog:subscriptions-delete を呼び出します。

MCP での削除は、取り消せないソフト削除です。 今後の配信を停止し、プランの枠を解放します。 ユーザーが再び必要とする場合は、新しいサブスクリプションを作成します。

結果を報告する

• リソースの種類、配信先の種類、スケジュール、次回の配信日を伝えます。
• サブスクリプションが有効かどうかを伝えます。
• AI 機能が AI クレジットを消費する可能性があるかどうかを伝えます。
• 確認に必要な場合を除き、メールアドレスを繰り返し記載しないでください。
• Teams Webhook URL は決して繰り返し記載しないでください。

関連スキル

• creating-ai-subscription：自由記述の AI プロンプトからレポートを作成します。
• building-a-dashboard：サブスクライブする前にダッシュボードを作成します。
• adding-product-alerting：データが条件を満たしたときにユーザーに通知します。
• managing-reminders：リソースを確認するための非公開プロンプトをスケジュールします。
• understanding-billing-usage：PostHog の AI クレジット使用量を調査します。