傳送文字訊息

您可以使用 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"
  }]
}  

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