Skip to main content
ドキュメントガイドWhatsApp

WhatsApp ビジネス API

WhatsAppの番号をBeeCastlyに接続して、お客様とチャットし、AIに返信を任せ、一斉配信を送れます。QRコードのスキャン、またはMetaの公式WhatsApp Cloud APIで接続できます。

前提条件

BeeCastlyのアカウント（無料プランでも利用可）
Metaビジネスアカウント（business.facebook.com）
Cloud APIの方法の場合：Metaビジネスアカウント（business.facebook.com）と、Metaに登録する電話番号

接続方法は2通り

QRコードをスキャン

WhatsApp Webと同じように、WhatsApp Businessアプリの番号を含め、すでに使っている番号をリンクします。無料で、Metaの承認は不要です。返信や自動返信に最適です。大量の一斉配信には使わないでください。WhatsAppに番号を停止される可能性があります。

WhatsApp Cloud API（Meta）

Metaの公式の方法です。Metaビジネスアカウントと、承認済みのメッセージテンプレートが必要です。一斉配信やキャンペーンにはこの方法を使います。

セットアップガイド

1BeeCastlyでWhatsAppを接続する

連携 → チャネル → WhatsAppに移動します。
QRコード：WhatsApp QRを選びます。スマートフォンでWhatsApp → リンク済みのデバイス → デバイスをリンクを開き、コードをスキャンします。スマートフォンは通常どおり使い続けられます。
Cloud API：WhatsApp Cloud API（Meta）を選び、Facebookで接続をクリックします。Metaビジネスアカウントと電話番号を選びます。手動で設定したい場合は、ステップバイステップウィザードで、MetaアプリID、WhatsApp BusinessアカウントID、電話番号ID、アクセストークンを入力します。

2メッセージテンプレートを作成する

Cloud APIでは、お客様の最後のメッセージから24時間以内にのみ自由なテキストを送信できます。それ以外の時間帯は、Metaが承認したテンプレートが必要です。
キャンペーン → テンプレートに移動し、テンプレートを作成します。
カテゴリを選びます：マーケティング、ユーティリティ、または認証。
名前やその他の詳細用に、{{1}}や{{2}}のような変数を追加します。
送信します。Metaが審査し、ステータスがBeeCastlyで更新されます。

3一斉配信キャンペーンを送る

キャンペーン → 一斉配信 → 作成に移動します。
チャネルとしてWhatsAppを選択します。
承認済みのテンプレートと配信対象（連絡先、タグ、セグメント）を選びます。
テンプレートの変数を連絡先の項目（氏名、電話番号、カスタム項目）に割り当てます。
メッセージをプレビューし、今すぐ送信または予約送信をクリックします。

4会話を管理する

WhatsAppの受信メッセージは、メッセージ → WhatsApp（およびすべてのメッセージ）に届きます。
受信箱から返信し、よく送る回答にはクイック返信を使い、チャットをチームメンバーに割り当てます。
AI返信をオンにすると、チャットボットがナレッジベースからよくある質問に答え、必要なときは担当者に引き継ぎます。

5その他のWhatsAppツール

メッセージ → Status Studio：WhatsAppのステータスを投稿します。
メッセージ → wa.meリンク：ウェブサイトやポスター用のクリックしてチャットするリンクやQRコードを作成します。
連携 → チャネル → WhatsApp：ビジネスプロフィールと商品カタログを編集します（Cloud API）。

ベストプラクティス

高い品質評価を維持する

スパムを避けて、メッセージの品質評価を「高」に保ちましょう。ブロックや報告が増えると、Metaによって送信上限が制限される場合があります。

オプトインの同意を得る

マーケティングメッセージを送る前に、フォーム、ウェブサイトのチャット、対面などで、明確な許可を得てください。

AI自動返信を賢く使う

AI返信は、ナレッジベースに価格、営業時間、ポリシーが登録されているときに最も効果を発揮します。お客様が担当者に連絡できる手段を、必ず残しておいてください。

重要：24時間ウィンドウ（Cloud API）

WhatsApp Cloud APIでは、お客様の最後のメッセージから24時間以内にのみ自由なテキストを送信できます。それ以外の時間帯は、承認済みのテンプレートを使う必要があります。

API Examples

Send a WhatsApp message from your own software with an API key. See the Messages API for details.

bash
curl -X POST https://beecastly.com/api/v1/messages/send \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"WHATSAPP","to":"+919876543210","content":"Hello from BeeCastly!"}'
javascript·send-message.js
const response = await fetch('https://beecastly.com/api/v1/messages/send', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channel: 'WHATSAPP',
    to: '+919876543210',
    content: 'Hello from BeeCastly!',
  }),
});

const data = await response.json(); // { success: true, data: { messageId, status: "queued" } }

Troubleshooting

Template not approved

If your template is rejected by Meta, check that it follows WhatsApp's guidelines: no promotional content in utility templates, proper formatting, and clear call-to-action buttons.

Messages not delivering

QR method: check that your phone is online and still shows BeeCastly under Linked devices. Cloud API: check that the customer has opted in and that your number's status is healthy in Meta Business Manager.

Rate limits

Meta limits how many people a new Cloud API number can message per day, and the limit grows as you send good-quality messages. Start with small broadcasts and schedule larger ones in Campaigns → Broadcasts.

Frequently Asked Questions

Can I use my WhatsApp Business App number?
Yes. With the QR method you link the number you already use, the same way WhatsApp Web works, and you keep using the app on your phone. For the Cloud API, you connect a number through Meta's sign-up steps.
Do I need Meta approval?
Not for the QR method. The Cloud API needs a Meta Business account, and Meta must approve your message templates before you can use them.
Which method should I use for broadcasts?
The Cloud API. Sending bulk messages over the QR method can get your number banned by WhatsApp, so use QR for replies and auto-replies to people who message you.
WhatsApp Guide - BeeCastly Documentation | BeeCastly