Quản lý tài khoản WhatsApp Business

Sau khi nhúng quy trình đăng ký vào trang web của bạn, bước tiếp theo sẽ là tích hợp với các điểm cuối API cần thiết để hoàn tất quy trình này.

Hướng dẫn này đề cập đến các hành động mà Đối tác giải pháp có thể cần thực hiện để quản lý Tài khoản WhatsApp Business (WABA).

Lấy ID WABA dùng chung bằng mã truy cập

Sau khi một doanh nghiệp hoàn tất quy trình đăng ký nhúng, bạn có thể lấy ID WABA dùng chung bằng accessToken nhận được cùng với điểm cuối Debug-Token. Thêm Mã truy cập dành cho Người dùng hệ thống vào tiêu đề yêu cầu có Authorization: Bearer ở đầu cho lệnh gọi API này.

Cú pháp yêu cầu

GET https://graph.facebook.com/<API_VERSION>/debug_token
  ?input_token=<TOKEN_RETURNED_FROM_SIGNUP_FLOW>

Yêu cầu mẫu

curl \
'https://graph.facebook.com/v21.0/debug_token?input_token=EAAFl...' \
-H 'Authorization: Bearer EAAJi...'

Phản hồi mẫu

{
  "data" : {
    "app_id" : "670843887433847",
    "application" : "JaspersMarket",
    "data_access_expires_at" : 1672092840,
    "expires_at" : 1665090000,
    "granular_scopes" : [
      {
        "scope" : "whatsapp_business_management",
        "target_ids" : [
          "102289599326934", // ID of newest WABA to grant app whatsapp_business_management
          "101569239400667"
        ]
      },
      {
        "scope" : "whatsapp_business_messaging",
        "target_ids" : [
          "102289599326934",
          "101569239400667"
        ]
      }
    ],
    "is_valid" : true,
    "scopes" : [
       "whatsapp_business_management",
       "whatsapp_business_messaging",
       "public_profile"
    ],
    "type" : "USER",
    "user_id" : "10222270944537964"
  }
}

Mỗi đối tượng trong mảng granular_scopes sẽ xác định ID của tất cả WABA đã cấp cho ứng dụng của bạn một quyền cụ thể (scope). ID của các WABA được tích hợp gần đây nhất sẽ xuất hiện trước. Vì vậy, hãy lấy ID đầu tiên trong mảng target_ids cho phạm vi whatsapp_business_management.

Lấy danh sách WABA dùng chung

Điểm cuối client_whatsapp_business_accounts sẽ truy xuất danh sách tất cả WABA được chỉ định cho/chia sẻ với tài khoản Trình quản lý kinh doanh của bạn sau khi quy trình đăng ký nhúng hoàn tất.

Theo định kỳ, bạn có thể sử dụng điểm cuối này để theo dõi các WABA được chia sẻ với mình. Bằng cách này, bạn có thể biết điểm khác biệt và tìm thấy các tài khoản được chia sẻ với mình gần đây, như giải pháp dự phòng cho phương thức dùng điểm cuối Debug-Token được mô tả trong hướng dẫn Quản lý tài khoản WhatsApp Business.

Bạn có thể tìm thấy danh sách các trường của WABA mà mình có thể yêu cầu từ điểm cuối này trong tài liệu tham khảo về Tài khoản WhatsApp Business.

Cú pháp yêu cầu

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/client_whatsapp_business_accounts

Yêu cầu mẫu

curl \
'https://graph.facebook.com/v21.0/805021500648488/client_whatsapp_business_accounts/' \
-H 'Authorization: Bearer EAAJi...'

Phản hồi mẫu

{
  "data": [
    {
      "id": 1906385232743451, 
      "name": "My WhatsApp Business Account", 
      "currency": "USD", 
      "timezone_id": "1", 
      "message_template_namespace": "abcdefghijk_12lmnop" 
    },
    {
      "id": 1972385232742141, 
      "name": "My Regional Account", 
      "currency": "INR", 
      "timezone_id": "5", 
      "message_template_namespace": "12abcdefghijk_34lmnop" 
    },
  ],
  "paging": {
    "cursors": {
      "before": "abcdefghij",
      "after": "klmnopqr"
    }
  }
}

Tìm hiểu về WABA dùng chung

Quyền

Đối tác giải pháp có các quyền sau đây trong WABA dùng chung:

Thêm số điện thoại
Tạo mẫu tin nhắn
Gửi tin nhắn cho khách hàng
Chỉ định người dùng cho tài khoản
Truy cập các số liệu
Xem thông tin thanh toán

Từ phía mình, các doanh nghiệp tích hợp qua quy trình đăng ký nhúng có thể xem và/hoặc làm những điều sau:

Hạng mục	Các doanh nghiệp có thể xem thông tin gì?
Thông tin chi tiết	Các thay đổi về tin nhắn, chi phí và trạng thái chất lượng.
Chất lượng	Trạng thái và mức xếp hạng chất lượng.

Hạng mục	Các doanh nghiệp có thể làm điều gì?
Tài sản	Thêm và quản lý số điện thoại cũng như các mẫu. Các doanh nghiệp không thể tải chứng chỉ xuống để đăng ký số điện thoại, chỉ Đối tác giải pháp mới có thể làm điều đó.
Quản lý WABA	Bỏ chia sẻ WABA với Đối tác giải pháp, xóa WABA và thay đổi các cài đặt.
Tích hợp với các sản phẩm khác của Meta	Tích hợp với các quảng cáo click đến WhatsApp.

Hạng mục

Các doanh nghiệp có thể làm điều gì?

Tài sản

Thêm và quản lý số điện thoại cũng như các mẫu.

Các doanh nghiệp không thể tải chứng chỉ xuống để đăng ký số điện thoại, chỉ Đối tác giải pháp mới có thể làm điều đó.

Quản lý WABA

Bỏ chia sẻ WABA với Đối tác giải pháp, xóa WABA và thay đổi các cài đặt.

Tích hợp với các sản phẩm khác của Meta

Tích hợp với các quảng cáo click đến WhatsApp.

Đối tác giải pháp không thể vô hiệu hóa những thông tin/điều mà các doanh nghiệp có thể xem/làm hay tùy chỉnh chế độ xem của họ.

Doanh nghiệp có thể xem bài viết Quản lý quyền của Đối tác giải pháp trên WhatsApp để biết thêm thông tin.

Thông báo

Đối tác giải pháp sẽ nhận được thông báo phù hợp qua webhooks cũng như qua Trình quản lý kinh doanh. Hệ thống sẽ gửi thông báo khi:

Một doanh nghiệp chia sẻ WABA.
Có thay đổi về giới hạn tin nhắn hoặc mức xếp hạng chất lượng đối với WABA của khách hàng.
Khi tên hiển thị số điện thoại hoặc một mẫu được phê duyệt.

Nếu doanh nghiệp thoát khỏi quy trình đăng ký nhúng trước khi hoàn tất thành công, họ có thể đã chia sẻ WABA nhưng chứng chỉ vẫn chưa sẵn sàng để tải xuống. Nếu điều này xảy ra, vui lòng liên hệ với doanh nghiệp này để hỗ trợ họ hoàn tất quy trình đăng ký nhúng.

Lấy danh sách các tài khoản WhatsApp Business thuộc quyền sở hữu

Hãy sử dụng điểm cuối owned_whatsapp_business_accounts để lấy danh sách các WABA mà doanh nghiệp bạn sở hữu. Đối với yêu cầu này, hãy sử dụng mã truy cập của người dùng hệ thống.

Cú pháp yêu cầu

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/owned_whatsapp_business_accounts

Yêu cầu mẫu

curl \
'https://graph.facebook.com/v21.0/805021500648488/owned_whatsapp_business_accounts/' \
-H 'Authorization: Bearer EAAJi...'

Phản hồi mẫu

{
  "data": [
    {
      "id": 1906385232743451, 
      "name": "My WhatsApp Business Account", 
      "currency": "USD", 
      "timezone_id": "1", 
      "message_template_namespace": "abcdefghijk_12lmnop" 
    },
    {
      "id": 1972385232742141, 
      "name": "My Regional Account", 
      "currency": "INR", 
      "timezone_id": "5", 
      "message_template_namespace": "12abcdefghijk_34lmnop" 
    },
  ],
  "paging": {
    "cursors": {
      "before": "abcdefghij",
      "after": "klmnopqr"
    }
  }
}

Lọc WABA theo thời gian tạo

Bạn có thể lọc tài khoản WhatsApp Business của khách hàng và của mình dựa trên thời gian tạo. Đố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.

Cú pháp yêu cầu

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/owned_whatsapp_business_accounts
  ?filtering=<FILTERING>

Giá trị filtering có thể là một mảng chứa một đối tượng duy nhất bao gồm các thuộc tính sau đây:

Các thuộc tính đối tượng lọc

Tên Mô tả

Tên	Mô tả
`field`	Chứa trường được dùng để lọc. Đặt thành `creation_time`.
`operator`	Chứa cách bạn muốn lọc tài khoản. Giá trị được hỗ trợ: `LESS_THAN` `GREATER_THAN`
`value`	Nhãn thời gian UNIX được dùng trong quá trình lọc.

field

Chứa trường được dùng để lọc. Đặt thành creation_time.

operator

Chứa cách bạn muốn lọc tài khoản. Giá trị được hỗ trợ:

LESS_THAN
GREATER_THAN

value

Nhãn thời gian UNIX được dùng trong quá trình lọc.

Đối tượng mẫu

[
  {
    "field" : "creation_time",
    "operator" : "GREATER_THAN",
    "value" : "1604962813"
  }
]

Yêu cầu mẫu

curl \
'https://graph.facebook.com/v21.0/805021500648488/owned_whatsapp_business_accounts' \
-H 'Authorization: Bearer EAAJi...' \
-H 'Content-Type: application/json' \
-d '[{"field":"creation_time","operator":"GREATER_THAN","value":"1604962813"}]'

Phản hồi mẫu

{
  "data": [
    {
      "id": “12312321312”,
      "name": "test",
      "currency": "USD",
      "timezone_id": "1",
      "message_template_namespace": "46fe_814"
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIUm9",
      "after": "QVFIUklX"
    },
    "next": "https://graph.facebook.com/v21.0/“
  }
}

Sắp xếp WABA theo thời gian tạo

Bạn có thể sắp xếp các Tài khoản WhatsApp Business dùng chung và sở hữu riêng dựa trên thời gian tạo.

Cú pháp yêu cầu

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/owned_whatsapp_business_accounts
  ?sort=<SORT>

Giá trị sort có thể là creation_time_ascending hoặc creation_time_descending.

Yêu cầu mẫu

curl \
'https://graph.facebook.com/v21.0/805021500648488/owned_whatsapp_business_accounts?sort=creation_time_ascending' \
-H 'Authorization: Bearer EAAJi...'

Phản hồi mẫu

{
  "data": [
    {
      "id": 1906385232743451,
      "name": "My WhatsApp Business Account",
      "currency": "USD",
      "timezone_id": "1",
      "message_template_namespace": "abcdefghijk_12lmnop"
    },
    {
      "id": 1972385232742141,
      "name": "My Regional Account",
      "currency": "INR",
      "timezone_id": "5",
      "message_template_namespace": "12abcdefghijk_34lmnop"
    },
  ],
  "paging": {
    "cursors": {
      "before": "abcdefghij"
      "after": "klmnopqr"
    }
  }
}

Truy xuất trạng thái xét duyệt WABA

Bạn có thể lấy trạng thái xét duyệt của Tài khoản WhatsApp Business bằng cách yêu cầu trường account_review_status.

Cú pháp yêu cầu

GET https://graph.facebook.com/<API_VERSION>/<WABA_ID>
  ?fields=account_review_status

Yêu cầu mẫu

curl \
'https://graph.facebook.com/v21.0/106526625562206?fields=account_review_status' \
-H 'Authorization: Bearer EAAJi...' \

Phản hồi mẫu

{
  "account_review_status": "APPROVED",
  "id": "1111111111111"
}

Thuộc tính account_review_status này có thể chứa một trong các giá trị sau: PENDING, APPROVED và REJECTED.

Xem thêm

API Quản lý WhatsApp Business
Tài liệu tham khảo: Doanh nghiệp
Tài liệu tham khảo: Tài khoản WhatsApp Business