Tài khoản
/v1/account
Chúng tôi sẽ ngừng cung cấp API Tại chỗ. Điểm cuối này sẽ không còn được dùng để đăng ký số điện thoại của doanh nghiệp nữa và hiện sẽ trả về lỗi sau đây:
{
"code": 1005,
"title": "Access denied",
"details": "Unknown error: biz_link_on_prem_reg_blocked"
}
Nút account được dùng để đăng ký ứng dụng API WhatsApp Business.
Lưu ý rằng Coreapp sẽ khởi động lại nếu bạn đăng ký số điện thoại mới trong nhóm đã được đăng ký số điện thoại khác.
Cạnh
Dưới đây là những cạnh được kết nối với nút này:
| Cạnh | Mô tả |
|---|---|
Sau khi bạn nhận được mã đăng ký qua phương thức đã chỉ định, hãy dùng cạnh này để hoàn tất quá trình đăng ký tài khoản. |
Trước khi bạn bắt đầu
Bạn sẽ cần:
- Mã xác thực cho phép đăng nhập vào dịch vụ
- Số điện thoại hợp lệ được liên kết với Tài khoản WhatsApp Business của bạn
- Tên hiển thị do WhatsApp phê duyệt được liên kết với số điện thoại đó
Sao chép chứng chỉ được mã hóa base64
Một chuỗi chứng chỉ được mã hóa base64 sẽ được tạo cho bạn và dùng để xác thực trong quá trình đăng ký ứng dụng API WhatsApp Business.
- Chuyển đến phần Cài đặt cho doanh nghiệp trong Trình quản lý kinh doanh trên Meta.
- Nhấp vào Tài khoản WhatsApp trong menu Tài khoản, sau đó chọn Tài khoản WhatsApp của bạn trong danh sách Tài khoản WhatsApp nếu tài khoản này chưa được nêu bật.
- Chuyển đến tab Cài đặt rồi nhấp vào nút Trình quản lý WhatsApp.
- Trong tab Số điện thoại, bạn sẽ thấy số điện thoại của mình trong danh sách. Hãy nhấp vào nút Xem của số điện thoại mà bạn muốn lấy chứng chỉ.
Lấy chứng chỉ - Hộp thoại bật lên sẽ hiển thị chuỗi chứng chỉ trong ô màu xám. Hãy nhấp vào Lấy chứng chỉ.
Tải chuỗi chứng chỉ xuống - Sử dụng chuỗi chứng chỉ này trong thông số
certkhi đăng ký với điểm cuốiaccount.
Hãy xem tài liệu về Tên hiển thị để biết thêm thông tin.
Giới hạn
- Bạn phải sử dụng tài khoản
adminđể đăng ký ứng dụng. - Nếu đang đăng ký lại tài khoản thì bạn cần phải khởi động lại Coreapp sau khi hoàn tất đăng ký.
Yêu cầu
Thực hiện lệnh gọi POST đến điểm cuối này để yêu cầu mã đăng ký. Trong lệnh gọi này, hãy thêm số điện thoại và chuỗi chứng chỉ được mã hóa base64 của bạn. Bạn có thể nhận được mã qua SMS hoặc cuộc gọi thoại.
Ví dụ
POST /v1/account
{
"cc": "COUNTRY_CODE",
"phone_number": "PHONE_NUMBER_WITHOUT_COUNTRY_CODE",
"method": "sms" or "voice",
"cert": "VERIFIED_NAME_CERT_IN_BASE64",
"pin": "EXISTING_6_DIGIT_PIN" # required if two-step verification is enabled
}
Tùy thuộc vào phản hồi nhận được, bạn sẽ biết mình đã hoàn tất quy trình đăng ký hay cần phải thực hiện thêm bước khác. Nếu thành công, bạn sẽ nhận được một trong các mã trạng thái HTTP dưới đây. Hãy làm theo hướng dẫn phù hợp với phản hồi mà bạn nhận được:
201 Created- Tài khoản này đã tồn tại. Bạn đã đăng ký rồi nên không phải làm gì nữa.202 Accepted- Tài khoản này không tồn tại. Tùy thuộc vào phương thức bạn đã chọn trong yêu cầu, hãy kiểm tra SMS hoặc nghe cuộc gọi thoại để lấy mã đăng ký. Phản hồi này sẽ có phần tải dữ liệu được trả về chứavnameđược giải mã từ thông sốcertđể bạn xác nhận rằng bạn đang đặt đúng tên hiển thị. Nếu đúng, hãy chọn Hoàn tất đăng ký tài khoản để hoàn tất đăng ký.
{
"account": [{
"vname": "decoded-vname-from-cert"
}]
}
Nếu hệ thống trả về bất kỳ lỗi nào, bạn hãy tham khảo phần Thông báo lỗi và trạng thái để biết thêm thông tin.
Thông số
| Tên | Mô tả |
|---|---|
| Bắt buộc. Mã quốc gia bằng số cho số điện thoại bạn đang đăng ký |
| Bắt buộc. Số điện thoại bạn đang đăng ký, không bao gồm mã quốc gia hoặc dấu cộng ( |
| Bắt buộc. Phương thức nhận mã đăng ký |
| Bắt buộc. Chứng chỉ được mã hóa base64. |
| Không bắt buộc. Mã PIN 6 chữ số hiện có - Chỉ bắt buộc khi bạn bật tính năng xác minh hai bước trên tài khoản này. |
Thay đổi mã PIN xác minh hai bước
Cách thay đổi mã PIN xác minh hai bước cho số điện thoại của doanh nghiệp bạn:
- Tải hồ sơ doanh nghiệp của bạn trong Trình quản lý WhatsApp.
- Nếu hồ sơ này không tự động tải bảng điều khiển Số điện thoại, hãy chuyển đến Công cụ trong tài khoản (biểu tượng hộp công cụ) > Số điện thoại.
- Nhấp vào biểu tượng cài đặt (bánh răng) của số điện thoại.
- Nhấp vào Xác minh hai bước.
- Nhấp vào Thay đổi mã PIN và hoàn tất quy trình.
Bạn phải cung cấp mã PIN hiện tại thì mới thay đổi được. Lưu ý rằng bạn cũng có thể đặt mã PIN mới bằng các API của chúng tôi:
Tắt tính năng xác minh hai bước
Để tắt tính năng xác minh hai bước, hãy làm theo các bước thay đổi mã PIN nhưng nhấp vào nút Tắt tính năng xác minh hai bước ở bước cuối cùng. Hệ thống sẽ gửi email chứa liên kết đến địa chỉ email được liên kết với hồ sơ doanh nghiệp của bạn. Hãy dùng liên kết này để tắt tính năng xác minh hai bước. Sau khi tắt, bạn có thể bật lại tính năng này bằng cách đặt mã PIN mới.
Câu hỏi thường gặp
Có, chúng tôi có thể thiết lập số điện thoại mới hoặc thay đổi tên đã xác minh khi bạn sẵn sàng hoạt động.
Bạn được phép dùng các số miễn phí miễn là bao gồm cả mã quốc gia. Lý do là vì chúng tôi không thể xác định duy nhất các số miễn phí không có mã quốc gia - cùng một số có thể áp dụng cho 2 quốc gia khác nhau.
Ngoài ra, lưu ý rằng việc sử dụng số miễn phí cũng làm gia tăng tính phức tạp. Thông thường, nếu bạn gọi một số miễn phí có mã quốc gia khi đang ở quốc gia này thì cuộc gọi sẽ không thực hiện được. Điều này nghĩa là khách hàng tại quốc gia của bạn có thể tìm cách gọi đến số hiển thị trong thông tin liên hệ của doanh nghiệp (có kèm mã quốc gia) và họ sẽ không thể liên hệ với bạn. Nếu lo ngại về điều này, bạn cần nói rõ cho họ biết.
Đọc thêm thông tin về số miễn phí tại đây.
Nếu bạn sao lưu tùy chọn thiết lập hiện tại và khôi phục tùy chọn đó trên máy mới thì thông tin đăng ký sẽ chuyển qua phần còn lại trong quá trình triển khai. Hãy xem tài liệu về Cài đặt sao lưu và khôi phục để biết thêm thông tin.
Trong Trình quản lý kinh doanh Facebook, bạn có thể đăng ký các số điện thoại mới và xóa số cũ thuộc Tài khoản WhatsApp.
- Trong Tài khoản WhatsApp, hãy chuyển đến phần Cài đặt.
- Nhấp vào Trình quản lý WhatsApp.
- Chọn tab Số điện thoại. Tại đây, bạn có thể quản lý tất cả số điện thoại cho tài khoản này.
Nếu quá trình đăng ký bằng "sms" không thành công do có quá nhiều lần thực hiện và bạn nhận được thông báo "truy cập bị từ chối", vui lòng thử đăng ký bằng "cuộc gọi thoại"
Rất tiếc, bạn cần chọn một số điện thoại khác có khả năng nhận SMS hoặc cuộc gọi thoại để chúng tôi gửi mã đăng ký. Trước đây, chúng tôi đã cho phép mã đăng ký thủ công, nhưng hiện không còn hỗ trợ mã này. Các số điện thoại đã dùng mã đăng ký thủ công trước đây sẽ tiếp tục được hỗ trợ theo yêu cầu. Đối với mọi số điện thoại mới, chúng tôi sẽ chỉ gửi mã đăng ký qua SMS hoặc cuộc gọi thoại.
Nếu bạn muốn sử dụng 1800 hoặc số miễn phí, vui lòng đọc hướng dẫn này.