> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 実験的な対話メッセージ

> 返信ボタン、アクション呼び出し、選択リスト、ロケーション要求、画像カルーセルを送信します。

`POST /send/interactive` は、選択したデバイスを通じてWhatsAppネイティブフローメッセージを送信します。 Basic Auth、`X-Device-Id`、および JSON bodyを使用してください。このエンドポイントは即時のREST送信をサポートしています。スケジュールされた送信とMCPはそれを公開しません。

> [!WARNING]
>
> この実験的なエンドポイントは非公式のWhatsAppプロトコルを使用しています。受信者のレンダリングはクライアントによって異なり、予告なしに変更することができます。 使用前にターゲットクライアントをテストします。API応答が正常に送信承認を確認します。配信やレンダリングではありません。

curl サンプルを実行する前にサーバーの URL と認証情報を設定します。リモートサーバーの HTTPS URL を使用し、設定された場合は `APP_BASE_PATH` を含めます。

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## 送信ボタン

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H 'Content-Type: application/json' -H "X-Device-Id: $DEVICE_ID" \
  "$GOWA_URL/send/interactive" --data '{
    "phone": "628123456789",
    "body": "Confirm your order?",
    "footer": "Order 123",
    "buttons": [
      {"name": "quick_reply", "params": {"display_text": "Confirm", "id": "confirm"}},
      {"name": "quick_reply", "params": {"display_text": "Cancel", "id": "cancel"}}
    ]
  }'
```

`phone` は電話番号またはフルユーザーまたはグループJIDを受け付けます。 グループ送信にはメンバーシップと投稿権限が必要です。ニュースレターとブロードキャスト受信者はサポートされていません。

トップレベルの `buttons` または `cards` を指定します。両方を提供する、またはどちらかを指定すると、検証に失敗します。

| ボタン名 | 必須パラメータ |
| - | - |
| `quick_reply` | `display_text` と `id` 文字列は空ではありません。 |
| `cta_url` | 空の `display_text` と絶対 HTTP または HTTPS の `url` はありません。 |
| `cta_copy` | `display_text` と `copy_code` 文字列は空ではありません。 |
| `cta_call` | `display_text` と `phone_number` 文字列は空ではありません。 |
| `single_select` | 空の `title` と `sections` はありません。各セクションには空の `rows` が必要です。各行には空の文字列 `id` と `title` が必要です。 |
| `send_location` | `{}`のようなJSONオブジェクト。カードのないメッセージの中で唯一のボタンでなければなりません。 |

選択リストには、次のパラメータを使用します。

```json theme={null}
{
  "name": "single_select",
  "params": {
    "title": "Choose a size",
    "sections": [{
      "title": "Sizes",
      "rows": [
        {"id": "small", "title": "Small"},
        {"id": "large", "title": "Large"}
      ]
    }]
  }
}
```

## 位置情報をリクエスト

```json theme={null}
{
  "phone": "628123456789",
  "body": "Share your delivery location",
  "buttons": [{"name": "send_location", "params": {}}]
}
```

この JSON を `/send/interactive` に送信します。受信者はロケーションを共有することを選択する必要があります。エンドポイントはアクションなしでロケーションを取得しません。

## 画像カルーセルを送信

```json theme={null}
{
  "phone": "628123456789",
  "body": "Choose a product",
  "cards": [
    {
      "title": "Product A",
      "body": "Available in blue",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose A", "id": "choose_a"}}]
    },
    {
      "title": "Product B",
      "body": "Available in green",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose B", "id": "choose_b"}}]
    }
  ]
}
```

画像プレースホルダを生の標準base64でデータURLプレフィックスなしに置き換えます。画像は個々のカードでオプションです。 GOWAは1280ピクセルに合うように提供された画像をリサイズし、JPEGに変換し、サムネイルを作成し、WhatsAppにアップロードします。

## リクエスト制限

| フィールド | 制限 |
| - | - |
| メッセージ`body` | 必須および空白でない、最大4096 バイト。 |
| メッセージ`footer` | 最大 256 バイト。 |
| `buttons` | メッセージまたはカード1枚につき1-10。 |
| `params` ボタン | JSON オブジェクト、最大 16,384 バイト。 |
| `cards` | 2-10枚のカード。 |
| カード `body` | 必須および空白でない、最大4096 バイト。 |
| カードの `title` と `footer` | 各最大256バイト。 |
| カード `image_base64` | 最大2,800,000エンコードされた文字と200,000,000デコードされたバイトは、サーバの設定された画像サイズ制限の対象となります。 |
| デコードされた画像 | JPEGまたはPNG、1辺の最大4096ピクセル。 |

サーバーの全体的な HTTP リクエスト本文の制限も適用されます。複数のカードを送信するときに小さな画像を使用してください。 無効な選択またはサイズは、送信する前に検証エラーを返します。

## 返信と領収書を処理する

成功すると `results.message_id` で通常の成功エンベロープが返され、受信者のレンダリングが未検証であるというステータスが返されます。 返信には[受信Webhooks](https://gowa-docs.mintlify.site/ja/concepts/webhooks.md)を、受信には`message.ack`を使用してください。あいまいなタイムアウト後に再試行すると、メッセージが重複する可能性があります。

Android下流テストでは、作業応答、URL、コピー、通話、選択、ロケーション、カルーセルアクションが報告されています。 これらのレポートは、アカウント、iOS、またはWhatsAppウェブ間の互換性を確立していません。 個々のカルーセルカードは、親メッセージにチェックマークがあり、受信者が返信できる場合でも保留中のアイコンを表示できます。その問題は未解決のままです。

エンドポイントは公式テンプレートを登録したり、インラインフロー、カタログ、ネイティブ決済をサポートしていません。


## Related topics

- [実験的なインタラクティブメッセージを送信する](https://gowa-docs.mintlify.site/ja/api-reference/send/実験的なインタラクティブメッセージを送信する.md)
- [メッセージを送信中](https://gowa-docs.mintlify.site/ja/examples/sending-messages.md)
- [メッセージの受信](https://gowa-docs.mintlify.site/ja/examples/receiving-messages.md)
- [スターメッセージ](https://gowa-docs.mintlify.site/ja/api-reference/message/スターメッセージ.md)
- [メッセージを削除](https://gowa-docs.mintlify.site/ja/api-reference/message/メッセージを削除.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.