メインコンテンツへスキップ
POST /send/interactive は、選択したデバイスを通じてWhatsAppネイティブフローメッセージを送信します。 Basic Auth、X-Device-Id、および JSON bodyを使用してください。このエンドポイントは即時のREST送信をサポートしています。スケジュールされた送信とMCPはそれを公開しません。
この実験的なエンドポイントは非公式のWhatsAppプロトコルを使用しています。受信者のレンダリングはクライアントによって異なり、予告なしに変更することができます。 使用前にターゲットクライアントをテストします。API応答が正常に送信承認を確認します。配信やレンダリングではありません。
curl サンプルを実行する前にサーバーの URL と認証情報を設定します。リモートサーバーの HTTPS URL を使用し、設定された場合は APP_BASE_PATH を含めます。

送信ボタン

phone は電話番号またはフルユーザーまたはグループJIDを受け付けます。 グループ送信にはメンバーシップと投稿権限が必要です。ニュースレターとブロードキャスト受信者はサポートされていません。 トップレベルの buttons または cards を指定します。両方を提供する、またはどちらかを指定すると、検証に失敗します。 選択リストには、次のパラメータを使用します。

位置情報をリクエスト

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

画像カルーセルを送信

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

リクエスト制限

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

返信と領収書を処理する

成功すると results.message_id で通常の成功エンベロープが返され、受信者のレンダリングが未検証であるというステータスが返されます。 返信には受信Webhooksを、受信にはmessage.ackを使用してください。あいまいなタイムアウト後に再試行すると、メッセージが重複する可能性があります。 Android下流テストでは、作業応答、URL、コピー、通話、選択、ロケーション、カルーセルアクションが報告されています。 これらのレポートは、アカウント、iOS、またはWhatsAppウェブ間の互換性を確立していません。 個々のカルーセルカードは、親メッセージにチェックマークがあり、受信者が返信できる場合でも保留中のアイコンを表示できます。その問題は未解決のままです。 エンドポイントは公式テンプレートを登録したり、インラインフロー、カタログ、ネイティブ決済をサポートしていません。