sent-analytics

Sent Analytics

分析と有料の外部番号検索には、numbers.lookup、dashboard.messages_sent、dashboard.deliverability、dashboard.contactsを使用します。numbers.lookupはメッセージを送信しませんが、状態を変更する非冪等な操作です。

コンテキストの確立

クライアント管理のOAuth 2.1/PKCEを使用します。トークン、APIキー、認証ヘッダー、クライアントID、シークレットを要求したり、開示したりしないでください。クライアントから確認できる場合は、アクティブな組織とSender Profileを特定します。

機密情報の出力は最小限に抑えます。電話番号をマスキングし、可能な場合は集計し、回答に不要な連絡先、KYC、アカウント、メッセージ本文のデータは省略します。

組織の権限付与では、ツールスキーマの省略可能なprofileIdで所有するSender Profileを選択できます。省略すると、認証済みアカウントに対して操作します。sender_profiles.listまたはsender_profiles.getで所有権を検証し、事前確認の読み取り、変更、事後確認の読み取りで同じセレクターを使用します。プロファイルの権限付与では、このセレクターは使用できません。別の組織、または権限付与の範囲外のプロファイルに対しては、再認証してください。スコープフィールドを捏造したり、認証情報を要求したりしないでください。

番号を検索する

numbers.lookupを使用して、指定された番号の利用可能な機能、形式、種類、またはルーティングに関する情報を取得します。検索結果が示すのは機能であり、オプトイン、同意、所有権、本人確認、またはメッセージ送信の許可を証明するものではありません。結果がアウトリーチの計画に利用される可能性がある場合は、必ずこの違いを明示してください。有料検索の上限は、認証済みアカウントのスコープごとにUTC日あたり1000回です。すべての操作プロファイルで共有され、00:00 UTCにリセットされます。割り当て上限のエラーを尊重し、プロファイルを切り替えたり、ループ内で再試行したりしないでください。一時的に割り当て上限を確認できない場合でも検索が許可されることがありますが、それによって無料になるわけではありません。

ダッシュボード指標を照会する

1. dashboard.messages_sentの期間、タイムゾーン、集計単位を決定します。対応するプリセットまたはカスタム期間で配信済み／既読のアウトバウンドSMSとWhatsAppをカウントし、15分、時間、日単位で集計します。キューに入ったすべての送信やRCSの量を示すものとして説明しないでください。
2. dashboard.deliverabilityは、アウトバウンドの全期間パーセンテージを返します。計算式は(SENT + DELIVERED + READ) / (FILTEREDとBLOCKEDを除くすべて)です。期間で絞り込んだ配信のみの成功率ではありません。日付フィルターを捏造したり、この単一の値から先週との比較を主張したりしないでください。
3. dashboard.contactsは、現在の連絡先総数を返します。1回のスナップショットから、連絡先の増加、アクティビティ、過去の推移を判断することはできません。
4. 比較する場合は、同じ組織、操作プロファイル、対応する期間、タイムゾーン、チャネル対象範囲、集計単位にそろえます。ツールが実際に対象とする範囲を明示します。送信量は期間とタイムゾーン、配信可能性は全期間、連絡先数はスナップショットです。

処理状態と配信状態は、証拠に基づいてラベル付けし、受付済みを配信済みとして扱わないでください。対応していない過去の比較には、エクスポートしたメッセージ単位の証拠、または文書化された別の情報源を使用します。

集計分析と診断の使い分け

ダッシュボードの合計、割合、傾向にはこのスキルを使用します。メッセージ単位の配信記録、ファネルの離脱、エラーコードのクラスタリング、根本原因の診断が必要な場合は、messaging-performance-analyzerを使用します。配信可能性ダッシュボードから変化を特定することはできますが、それだけで運用上の原因を証明することはできません。