Đăng ký
Bạn phải đăng ký số điện thoại của doanh nghiệp thì mới sử dụng được số này với API Đám mây. Hãy đăng ký số điện thoại của doanh nghiệp trong các trường hợp sau đây:
- Tạo tài khoản: Khi triển khai API này, bạn cần đăng ký số điện thoại của doanh nghiệp mà bạn muốn dùng để gửi tin nhắn. Chúng tôi thực thi việc đặt tính năng xác minh hai bước trong quá trình tạo tài khoản để bổ sung thêm một lớp bảo mật cho tài khoản của bạn.
- Thay đổi tên: Trong trường hợp này, điện thoại của bạn đã được đăng ký và bạn muốn thay đổi tên hiển thị của mình. Để làm việc đó, trước tiên, bạn phải gửi yêu cầu thay đổi tên trên Trình quản lý WhatsApp. Sau khi tên đó được phê duyệt, bạn cần đăng ký lại điện thoại của mình theo tên mới.
- Chuyển số của bạn từ API Tại chỗ sang API Đám mây. Hãy xem phần Trường hợp ngoại lệ khi chuyển.
Bạn phải xác minh quyền sở hữu số điện thoại của doanh nghiệp thì mới có thể đăng ký số này.
Trường hợp ngoại lệ khi chuyển
Nếu đang chuyển một số điện thoại từ API Tại chỗ sang API Đám mây, bạn cần thực hiện thêm một số bước trước khi đăng ký số điện thoại với API Đám mây. Hãy xem phần Chuyển giữa API Tại chỗ và API Đám mây để biết quy trình đầy đủ.
Đăng ký số điện thoại của doanh nghiệp
Để đăng ký số điện thoại đã được xác minh của doanh nghiệp, hãy thực hiện lệnh gọi POST đến PHONE_NUMBER_ID/register. Bạn nên thêm các thông số nêu dưới đây.
| Điểm cuối | Xác thực |
|---|---|
(Xem phần Lấy ID số điện thoại) |
Solution Partners must authenticate themselves with an access token with the |
Giới hạn
Mỗi số điện thoại của doanh nghiệp chỉ được gửi 10 yêu cầu đến điểm cuối đăng ký trong khoảng thời gian 72 giờ liên tục.
Khi bạn gửi yêu cầu đăng ký, chúng tôi sẽ kiểm tra xem bạn đã gửi bao nhiêu yêu cầu đăng ký cho số đó trong 72 giờ qua. Nếu bạn đã gửi 10 yêu cầu, API sẽ trả về mã lỗi 133016 và số ở trên sẽ không được đăng ký trong 72 giờ tiếp theo.
Thông số
| Tên | Mô tả |
|---|---|
| Bắt buộc. Dịch vụ nhắn tin được sử dụng. Hãy đặt thông số này là |
| Bắt buộc. Nếu bạn đã bật tính năng xác minh hai bước cho số điện thoại đã được xác minh của doanh nghiệp mình, hãy đặt giá trị này thành mã PIN xác minh hai bước gồm 6 chữ số của số đó. Nếu không nhớ mã PIN, bạn có thể cập nhật mã đó. Nếu bạn chưa bật tính năng xác minh hai bước cho số điện thoại đã được xác minh của doanh nghiệp mình, hãy đặt giá trị này thành một số gồm 6 chữ số. Đây sẽ là mã PIN xác minh hai bước cho số điện thoại mới được xác minh của doanh nghiệp. |
| Không bắt buộc. Nếu được thêm, thông số này sẽ bật bộ nhớ cục bộ trên số điện thoại của doanh nghiệp. Giá trị phải là mã quốc gia gồm 2 chữ cái theo tiêu chuẩn ISO 3166 (ví dụ: Giá trị được hỗ trợ: Châu Á Thái Bình Dương
Châu Âu
Châu Mỹ Latinh
Trung Đông và Châu Phi
Bắc Mỹ
Sau khi bật thông số này, bạn không thể vô hiệu hóa hay thay đổi trực tiếp. Thay vào đó, bạn phải hủy đăng ký số điện thoại rồi đăng ký lại mà không có thông số này (để vô hiệu hóa) hoặc thêm thông số này với mã quốc gia mới (để thay đổi). Để bật bộ nhớ cục bộ trên một số điện thoại mà bạn đã đăng ký, bạn phải hủy đăng ký số đó rồi đăng ký lại và thêm thông số này. |
Yêu cầu mẫu không có bộ nhớ cục bộ
curl 'https://graph.facebook.com/v21.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
"messaging_product": "whatsapp",
"pin": "212834"
}
Yêu cầu mẫu có bộ nhớ cục bộ
curl 'https://graph.facebook.com/v21.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
"messaging_product": "whatsapp",
"pin": "212834",
"data_localization_region": "CH"
}
All API calls require authentication with access tokens.
Developers can authenticate their API calls with the access token generated in the App Dashboard > WhatsApp > API Setup.
Solution Partners must authenticate themselves with an access token with the whatsapp_business_messaging and whatsapp_business_management permissions. See System User Access Tokens for information.
Hủy đăng ký số điện thoại của doanh nghiệp
Khi hủy đăng ký một số điện thoại của doanh nghiệp, bạn sẽ không thể sử dụng số đó với API Đám mây nữa, đồng thời bộ nhớ cục bộ trên số này sẽ bị vô hiệu hóa nếu bạn đã bật.
Việc hủy đăng ký sẽ không xóa số điện thoại hay lịch sử tin nhắn của số đó. Nếu bạn muốn xóa số cùng lịch sử, hãy xem phần Xóa số điện thoại khỏi WABA.
Để hủy đăng ký một số điện thoại của doanh nghiệp, hãy thực hiện lệnh gọi POST đến PHONE_NUMBER_ID/deregister:
| Điểm cuối | Xác thực |
|---|---|
(Xem phần Lấy ID số điện thoại) |
Solution Partners must authenticate themselves with an access token with the |
Giới hạn
Mỗi số điện thoại của doanh nghiệp chỉ được gửi 10 yêu cầu đến điểm cuối hủy đăng ký trong khoảng thời gian 72 giờ liên tục.
Khi bạn gửi yêu cầu hủy đăng ký, chúng tôi sẽ kiểm tra xem bạn đã gửi bao nhiêu yêu cầu hủy đăng ký cho số đó trong 72 giờ qua. Nếu bạn đã gửi 10 yêu cầu, API sẽ trả về mã lỗi 133016 và số ở trên sẽ không được hủy đăng ký trong 72 giờ tiếp theo.
Ví dụ
Yêu cầu mẫu:
curl -X POST \
'https://graph.facebook.com/v21.0/FROM_PHONE_NUMBER_ID/deregister' \
-H 'Authorization: Bearer ACCESS_TOKEN'
Phản hồi thành công có dạng như sau:
{
"success": true
}