Integration API経由でWhatsAppを送信

認証

リクエストボディにLocal API Keyを使用します（フィールド`api_key`）、HTTPヘッダーではありません。各ビジネスには、ビジネス作成時に自動生成される1つのLocal API Key（UUID）があります。

Local API Keyの取得方法

1. /appでcshubのパネルにログインします。
2. メニュー設定 → API Key（またはプロフィール → 統合）を開きます。
3. Local API Keyをコピーします。いつでも再生成可能です（古いものはすぐに無効になります）。

エンドポイント

すべての種類のWhatsApp Unofficialメッセージ（whatsmeow）用の1つのエンドポイント。自由なメッセージにはmethod = textを、パネルで作成したテンプレートからのメッセージにはmethod = templateを選択します。

ボディフィールド

リクエストボディはJSON形式です。以下のフィールドはwhatscrmhub Laravelと同じです — 古いバージョンから移行する場合、リクエストの形状は同一です。

リクエストの例

1. シンプルなテキストメッセージを送信

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "6281234567890",
    "method": "text",
    "text": "Halo, makasih udah order ya!"
  }'

2. 変数置換を伴うテンプレートメッセージを送信

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "6281234567890",
    "method": "template",
    "template": "<TEMPLATE_ID>",
    "variables": {
      "$name": "Pak Budi",
      "$order_id": "INV-20260602-001"
    }
  }'

3. グループに送信（グループJIDを使用）

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "120363012345678901@g.us",
    "method": "text",
    "text": "Pengumuman: order minggu ini ditutup pukul 17:00.",
    "is_group": true
  }'

成功レスポンス（200 OK）

{
  "status": true,
  "message": "berhasil mengirim pesan"
}

エラーコードと解決策

注意事項と制限

• デバイスごとにdaily_send制限があります。1つのデバイスから10メッセージ/秒を超えるブラスティングは避けて、WhatsAppの禁止を回避してください。
• ビジネスの設定が`api_device_use = required`に設定されている場合、フィールド`device_key`は必須です。オプションに設定されている場合、サーバーはアクティブなデバイスを戦略に応じて自動選択します（`sequence` / `spin` / `random`は`whatsapp_sender_notif`の設定で）。
• 変数の置換はリテラル`str_replace`を使用します — プレースホルダーは任意の文字列（例：`$name`、`{name}`、`[NAME]`）で構いません。テンプレートメッセージにあるものと正確に一致することが重要です。
• 常に「+」なし、スペース/ハイフンなしのフォーマットで。例：6281234567890（インドネシア）、60123456789（マレーシア）。グループの場合：サフィックス`@g.us`を持つ完全なJIDを使用します。
• MVPのイテレーション：multipart/form-data経由でのバイナリファイルのアップロードはサポートされていません。メディアを送信するには、パネルで設定された画像を持つテンプレートを使用してmethod=templateを使用します。

Integration APIとInternal Panel API

cshubには、意図的に分離された2つのメッセージ送信経路があります。Integration APIはサードパーティの開発者/自動化用、Internal APIはcshubのウェブパネルとモバイルアプリ用です。異なるオーディエンス、異なる認証、異なるレスポンス形状です。