claude-office-skills/whatsapp-automation

whatsapp-automation は何をしますか？

WhatsApp Business 自動化 - カスタマーサポート、通知、チャットボット、一斉メッセージ配信

概要

このスキルは、WhatsApp Business API を使用してビジネスメッセージングを自動化します。主な機能は以下の通りです：

• カスタマーサポート：自動応答とチケット管理
• 通知：予約確認、注文ステータス、配送情報
• チャットボット：よくある質問への自動応答、シンプルな会話フロー
• 一斉メッセージ配信：キャンペーンやお知らせの一斉送信（テンプレートメッセージを使用）

対応プラットフォーム

• WhatsApp Business API（公式 API）
• バックエンド環境（Node.js、Python など）

使い方

前提条件

• WhatsApp Business API のアカウントと認証情報
• Webhook エンドポイント（受信用）
• テンプレートメッセージの承認（一斉配信の場合）

設定

環境変数または設定ファイルに以下を設定します：

WHATSAPP_API_TOKEN=your_api_token
WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id
WHATSAPP_WEBHOOK_VERIFY_TOKEN=your_verify_token

主な操作

1. メッセージ送信：

   const response = await sendMessage({
     to: 'recipient_phone_number',
     text: 'Hello, this is a test message'
   });
   

2. テンプレートメッセージ送信：

   const response = await sendTemplateMessage({
     to: 'recipient_phone_number',
     templateName: 'order_confirmation',
     languageCode: 'ja',
     parameters: ['order_123', '2023-10-01']
   });
   

3. Webhook 受信処理： 受信メッセージやステータス更新を処理する Webhook エンドポイントを設定します。

エラーハンドリング

API 呼び出しが失敗した場合、適切なエラーレスポンスを返します。一般的なエラーコードは以下の通りです：

• 400：不正なリクエスト（パラメータ不足など）
• 401：認証エラー（トークンが無効）
• 429：レート制限超過

注意事項

• すべてのメッセージは WhatsApp Business ポリシーに準拠する必要があります。
• 一斉メッセージ配信には、事前に承認されたテンプレートが必要です。
• 24時間セッションウィンドウ内のメッセージは無料ですが、それを超えるとテンプレートメッセージのみ送信可能です。

関連リソース

• WhatsApp Business API ドキュメント
• テンプレートメッセージガイド