WordPress連携

Business Messaging for WbizTool は公式のWordPressプラグインです。WooCommerceの注文が変更された、WP Ameliaの予約が変更またはキャンセルされた、Contact Form 7のフォームが送信された、といったサイト上の出来事に応じて、接続済みの番号からWhatsAppメッセージを送信します。

始める前に#

• WhatsApp設定でWhatsApp番号を接続済みのWbiztoolアカウント。
• 設定 → APIキーで確認できる クライアントID と APIキー。
• WhatsApp設定に表示されている、送信元の番号の WhatsAppクライアントID。

プラグインをインストールする#

1. WordPressからインストールする

   WordPressの管理画面で プラグイン → 新規追加（Plugins → Add New）を開き、Business Messaging for WbizTool を検索して、今すぐインストール（Install Now）、有効化（Activate）の順にクリックします。WordPressプラグインディレクトリからダウンロードし、プラグイン → 新規追加 → プラグインのアップロード（Plugins → Add New → Upload Plugin）でzipファイルをアップロードすることもできます。管理画面からアップロードできない場合は、zipファイルを展開し、business-messaging-for-wbiztool フォルダーをFTPで /wp-content/plugins/ にコピーしてから、プラグイン（Plugins）で有効化します。

2. プラグインの設定を開く

   管理画面のサイドバーに新しい WbizTool メニューが表示され、Settings（設定）、Templates（テンプレート）、Test Messages（テストメッセージ）、Logs（ログ）の4つのページがあります。

プラグインを設定する#

1. API認証情報を入力する

   WbizTool → Settings の API Configuration（API設定）で、Client ID、API Key、WhatsApp Client ID を入力し、Test Connection（接続テスト）をクリックします。

   認証情報が正しい場合、Test Connectionはプレースホルダーの番号 10000000000 宛ての実際のテストメッセージをキューに追加するため、Wbiztoolのメッセージ履歴に表示されます。このメッセージは配信できず失敗と表示されますが、無視してかまいません。Unable to connect to WbizTool API. Please check your internet connection.（WbizTool APIに接続できません。インターネット接続を確認してください）と表示された場合は、クライアントID、APIキー、WhatsAppクライアントIDのいずれかが間違っているか、プランに残りのメッセージがない可能性が高く、インターネット接続の問題であることはまれです。

2. 一般オプションを設定する

   General Settings（一般設定）で次の項目を設定します。

   • Default Country Code（デフォルトの国番号）：WooCommerceの注文の請求先の国を国番号に対応付けられない場合に使用されます。デフォルトは 1 なので、主な国の番号（例：91）に変更してください。
   • Test Mode（テストモード）：オンにすると、メッセージはログに記録されますが送信されません。
   • Admin Notifications（管理者通知）：バージョン1.0.3では、設定ページに使用する管理者の電話番号を入力する欄がないため、このチェックボックスには目に見える効果がありません。フォーム送信時の管理者アラートには、下記のContact Form 7の設定を使用してください。

3. 連携とイベントをオンにする

   Integration Settings（連携設定）で、使用する各プラグインを有効にし、メッセージを送信するイベントにチェックを入れます。各連携のオプションは、そのプラグインがサイトで有効になっている場合にのみ表示されます。Save Settings（設定を保存）をクリックします。

4. メッセージテンプレートを編集する

   WbizTool → Templates で、WooCommerce、Amelia、Contact Form 7のいずれかのタブを選び、イベントを選んでテキストを編集します。ページには使用できる変数の一覧とライブプレビューが表示されます。Reset（リセット）でデフォルトのテキストに戻ります。

5. テスト送信する

   WbizTool → Test Messages で、ご自身の番号にメッセージを送信してすべてが機能することを確認し、WbizTool → Logs を確認します。

WooCommerce#

メッセージは注文の 請求先の電話番号 に送信されます。国番号は請求先の国から決まり、その国を認識できない場合は Default Country Code が使用されます。

テンプレートの変数：

テンプレートの例：

Hi {customer_first_name},

Thank you for your order #{order_number}.
Total: {order_total}

Track your order: {order_url}

{store_name}

WP Amelia#

メッセージは予約の顧客の電話番号に送信されます。設定ページには6つのイベントが表示されます。

• Booking Added (Frontend bookings)
• Booking Rescheduled
• Booking Cancelled
• Appointment Added (Backend)
• Event Booking Saved
• Event Booking Updated

Ameliaのテンプレートで使用できる変数：

Contact Form 7#

フォームが送信されると、プラグインはあなた（管理者）、フォームに入力した人、またはその両方にメッセージを送信できます。

プラグインは、フィールド名によってフォーム内の名前、メールアドレス、電話番号、メッセージを見つけます。your-name、your-email、your-phone（または phone、mobile、whatsapp）、your-subject、your-message などの一般的な名前を使用してください。顧客への自動返信は、電話番号のフィールドが見つかった場合にのみ送信されます。電話番号は国番号付きで入力してもらってください。プラグインが認識できる国番号は一部のみで、それ以外の場合は Default Country Code が使用されます。

テンプレートの変数：

すべてのフォームフィールドは、ハイフンをアンダースコアに置き換えた独自の名前でも使用できます。たとえば、your-city という名前のフィールドは {your_city} になります。

管理者向け通知の例：

New enquiry from {contact_name} ({contact_phone}) on {form_title}:
{message}

訪問者のメッセージに含まれる改行は削除されるため、{message} は1行で届きます。

ログ#

WbizTool → Logs には、プラグインが送信を試みたメッセージが、日時、イベントの種類、連携、電話番号、メッセージ、ステータスとともに一覧表示されます。イベントが実行されたかどうかや、メッセージが送信されたかどうかの確認に使用します。メッセージが失敗した理由は表示されません。

トラブルシューティング#

プラグインのPHPエラーを確認するには、wp-config.php でWordPressのデバッグログを有効にします。エラーは wp-content/debug.log に書き込まれます。確認が終わったら、再度無効にしてください。

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);