API Đám mây

Gửi mẫu xác thực

Tài liệu này giải thích cách gửi mẫu xác thực có nút mật khẩu một lần đã được phê duyệt.

Yêu cầu

Sử dụng điểm cuối Số điện thoại WhatsApp Business > Tin nhắn để gửi tin nhắn mẫu xác thực có nút mật khẩu một lần.

Cú pháp yêu cầu

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Nội dung yêu cầu POST

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<CUSTOMER_PHONE_NUMBER>",
  "type": "template",
  "template": {
    "name": "<TEMPLATE_NAME>",
    "language": {
      "code": "<TEMPLATE_LANGUAGE_CODE>"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "<ONE-TIME PASSWORD>"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": "0",
        "parameters": [
          {
            "type": "text",
            "text": "<ONE-TIME PASSWORD>"
          }
        ]
      }
    ]
  }
}

Thuộc tính nội dung

Phần giữ chỗMô tảGiá trị mẫu

<CUSTOMER_PHONE_NUMBER>

Số điện thoại WhatsApp của khách hàng.

12015553931

<ONE-TIME PASSWORD>

Mật khẩu một lần hoặc mã xác minh sẽ được gửi cho khách hàng.


Lưu ý rằng giá trị này phải xuất hiện 2 lần trong phần tải dữ liệu.


Tối đa 15 ký tự.

J$FpnYnP

<TEMPLATE_LANGUAGE_CODE>

Mã ngôn ngữ và địa phương của mẫu.

en_US

<TEMPLATE_NAME>

Tên mẫu.

verification_code

Phản hồi

Sau khi thành công, API này sẽ phản hồi kèm theo:

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "<INPUT>",
      "wa_id": "<WA_ID>"
    }
  ],
  "messages": [
    {
      "id": "<ID>"
    }
  ]
}

Nội dung phản hồi

Phần giữ chỗMô tảGiá trị mẫu

<INPUT>

Chuỗi

Số điện thoại của khách hàng nhận tin nhắn. Giá trị này có thể không khớp với wa_id.

+16315551234

<WA_ID>

Chuỗi

ID WhatsApp của khách hàng nhận tin nhắn. Giá trị này có thể không khớp với input.

+16315551234

<ID>

Chuỗi

ID tin nhắn trên WhatsApp. Bạn có thể sử dụng ID được liệt kê phía sau "wamid." để theo dõi trạng thái tin nhắn của mình.

wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI3N0EyQUJDMjFEQzZCQUMzODMA

Ví dụ

Yêu cầu mẫu

curl -L 'https://graph.facebook.com/v19.0/105954558954427/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '{
      "messaging_product": "whatsapp",
      "recipient_type": "individual",
      "to": "12015553931",
      "type": "template",
      "template": {
        "name": "verification_code",
        "language": {
          "code": "en_US"
      },
      "components": [
        {
          "type": "body",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        },
        {
          "type": "button",
          "sub_type": "url",
          "index": "0",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        }
      ]
    }
  }'

Phản hồi mẫu

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "12015553931",
      "wa_id": "12015553931"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI4Qzc5QkNGNTc5NTMyMDU5QzEA"
    }
  ]
}