WhatsAppログ
WhatsAppログセクションでは、WhatsApp Cloud API Chat & Marketingモジュールで処理されたすべての自動化されたインタラクションの包括的な記録を提供します。キャンペーン配信、ボットトリガーのレスポンス、テンプレートベースのメッセージが含まれます。このセクションを使用して、アクティビティの監視、配信問題のトラブルシューティング、WhatsAppコミュニケーションの完全な監査証跡を維持します。
WhatsAppログへのアクセス
Perfex CRMサイドバーからWhatsAppモジュール > WhatsAppログに移動します。ログは、すべての自動化されたメッセージアクティビティを表示するソート可能で検索可能なテーブルに表示されます。
ログテーブルのカラム
各ログエントリには以下の情報が含まれます：
| カラム | 説明 |
|---|---|
| # | 各ログエントリのユニークな自動増分ID |
| カテゴリ | 自動化されたインタラクションのタイプ — 例：マーケティングキャンペーン、テンプレートボット |
| 名前 | ログエントリを生成したキャンペーン、ボット、自動化の名前 |
| テンプレート名 | インタラクションに使用されたWhatsAppメッセージテンプレート |
| レスポンスコード | WhatsApp Cloud APIから返されたHTTPレスポンスコード（例：成功は200、不正リクエストは400） |
| タイプ | 受信者タイプ — 例：リード、顧客、コンタクト |
| 記録日時 | インタラクションが記録された日時 |
| アクション | 各エントリで利用可能なアクション：詳細の表示またはログレコードの削除 |
レスポンスコードの理解
レスポンスコードカラムにより、メッセージが正常に配信されたかエラーが発生したかをすばやく特定できます。
| レスポンスコード | 意味 | 必要なアクション |
|---|---|---|
| 200 | 成功 — WhatsApp APIがメッセージを受理 | アクション不要 |
| 400 | 不正リクエスト — 無効なパラメータまたはテンプレートの問題 | テンプレートとパラメータを確認 |
| 401 | 未認証 — 無効または期 限切れのアクセストークン | Metaビジネス設定でアクセストークンを再生成 |
| 403 | 禁止 — 不十分な権限 | システムユーザーの権限を確認 |
| 404 | 見つかりません — 無効な電話番号IDまたはエンドポイント | モジュール設定の電話番号IDを確認 |
| 429 | レート制限 — リクエストが多すぎる | 送信頻度を減らす。クールダウン後にリトライ |
| 500 | 内部サーバーエラー — WhatsApp APIの問題 | 後でリトライ。持続する場合はMetaステータスページを確認 |
成功レスポンスコード（200）は、WhatsApp Cloud APIがメッセージの配信を受理したことを確認します。受信者のデバイスへの最終的な配信を保証するものではありません — 配信確認はチャットインターフェースで表示されるwebhookステータス更新を通じて行われます。
ログのフィルタリング
組み込みフィルターを使用してログエントリを絞り込み、特定のレコードをすばやく見つけます：
- カテゴリ — インタラクションタイプでフィルタリング（マーケティングキャンペーン、テンプレートボットなど）
- レスポンスコード — 成功（
200）または特定のエラーコードでフィルタリング - タイプ — 受信者タイプでフィルタリング（リード、顧客、コンタクト）
- 日付範囲 — 特定の期間のログを表示するための開始日と終了日を選択
- 検索 — キャンペーン名、テンプレート名、その他のフィールドでのフリーテキスト検索
ログ詳細の表示
任意のログエントリの表示アクションをクリックして、インタラクションの完全な詳細を確認します：
- WhatsApp APIに送信された完全なリクエストペイロード
- 完全なAPIレスポンスボディ
- 受信者の電話番号とコンタクト参照
- 使用されたテンプレートパラメータと変数値
- タイムゾーン情報付きのタイムスタンプ
この詳細ビューは、失敗した配信のトラブルシューティングや特定のメッセ ージ内容の監査に非常に有用です。
ログレコードの削除
個別のログエントリを削除するには：
- 対象ログ行の削除アクションをクリックします。
- プロンプトが表示されたら削除を確認します。
ログを一括削除するには、チェックボックスで複数のエントリを選択し、選択したものを削除をクリックします。
削除されたログレコードは復元できません。コンプライアンスや監査のためにレコードを保持する必要がある場合は、削除前にデータのエクスポートを検討してください。
ベストプラクティス
- ログを定期的に確認 — 失敗した配信（非200レスポンスコード）を確認し、キャンペーンの効果を維持するために問題に迅速に対処
- レート制限を監視 — 頻繁な
429レスポンスが表示される場合、キャンペーンの送信レートを減らすか、より長い時間ウィンドウで配信を分散 - トークンを最新に保つ —
401エラーはアクセストークンが期限切れまたは取り消されたことを示します。機能を回復するために即座に更新 - クリーンアップ前にアーカイブ — 古いログを削除する前に、コンプライアンス、レポート、紛争解決に必要なレコードをエクスポートまたは文書化
- 監査にフィルターを使用 — 特定のキャンペーンやボットを調査する際は、カテゴリと名前のフィルターを使用して関連するログエントリをすばやく分離
WhatsAppログは自動化されたインタラクション（キャンペーン、ボット、テンプレート送信）のみをキャプチャします。スタッフとクライアント間の手動チャットメッセージはチャット履歴に保存され、このログセクションには複製されません。