Bạn có thể sử dụng API Trang doanh nghiệp trên Google (GBP) để thêm hoặc cập nhật các thuộc tính URL của WhatsApp và tin nhắn văn bản cho một vị trí cụ thể.
Bằng cách triển khai các thuộc tính này, doanh nghiệp cho phép khách hàng liên hệ với họ bằng WhatsApp hoặc SMS. Điều này cho phép người bán mở các kênh giao tiếp trực tiếp với người dùng trên GBP, với mục tiêu cải thiện mức độ tương tác và hỗ trợ khách hàng.
Sau đây là hướng dẫn cách thêm, cập nhật hoặc xoá thuộc tính URL.
Điều kiện tiên quyết
Trước khi tiếp tục, hãy đảm bảo bạn có
- Tài khoản Trang doanh nghiệp trên Google và vị trí
- Thông tin xác thực uỷ quyền cần thiết để thay đổi vị trí trên Trang doanh nghiệp trên Google
Xác minh thành công
Để thêm, cập nhật hoặc xoá thuộc tính, bạn sẽ tạo các yêu cầu PATCH. Yêu cầu PATCH thành công sẽ trả về mã trạng thái là HTTP 200 OK.
Yêu cầu thêm hoặc cập nhật thuộc tính
Phương pháp này áp dụng cho cả WhatsApp và tính năng Nhắn tin.
Để thêm hoặc cập nhật một thuộc tính, hãy sử dụng yêu cầu PATCH HTTP được gửi đến điểm cuối API Trang doanh nghiệp trên Google cho location.updateattributes.
Chỉ định thuộc tính bạn đang nhắm đến bằng cách sử dụng tham số truy vấn attributeMask trong URL. Nội dung yêu cầu sẽ chứa dữ liệu thuộc tính đã cập nhật.
Đối với WhatsApp
Yêu cầu sẽ có dạng như sau.
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_whatsapp
Trong quá trình triển khai, hãy thay thế {locationId} bằng mã nhận dạng thực tế của vị trí Trang doanh nghiệp trên Google.
Nội dung yêu cầu (application/JSON) sẽ có dạng như sau.
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_whatsapp",
"values":[],
"uriValues": [
{
"uri": "https://wa.me/55555555"
}
]
}
]
}
Thay thế 55555555 mẫu bằng số điện thoại WhatsApp của doanh nghiệp theo định dạng quốc tế.
Đối với tính năng Nhắn tin
Yêu cầu sẽ như sau.
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_text_messaging
Trong quá trình triển khai, hãy thay thế {locationId} bằng mã nhận dạng thực tế của vị trí Trang doanh nghiệp trên Google.
Nội dung yêu cầu (application/JSON) sẽ có dạng như sau.
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_text_messaging",
"values":[],
"uriValues": [
{
"uri": "sms:5555555555"
}
]
}
]
}
Thay thế sms:5555555555 mẫu bằng số điện thoại doanh nghiệp để gửi tin nhắn văn bản.
Xóa thuộc tính
Bạn có thể xoá cả hai thuộc tính trong yêu cầu XOÁ bằng cách đưa attributes/url_whatsapp hoặc attributes/url_text_messaging vào tham số truy vấn attributeMask. Nội dung yêu cầu sẽ chứa một mảng các đối tượng thuộc tính, mỗi đối tượng cho một thuộc tính mà bạn muốn cập nhật hoặc xoá.
Yêu cầu sẽ có dạng như sau.
DELETE
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_whatsapp,attributes/url_text_messaging3
Trong quá trình triển khai, hãy thay thế {locationId} bằng mã nhận dạng thực tế của vị trí Trang doanh nghiệp trên Google.
Nội dung yêu cầu (application/JSON) sẽ có dạng như sau.
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_whatsapp",
"values":[],
"uriValues": []
}
]
}
Thay thế uriValues mẫu bằng các dấu ngoặc trống. Thao tác này sẽ đặt lại giá trị và xoá giá trị đó khỏi GBP.