製品ガイド

スプレッドシートからのキャンペーン

各行が1件のWhatsAppメッセージになっているExcelまたはCSVファイルをアップロードすると、Wbiztoolがキャンペーンとして送信します。各行にすでに個別のテキストがある場合に、顧客やグループのリストへメッセージを送る最も手軽な方法です。

サイドバーの ツール → Excel経由で送信 から開くか、/campaigns/にアクセスします。

始める前に#

WhatsApp設定で 接続済み と表示されているWhatsApp番号。
すべての行に足りるクレジット。ページには メッセージ残数 が表示されます。
以下の形式の .csv、.xls、.xlsx ファイル。

ファイル形式#

1行目には、以下の列見出しを表記どおり正確に入力する必要があります。ページの サンプル形式 をクリックすると例を確認できます。サンプルCSVをダウンロードすることもできます。アップロードする前に、サンプルの電話番号と2024年の予約日時を置き換えてください。過去の日時はすぐに送信されます。

ダッシュボードを英語以外の言語に設定している場合、サンプル形式 ウィンドウには列名が翻訳されて表示されます。ただし、ファイルにはここに記載した英語の見出しを使用する必要があります。

列	必須	入力する内容
`To`	はい	国番号付きの電話番号（例：`919876543210`）、またはWhatsAppグループの正確な名前（例：`Family Group`）。
`Message`	はい	メッセージのテキスト。`bold` などのWhatsAppの書式が使えます。
`Image/File Url (Optional)`	いいえ	画像またはファイルの公開リンク。その行の Message がキャプションとして送信されます。
`whatsapp_client_id`	いいえ	送信元の番号の WhatsAppクライアントID（WhatsApp設定で確認できます）。`0` を指定するか空欄にすると、最初に接続した番号から送信されます。
`Schedule Time (Optional)`	いいえ	その行を送信する日時。タイムゾーンのオフセット付きのISO形式で指定します（例：`2026-12-25T14:30:00+05:30`）。`2026-12-25T14:30:00` のようにオフセットのない日時はサーバーのタイムゾーンで読み取られるため、必ず `+05:30`、`Z`（UTC）、またはご自身のオフセットを付けてください。空欄にすると、できるだけ早く送信されます。

Excelファイルでは、To の代わりに Whatsapp Number または Contact phone Number も使用できます。To 見出しのないCSVファイルでは、見出しの内容にかかわらず 1列目 が番号、2列目 がメッセージとして読み取られるため、番号を1列目、メッセージを2列目にしてください。Image/File Url と Schedule Time は「(Optional)」なしでも使用できます。

行の例：

To	Message	Image/File Url (Optional)	whatsapp_client_id	Schedule Time (Optional)
919876543210	田中様、ご注文の商品を発送しました。		1234
Family Group	皆さん、良い休暇をお過ごしください！		1234	2026-12-25T16:00:00+05:30
919876543211	今週のお得情報	https://example.com/offer.jpg	1234

電話番号とグループ#

番号は国番号を含め、数字のみで入力してください。先頭の +、スペース、先頭の0は削除されます。
文字、ダッシュ、括弧を含む To の値は グループ名 として扱われます。そのため、98765-43210 はその名前のグループ宛てに送信され、失敗します。番号からダッシュと括弧を削除してください。
グループ名はWhatsAppのグループと完全に一致している必要があり、送信元の番号がそのグループのメンバーである必要があります。他のチャットと重複しないグループ名を使用してください。

画像とファイル#

.jpg、.jpeg、.png、.gif、.bmp、.tiff、.svg で終わるリンクは画像として送信されます。それ以外のリンクはファイルとして送信されます。
リンクは、ログインなしでファイルを直接開けるものである必要があります。リンクを取得するには、メディアライブラリにファイルをアップロードしてください。
受信者に表示されるファイル名は、リンクの末尾から取得されます。.pdf など正しい拡張子で終わるリンクを使用してください。そうでない場合は、ファイル名に .pdf が付加されます。

キャンペーンを開始する#

キャンペーンに名前を付ける
新しいキャンペーンを開始 の下にある キャンペーン名 に名前を入力します。同じ名前のキャンペーンがすでにある場合は、Diwali offer (1) のように番号が付加されます。
ファイルを選ぶ
Excel/CSVファイルをアップロード で、.csv、.xls、.xlsx ファイルを選びます。
開始する
キャンペーンを開始 をクリックします。ファイルが読み込まれると「N件のメッセージが新しいキャンペーンに保存されました」と表示され、キャンペーンが すべてのキャンペーン に表示されます。

番号のない行はスキップされます。ファイルに Message 列がない場合は、すべての行がスキップされます（上記の To 見出しのないCSVを除きます）。接続済みの番号がなく、ファイルの whatsapp_client_id でも番号が指定されていない場合も、すべての行がスキップされます。使用できる行が1つもない場合、キャンペーンは作成されず、すべてのキャンペーン にも表示されません。

送信ペース#

Schedule Time のない行は自動的に間隔を空けて送信されます。最初の行はアップロードの約5秒後、以降の各行は前の行から5〜30秒のランダムな間隔で送信予定になります。Schedule Time のある行は、その日時に送信予定になります。

メッセージは送信元のWhatsApp番号ごとに順番に送信され、その番号が接続されている間しか送信されません。番号が混み合っていたり切断されていたりすると、その番号のメッセージは遅れます。WhatsApp設定に表示される ベストプラクティス（1つの番号につき1日150〜200件など）を守ってください。

キャンペーンを追跡する#

すべてのキャンペーン の表には、キャンペーンが新しい順に1ページ20件ずつ表示されます。

列	意味
キャンペーン日	キャンペーン名。
総メッセージ数	ファイルから作成されたメッセージ。
保留中	キューにあり、まだ送信されていないメッセージ（予約された行を含む）。
配信済み	ご自身のWhatsApp番号から送信されたメッセージ。
キャンセル済み	失敗、キャンセル、または期限切れになったメッセージ。

テンプレートメッセージから作成したキャンペーンもここに表示され、Template Messages - の後に日時が続く名前が付きます。

キャンペーンの アクション を開くと、次の操作ができます。

レポートをダウンロード：各メッセージの Whatsapp Number（WhatsApp番号）、Customer Number（顧客の番号）、Msg（メッセージ）、Created Time（作成日時）、Sent Time（送信日時）、Status（ステータス：Created、Sent、Failed、Cancelled、Expired）を含むExcelファイル。日時はUTCです。
メッセージを表示：このキャンペーンで絞り込んだレポートを開きます。失敗した場合はその理由も表示されます。
保留中のメッセージをキャンセル：キャンペーンに保留中のメッセージが残っている場合に表示されます。
アーカイブ または復元。

完了したメッセージは約90日後に削除されるため、保存しておきたいレポートはダウンロードしてください。

保留中のメッセージをキャンセルする#

キャンペーンのアクションを開く
すべてのキャンペーン で、キャンペーンの アクション を開き、保留中のメッセージをキャンセル をクリックします。
確認する
はい、メッセージをキャンセルします！ をクリックします。「N pending messages cancelled successfully」（N件の保留中メッセージをキャンセルしました）と表示されます。

キャンセルしたメッセージはクレジットを消費しません。すでに送信されたメッセージには影響せず、キャンセルは元に戻せません。

アーカイブと復元#

アーカイブすると、完了したキャンペーンがメインの一覧に表示されなくなります。キャンペーンの アクション メニューで アーカイブ をクリックし、はい、アーカイブします！ で確認します。アーカイブしたキャンペーンを表示するには アーカイブされたキャンペーンを表示 をオンにし、復元をクリックすると元に戻せます。

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

メッセージまたは問題	対処方法
「キャンペーン名を入力してください。」	キャンペーン名を入力してください。
「キャンペーンを保存する前にファイルをアップロードしてください。」	先にファイルを選んでください。
「Invalid file format」（無効なファイル形式）	ファイルを `.csv`、`.xls`、`.xlsx` 形式で保存してください。
「Low credits」（クレジット不足）	クレジットが残っていません。請求・プランでアップグレードしてください。
「Not enough credits: this file would create…」	ファイルを分割するかアップグレードしてから、もう一度アップロードしてください。
「0件のメッセージが新しいキャンペーンに保存されました」	見出しが正確に `To` と `Message` になっていること（CSVでは番号を1列目、メッセージを2列目にしてください）、番号が接続されていることを確認してください。
「キャンペーンのアップロード中にエラーが発生しました」	ファイルを読み込めませんでした。`.xlsx` またはUTF-8の `.csv` で保存し直して、もう一度お試しください。
メッセージが保留中のまま	送信元の番号が接続済みである必要があります。ファイルの `whatsapp_client_id` が接続済みの番号のものか確認してください。削除または切断した番号のIDも受け付けられ、そのメッセージは保留中のままになります。最初の接続済み番号が代わりに使われるのは、不明なIDまたは `0` の場合のみです。
予約した行が誤った時刻に送信された	`+05:30` などのタイムゾーンのオフセットを含め、Excelで列の書式を文字列に設定してください。読み取れない日時の行はすぐに送信されます。
特定の番号へのメッセージが失敗する	メッセージを表示でエラーを確認してください。番号には国番号が必要で、ダッシュや括弧は使えません。