WhatsApp Business 平台內部部署 API

傳送文字訊息

您可以使用 messages 節點傳送文字訊息給顧客。

準備工作

您需要符合訊息文件中準備工作一節列示的所有必要條件。

限制：

  • 一則簡訊的長度最多可以有 4096 個字元。

步驟 1：向 /messages 發出 POST 呼叫

取得要傳送訊息的目標用戶 WhatsApp 編號後，請用它來傳送文字訊息。在 type 欄位中指定 text。

POST /v1/messages
{
    "preview_url": false | true,
    "recipient_type": "individual",
    "to": "whatsapp-id",
    "type": "text",
    "text": {
        "body": "your-text-message-content"
    }
}

如需參數的詳細資訊，請參閱：

如果您想設定訊息格式，請參閱文字訊息格式設定。

在文字訊息中傳送網址

在預設情況下，行動 WhatsApp 應用程式會辨識網址並使其可供點擊。若要加入網址預覽，請在訊息本文中加入 "preview_url": true，並確認網址開頭為 http:// 或 https://。請提供主機名稱，IP 位址不相符。

請注意，這裡使用的 preview_url 與雲端 API 不同。請參閱訊息雲端 API 說明文件。

範例

{
    "preview_url": true,
    "to": "whatsapp-id",
    "text": {
        "body": "You have to check out this amazing messaging service https://www.whatsapp.com/"
     }

在大多數情況下，當您傳送網址時，無論是否加入預覽，訊息接收者都會看到可以點擊的網址。

只有在發生下列其中一種情況時，系統才會顯示網址預覽畫面：

  1. 商家傳送訊息範本給用戶。
  2. 用戶使用「點擊對話」連結發起對話。
  3. 用戶在通訊錄中新增商家的電話號碼並發起對話。

步驟 2：檢查回應

成功的回應會包含一個 messages 物件，其中具有新建立訊息的編號。

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}

不成功的回應則會包含錯誤訊息。如需更多資訊，請參閱錯誤和狀態代碼。