Chúng tôi sẽ ngừng cung cấp API Tại chỗ. Hãy tham khảo tài liệu về việc Ngừng cung cấp API Tại chỗ để biết chi tiết, đồng thời tìm hiểu cách chuyển sang API Đám mây thế hệ tiếp theo của chúng tôi.
Gửi mẫu tin nhắn
Bạn có thể sử dụng điểm cuối /messages để gửi mẫu tin nhắn cho khách hàng của mình. Mẫu tin nhắn có thể dựa trên văn bản, file phương tiện hoặc mang tính tương tác.
Để tìm hiểu thêm về mẫu tin nhắn, hãy xem phần Tin nhắn, Tin nhắn do doanh nghiệp bắt đầu.
Trước khi bắt đầu
Đảm bảo rằng bạn đã hoàn tất những việc cần làm trong tài liệu Tin nhắn - Điều kiện tiên quyết.
Bước 1: Tạo mẫu bằng Trình quản lý WhatsApp
Để tạo mẫu tin nhắn, hãy truy cập vào Trình quản lý kinh doanh trên Facebook, chuyển đến Tài khoản WhatsApp của bạn rồi vào Trình quản lý WhatsApp. Chúng tôi sẽ xét duyệt mẫu tin nhắn của bạn để đảm bảo các mẫu này không vi phạm chính sách của WhatsApp. Sau khi chúng tôi phê duyệt, doanh nghiệp của bạn sẽ có vùng tên của riêng mình để lưu trữ các mẫu tin nhắn.
Khi tạo mẫu tin nhắn, bạn phải cung cấp những thông tin sau:
- Tên mẫu tin nhắn - Chỉ được chứa các ký tự chữ và số viết thường cũng như dấu gạch dưới ( _ ). Không được sử dụng khoảng trắng hoặc các ký tự khác.
- Thành phần của mẫu tin nhắn - Điền văn bản và/hoặc thành phần file phương tiện (bao gồm cả phần giữ chỗ của thông số) vào mẫu đó, nếu cần. Đảm bảo mẫu tin nhắn không chứa dòng mới, tab hoặc quá 4 chỗ trống liên tiếp, đồng thời đáp ứng giới hạn về độ dài như được yêu cầu trong Trình quản lý kinh doanh hoặc API Quản lý WhatsApp Business.
- Tất cả các bản dịch khác mà doanh nghiệp của bạn mong muốn.
Khi tạo mẫu tin nhắn, bạn có thể thêm mẫu ví dụ bằng cách nhấp vào nút Thêm mẫu. Nhờ đó, trong quá trình xem xét và phê duyệt, chúng tôi có thể hiểu được bạn định gửi loại tin nhắn nào. Hãy đảm bảo các mẫu tin nhắn đó chỉ là ví dụ và không chứa bất kỳ thông tin mật hay thông tin cá nhân nào.
Hãy xem bài viết Tạo mẫu tin nhắn cho tài khoản API WhatsApp Business để biết thông tin chi tiết hơn về các bước tạo mẫu tin nhắn.
Ví dụ
Khi tạo tin nhắn chào mừng thì tên mẫu tin nhắn sẽ là welcome, còn tin nhắn là
"Welcome {{1}}. We look forward to serving you on WhatsApp." Khi tạo tin nhắn xác nhận đơn đặt hàng thì tên mẫu tin nhắn sẽ là order_confirmation, còn tin nhắn là
"Your order {{1}} for a total of {{2}} is confirmed. The expected delivery is {{3}}." Bản dịch
WhatsApp không cung cấp bất kỳ bản dịch nào cho doanh nghiệp bạn. Bạn phải nhập tất cả các bản dịch mẫu tin nhắn theo đúng định dạng mô tả tại đây. Mọi bản dịch đều có tên thành phần giống nhau. Để biết thêm thông tin, hãy xem:
Bước 2: Gửi yêu cầu POST đến /messages
Sau khi có mẫu, bạn có thể gửi mẫu cho khách hàng của mình qua đối tượng template:
POST /v1/messages
{
"to": "recipient_wa_id",
"type": "template",
"template": {
"namespace": "your-namespace",
"name": "your-template-name",
"language": {
"code": "your-language-and-locale-code",
"policy": "deterministic"
},
"components": [{
"type": "body",
"parameters": [
{
"type": "text",
"text": "your-text-string"
},
{
"type": "currency",
"currency": {
"fallback_value": "$100.99",
"code": "USD",
"amount_1000": 100990
}
},
{
"type": "date_time",
"date_time" : {
"fallback_value": "February 25, 1977",
"day_of_week": 5,
"day_of_month": 25,
"year": 1977,
"month": 2,
"hour": 15,
"minute": 33
}
},
{
"type": "date_time",
"date_time" : {
"fallback_value": "February 25, 1977",
"timestamp": 1485470276
}
}
]
}]
}
}
Chỉ hỗ trợ các loại nút URL, QUICK_REPLY và PHONE_NUMBER.
Nếu mẫu chứa loại nút không có trong danh sách này, API sẽ trả về lỗi.
Thông số
- Các thông số cho mẫu tin nhắn: đối tượng
template, đối tượngcomponents, đối tượngparametersvà đối tượnglanguage.
Bước 3: Kiểm tra phản hồi API của bạn
Nếu thành công, hệ thống sẽ trả về một đối tượng messages chứa id.
{
"messages": [{
"id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
}]
}
Nếu không thành công, hệ thống sẽ trả về một phản hồi có chứa đối tượng lỗi bao gồm chuỗi lỗi, mã lỗi và các thông tin khác. Hãy xem phần Mã lỗi và mã trạng thái để biết thêm thông tin.
Giới hạn tin nhắn marketing mẫu cho mỗi người dùng
Kể từ ngày 06/02/2024, giới hạn tin nhắn marketing mẫu cho mỗi người dùng sẽ áp dụng cho các tin nhắn mẫu được gửi đến một số ít người dùng WhatsApp ở Ấn Độ, nhưng sẽ áp dụng cho tất cả người dùng WhatsApp có số điện thoại ở Ấn Độ muộn nhất vào ngày 13/02/2024.
Chúng tôi đang triển khai các phương pháp mới - bắt đầu với người tiêu dùng ở Ấn Độ - nhằm tạo ra trải nghiệm chất lượng cao cho người dùng và tăng tối đa mức độ tương tác với tin nhắn marketing mẫu. Những phương pháp này có thể bao gồm việc giới hạn số lượng tin nhắn marketing mẫu mà một người dùng nhận được từ doanh nghiệp bất kỳ trong khoảng thời gian cụ thể, bắt đầu với số lượng nhỏ cuộc trò chuyện có ít khả năng được đọc. Lưu ý rằng giới hạn được xác định dựa trên số lượng tin nhắn marketing mẫu mà người dùng đó đã nhận được từ doanh nghiệp bất kỳ, đồng thời không liên quan cụ thể đến doanh nghiệp của bạn.
Giới hạn này chỉ áp dụng cho những tin nhắn marketing mẫu thường mở ra cuộc trò chuyện marketing mới. Nếu đã tồn tại cuộc trò chuyện marketing giữa bạn và một người dùng WhatsApp, những tin nhắn marketing mẫu được gửi đến người dùng đó sẽ không bị ảnh hưởng.
Nếu người dùng cụ thể không nhận được một tin nhắn marketing mẫu do bị giới hạn, API Tại chỗ sẽ trả về mã lỗi 1026. Tuy nhiên, hãy lưu ý rằng mã lỗi này bao gồm nhiều vấn đề có thể dẫn đến tình trạng không gửi được tin nhắn. V�� lý do quyền riêng tư, chúng tôi sẽ không tiết lộ liệu trên thực tế tình trạng này có phải do giới hạn hay không. Hãy tham khảo Câu hỏi thường gặp "Tại sao tỷ lệ gửi của tôi không đạt 100%?" để biết thêm thông tin.
Nếu bạn nhận được một trong những mã lỗi ở trên và nghi ngờ là do giới hạn, hãy lập tức ngừng gửi lại tin nhắn mẫu vì bạn sẽ chỉ nhận được phản hồi lỗi khác khi làm như vậy. Thay vào đó, hãy thử lại với khoảng thời gian tăng dần cho đến khi gửi được tin nhắn, vì giới hạn có thể có hiệu lực trong những khoảng thời gian khác nhau.
Chúng tôi sẽ tiếp tục hoàn thiện phương pháp của mình, đồng thời trân trọng sự hợp tác của bạn trong quá trình chúng tôi đầu tư để WhatsApp trở thành trải nghiệm tốt nhất có thể cho doanh nghiệp cũng như khách hàng của bạn.