Hỗ trợ

Khắc phục sự cố

Chưa phân phối được tin nhắn

Sau đây là các trường hợp có thể khiến một tin nhắn hiện là đã gửi chứ không phải đã phân phối. Vì nhiều lý do dưới đây, chúng tôi sẽ không tiết lộ nguyên nhân gốc rễ dẫn đến lỗi vì lý do quyền riêng tư và chính sách.

  • Chúng tôi chỉ giữ tin nhắn cho khách hàng offline trong 30 ngày, nhưng khách hàng không online trong khoảng thời gian đó.
  • Khách hàng đã chặn số điện thoại của doanh nghiệp hoặc một số điện thoại khác của doanh nghiệp.

Trong một số trường hợp, API này sẽ trả về mã lỗi kèm theo thông báo lỗi mô tả bản chất của lỗi. Ví dụ về trường hợp:

  • Thông số yêu cầu không hợp lệ
  • Lỗi về tính toàn vẹn
  • Khách hàng chưa chấp nhận Điều khoản dịch vụ và Chính sách quyền riêng tư mới của chúng tôi. Vui lòng gửi cho người dùng cuối liên kết này https://wa.me/tos/20210210 để chấp nhận Điều khoản dịch vụ mới nhất.
  • Khách hàng đang dùng phiên bản WhatsApp cũ. Khách hàng phải sử dụng phiên bản dưới đây trở lên:
    • Android: 2.21.15.15
    • SMBA: 2.21.15.15
    • iOS: 2.21.170.4
    • SMBI: 2.21.170.4
    • KaiOS: 2.2130.10
    • Web: 2.2132.6
  • Khách hàng nằm trong nhóm thử nghiệm.
  • Hệ thống không gửi tin nhắn để tạo trải nghiệm chất lượng cao cho người dùng. Hãy xem phần Giới hạn tin nhắn marketing mẫu cho mỗi người dùng.

Giải pháp khả thi

Trong trường hợp sử dụng phương thức liên lạc khác ngoài WhatsApp, hãy yêu cầu người dùng WhatsApp:

  • xác nhận rằng người dùng thực sự có thể gửi tin nhắn đến (các) số điện thoại WhatsApp của doanh nghiệp bạn
  • xác nhận rằng không số điện thoại WhatsApp nào của doanh nghiệp bạn nằm trong danh sách số bị chặn (Cài đặt > Quyền riêng tư > Bị chặn hoặc Người liên hệ bị chặn)
  • xác nhận rằng người dùng đã chấp nhận Điều khoản dịch vụ mới nhất của chúng tôi (nếu chưa làm vậy, người dùng sẽ được nhắc chấp nhận điều khoản/chính sách mới nhất trong phần Cài đặt > Trợ giúp hoặc Cài đặt > Thông tin ứng dụng)
  • cập nhật ứng dụng WhatsApp lên phiên bản mới nhất

Hạn chế theo quốc gia

Các doanh nghiệp ở Cuba, Iran, Triều Tiên, Syria và 3 khu vực bị trừng phạt thuộc Ukraine (Crimea, Donetsk, Luhansk) không đủ điều kiện sử dụng Nền tảng WhatsApp Business.

Những người dùng ứng dụng WhatsApp Messenger (WhatsApp) và WhatsApp Business ở Cuba, Iran, Triều Tiên, Syria và 3 khu vực bị trừng phạt thuộc Ukraine (Crimea, Donetsk, Luhansk) không đủ điều kiện nhận tin nhắn được gửi qua Nền tảng WhatsApp Business.

Kể từ ngày 15/05/2024, Thổ Nhĩ Kỳ không còn bị hạn chế tính năng nhắn tin cho doanh nghiệp qua API Đám mây. Giờ đây, doanh nghiệp dùng API Đám mây có thể bắt đầu cuộc trò chuyện và nhận tin nhắn từ người dùng WhatsApp có số điện thoại ở Thổ Nhĩ Kỳ.

Webhooks

Trạng phái phân phối tin nhắn xung đột

Trong một số ít trường hợp, cùng một tin nhắn có thể kích hoạt cả hai webhook cập nhật trạng thái tin nhắn là thành công và không thành công. Ví dụ: một tin nhắn có thể kích hoạt webhook tin nhắn có "status":"delivered" và một webhook khác có "status":"failed". Trường hợp này có thể xảy ra khi khách hàng đăng nhập vào WhatsApp trên nhiều thiết bị và tin nhắn được phân phối thành công đến thiết bị này nhưng chưa đến thiết bị kia. Bất kỳ tin nhắn nào kích hoạt webhook trạng thái tin nhắn "delivered" đều đã được phân phối đến ít nhất một trong các thiết bị của người dùng.

Mã lỗi 2 - Dịch vụ API

Khi chúng tôi cập nhật API, bạn có thể gặp tình trạng dừng chạy đến 5 phút. Trong khoảng thời gian này, dịch vụ không khả dụng. Chúng tôi sẽ cố gắng cập nhật sao cho các doanh nghiệp ít bị gián đoạn nhất, nhưng bạn có thể bị ảnh hưởng

Cách gỡ lỗi

Bạn nên chờ 5 phút rồi thử gọi lại API.

Lỗi xác thực và ủy quyền

Bạn sẽ nhận được những lỗi này khi có vấn đề với mã truy cập mà bạn đang dùng để gọi API.

Cách gỡ lỗi

Bạn có thể dán trực tiếp mã truy cập mình đang dùng vào Trình gỡ lỗi mã truy cập. Sau đó, hãy kiểm tra xem bạn đã chọn quyền whatsapp_business_managementwhatsapp_business_messaging hay chưa.

Nếu mã của bạn không có quyền sử dụng những quyền này, bạn cần tạo mã mới. Trong khi tạo mã, hãy đảm bảo chọn:

  • Ứng dụng trên Meta mà bạn đang dùng để gọi API
  • Các quyền sau đây: whatsapp_business_managementwhatsapp_business_messaging

Câu hỏi thường gặp

Câu hỏi thường gặp chung

WhatsApp develops and operates the WhatsApp Business API, which enables businesses to communicate with WhatsApp consumer users on the WhatsApp network. When using the Cloud API, Meta will host the WhatsApp Business API for you and provide an endpoint for the WhatsApp service for your incoming and outgoing WhatsApp communications.

Access to Cloud API is free, and we expect it to generate additional cost savings for developers, as Meta hosts and maintains the Cloud API.

We want to make it clear what it means to message with a business on WhatsApp. Some businesses may choose to use Meta or another company to help them manage and store their messages. When a business chooses to manage their messages with another company, we will let consumers know by showing a different system message. Learn more.

Câu hỏi thường gặp về hoạt động triển khai kỹ thuật

The Cloud API architecture significantly simplifies the Solution Partner's operational and infrastructure requirements to integrate with WhatsApp Business Platform. First, it removes the infrastructure requirements to run Business API docker containers (CAPEX savings). Second, it obviates the need of operational responsibilities to manage the deployment (OPEX savings). For details, refer to the architecture diagram comparing the On-Premises and Cloud API deployments.

Solution Partners and direct clients do not need the WebApp and CoreApp containers that are used in the On-Premises API. Meta will manage all database data and media data on behalf of the Solution Partner or direct client.

As your on-premises performance depends heavily on your hardware, software, and connectivity to WhatsApp servers, if you wish to understand these differences, you can perform your own load tests on Cloud API as you might have done for your own on-premises installation. You can also refer to our performance comparison to understand more details around how the on-premise and Cloud APIs compare.

Migrating between the on-premises and Cloud APIs is seamless, and can be done bidirectionally. See migration details for more information.

Câu hỏi thường gặp về độ tin cậy

Trong một số trường hợp, hệ thống có thể tự động tính không chính xác các lỗi người dùng nhất định vào thời gian dừng chạy. Với những trường hợp này, chúng tôi sẽ ghi đè thời gian dừng chạy thành thời gian chạy sau khi phân tích chi tiết trong vòng một tuần.

Có thể đã xảy ra những vấn đề không ảnh hưởng đến độ sẵn sàng trên toàn cầu của chúng tôi. Trong những trường hợp này, Trang Trạng thái API WhatsApp Business sẽ có một trạng thái để cho biết có thể đã xảy ra một số tình trạng gián đoạn không ảnh hưởng đến độ sẵn sàng trên toàn cầu. Vui lòng gửi phiếu yêu cầu Hỗ trợ trực tiếp để điều tra thêm.

Thời gian dừng chạy xét về độ sẵn sàng không được tự động theo dõi trong các trường hợp sau:

  • Sự cố mạng khiến yêu cầu bị lỗi trước khi đến được lớp API Đồ thị (lớp đầu tiên).
  • Sự cố mạng khiến webhooks gửi đi không đến được điểm cuối webhook của doanh nghiệp.

Bất kỳ vấn đề nào xảy ra trước khi đến hệ thống của chúng tôi và sau thời điểm này đều sẽ hiển thị là lỗi hoặc không thành công. Ngoài ra, các vấn đề xảy ra sau lần gửi webhook đầu tiên sẽ tiếp tục được thử lại cho đến khi gửi thành công đến điểm cuối webhook.

Các trường hợp khác được phản ánh trong bảng điều khiển độ sẵn sàng sau quy trình phát hiện thủ công bao gồm (không phải lỗi hệ thống):

  • Các vấn đề xác thực trên Meta - như mã xác thực (thư viện bảo mật) - được xác định xem liệu đó có phải là yêu cầu hợp lệ bị lỗi xác thực/ủy quyền hay không.
  • Quá trình xác thực từ chối các yêu cầu hợp lệ.

Trong cả hai trường hợp, WhatsApp sẽ phát hiện và giải thích nguyên nhân gây ra những vấn đề nêu trên sau đó, gần như tức thì, nhưng không phải tức thì.

Chúng tôi hiện không cung cấp thỏa thuận cấp độ dịch vụ dành cho sản phẩm được bán ra thị trường đối với thời gian chạy và/hoặc độ trễ.

We will have disaster recovery and data replication across multiple regions. The expected downtime would be within our SLA and usually in the order of less than a minute to less than five minutes.