Quản lý số điện thoại và chứng chỉ

Hướng dẫn này cung cấp thông tin tổng quan liên quan đến số điện thoại dành cho Đối tác giải pháp và khách hàng. Ngoài ra, hướng dẫn này cũng có thông tin quy trình dành cho Đối tác giải pháp trong trường hợp họ phải quản lý số điện thoại và chứng chỉ của khách hàng.

Thông tin sơ bộ về số điện thoại

Các doanh nghiệp cần biết một số thông tin chi tiết liên quan đến số điện thoại và quy trình Đăng ký nhúng.

Các doanh nghiệp cần có một số điện thoại chuyên dụng để dùng WhatsApp thông qua quy trình đăng ký nhúng. Nếu doanh nghiệp đã đăng ký một số trên WhatsApp Messenger hoặc Ứng dụng WhatsApp Business, họ sẽ không thể sử dụng cùng số điện thoại đó.

Các doanh nghiệp có thể đã liên kết nhiều số điện thoại với Tài khoản kinh doanh trên Meta của mình. Do vậy, tất cả những gì họ phải làm là thêm số điện thoại khác và dùng số đó cho WhatsApp.

Để biết thêm thông tin chi tiết liên quan đến số điện thoại và Nền tảng WhatsApp Business, hãy xem phần Số điện thoại.

Để biết thông tin về cách chuyển số điện thoại hiện có đã đăng ký với WhatsApp, hãy xem phần Chuyển số điện thoại.

Hướng dẫn dành cho khách hàng

Phần này hướng đến khách hàng sử dụng quy trình Đăng ký nhúng, cũng như cung cấp hướng dẫn về những hành động họ có thể thực hiện liên quan đến số điện thoại.

Thêm số điện thoại vào tài khoản WhatsApp Business

Có 2 cách để thêm số điện thoại khác vào Tài khoản WhatsApp Business (WABA):

1. [Khuyến nghị] Thực hiện lại quy trình đăng ký nhúng, chọn Trình quản lý kinh doanh và WABA hiện có, thêm số điện thoại rồi xác minh số đó.
2. Trong Trình quản lý kinh doanh, chuyển đến tab Số điện thoại trong Trình quản lý WhatsApp rồi chọn Thêm số điện thoại. Khi sử dụng tùy chọn này, Đối tác giải pháp phải xác minh thủ công số điện thoại vì Trình quản lý kinh doanh không có quy trình xác minh số điện thoại. Vì lý do này, các doanh nghiệp nên tuân theo quy trình đăng ký được nhúng để thêm số điện thoại khác.

Hướng dẫn dành cho Đối tác giải pháp

Phần này hướng đến Đối tác giải pháp và cung cấp hướng dẫn về cách quản lý số điện thoại cũng như chứng chỉ của khách hàng.

Đăng ký số điện thoại cho API Đám mây

Sau khi xác minh số điện thoại thành công qua quy trình đăng ký nhúng, bạn sẽ hoàn tất quá trình đăng ký bằng lệnh gọi API đến điểm cuối register. Đối với lệnh gọi này, hãy cung cấp code_method bất kỳ (sms | voice). Vì số điện thoại đã được xác minh nên bạn không phải lo về mã đăng ký nữa. Bạn không cần phải thực hiện lệnh gọi API verify.

Ngoài ra, bạn có thể xác minh trước số điện thoại rồi cung cấp số điện thoại này cho khách hàng trong quy trình Đăng ký được nhúng mới. Như vậy, khách hàng sẽ không phải liên hệ với bạn để lấy mật khẩu một lần trong quá trình tích hợp. Hãy xem phần Số điện thoại được xác minh trước.

Đăng ký số điện thoại cho API Tại chỗ

Sau khi xác minh số điện thoại thành công qua quy trình đăng ký nhúng, bạn sẽ hoàn tất quá trình đăng ký bằng lệnh gọi API đến điểm cuối account. Đối với lệnh gọi này, hãy cung cấp code_method (sms | voice). Vì số điện thoại đã được xác minh nên bạn không phải lo về mã đăng ký nữa. Bạn không cần phải thực hiện lệnh gọi API verify.

Ngoài ra, bạn có thể xác minh trước số điện thoại rồi cung cấp số điện thoại này cho khách hàng trong quy trình Đăng ký được nhúng mới. Như vậy, khách hàng sẽ không phải liên hệ với bạn để lấy mật khẩu một lần trong quá trình tích hợp. Hãy xem phần Số điện thoại được xác minh trước.

Lấy trạng thái số điện thoại và chứng chỉ

Với điểm cuối phone_numbers, bạn có thể xem trạng thái yêu cầu thay đổi tên hiển thị của số điện thoại, cũng như truy xuất chứng chỉ sau khi thay đổi tên. Hãy xem phần Đọc số điện thoại để biết thêm thông tin.

Yêu cầu mẫu

Ví dụ dưới đây sử dụng ID cho WABA được chỉ định.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?fields=
    display_phone_number,
    certificate,
    name_status,
    new_certificate,
    new_name_status
  &access_token={system-user-access-token}"

Phản hồi mẫu

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "last_onboarded_time": "2023-08-22T19:05:53+0000",
      "certificate": "AbCdEfGhIjKlMnOpQrStUvWxYz",
      "new_certificate": "123AbCdEfGhIjKlMnOpQrStUvWxYz",
      "name_status": "APPROVED",
      "new_name_status": "APPROVED",
    }
  ]
}

Thông số phản hồi

Lấy trạng thái OTP của điện thoại

Để xem liệu một số điện thoại đã được xác minh qua OTP (mật khẩu một lần) hay chưa, hãy kiểm tra trường code_verification_status của số điện thoại đó. Đầu tiên, hãy thực hiện lệnh gọi GET đến điểm cuối /{whatsapp-business-account-id}/phone_numbers:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?access_token={your-access-token}"

Phản hồi sẽ bao gồm code_verification_status cùng với một trong các tùy chọn sau: VERIFIED hoặc NOT_VERIFIED. Một phản hồi mẫu có dạng như sau:

[
  {
    "code_verification_status": "NOT_VERIFIED",
    "id": "1754951608042154"
  }
]

Ngoài ra, bạn có thể lấy trạng thái bằng cách gọi ID của một số điện thoại:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{phone-number-id}
  ?access_token={your-access-token}"

Lọc số điện thoại theo chế độ tài khoản

Bạn có thể truy vấn số điện thoại và lọc dựa trên account_mode. Đối với yêu cầu này, bạn có thể sử dụng các thông số trong danh sách bên dưới.

Thông số yêu cầu

Yêu cầu mẫu

Ví dụ dưới đây sử dụng ID cho WABA được chỉ định.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?filtering=[{
    "field":"account_mode",
    "operator":"EQUAL",
    "value":"SANDBOX"}]
  &access_token={system-user-access-token}"

Phản hồi mẫu

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "verified_name": "John’s Cake Shop",
      "quality_rating": "UNKNOWN",
    }
  ],
  "paging": {
	"cursors": {
		"before": "abcdefghij"
		"after": "klmnopqr"
	}
   }
}

Tìm hiểu thêm

• Số điện thoại: Tổng quan về Nền tảng WhatsApp Business
• Số điện thoại: Chuyển số điện thoại đã đăng ký hiện có
• Tài liệu tham khảo: Tài khoản WhatsApp Business