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"
  }]
}

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