Câu hỏi thường gặp về API Tại chỗ

WhatsApp xem hoạt động kết nối với người dùng API Business (những người quản lý điểm cuối API trên các máy chủ mà họ kiểm soát) là được mã hóa đầu cuối vì không có quyền truy cập của bên thứ ba vào nội dung giữa các điểm cuối.

Một số tổ chức có thể chọn ủy quyền quản lý điểm cuối API WhatsApp Business của họ cho Nhà cung cấp giải pháp kinh doanh bên thứ ba. Trong những trường hợp này, hoạt động kết nối vẫn sử dụng phương thức Mã hóa giao thức tín hiệu tương tự. Tuy nhiên, vì người dùng API WhatsApp Business đã ủy quyền cho bên thứ ba quản lý điểm cuối của họ nên WhatsApp xem những tin nhắn này là chưa được mã hóa đầu cuối. Trong tương lai, vào năm 2021, điều này cũng sẽ áp dụng cho những doanh nghiệp chọn sử dụng phiên bản dựa trên đám mây của API do Facebook lưu trữ.

Ngoài ra, nếu bạn dùng HTTPS khi thực hiện lệnh gọi tới ứng dụng API WhatsApp Business, dữ liệu đó sẽ được mã hóa SSL (từ ứng dụng phụ trợ tới ứng dụng API WhatsApp Business).

Xem tài liệu chuyên sâu về kỹ thuật Tổng quan về mã hóa trên WhatsApp của chúng tôi để biết thêm thông tin chi tiết.

Không, bạn có thể chạy một tài khoản cho mỗi phiên bản. Nếu bạn cần tài khoản thử nghiệm thứ hai, hãy nhớ dùng số khác cho phiên bản thứ hai đó.

KHÔNG! Tại thời điểm bất kỳ, bạn chỉ có thể chạy một phiên bản Ứng dụng API WhatsApp Business bằng một số điện thoại. Ngay khi bạn đăng ký phiên bản thứ hai, phiên bản đầu tiên của bạn sẽ khởi động và gặp lỗi. Chúng tôi đang nỗ lực tìm ra giải pháp phù hợp nhằm hỗ trợ bạn hoàn thành việc này. Chúng tôi sẽ cho thông báo cho bạn khi có thông tin cập nhật.

Ứng dụng API WhatsApp Business Tại chỗ yêu cầu có cơ sở dữ liệu để lưu trữ các khóa nhằm giải mã tin nhắn được gửi giữa doanh nghiệp và khách hàng. Mọi tin nhắn trên WhatsApp đều được mã hóa bằng khóa người gửi và khóa người nhận. Khóa khách hàng được lưu trữ trên thiết bị di động của khách hàng và khóa doanh nghiệp được lưu trữ trong cơ sở dữ liệu của doanh nghiệp. Hãy tìm hiểu thêm về Tính bảo mật của WhatsApp.

API WhatsApp Business Đám mây là giải pháp thay thế, trong đó Meta lưu trữ cơ sở dữ liệu của doanh nghiệp. Thông qua API Đám mây, bạn có thể triển khai các API WhatsApp Business mà không mất chi phí lưu trữ máy chủ của chính mình. Tìm hiểu thêm.

Không. Hiện không có cách nào để dùng nhiều số điện thoại bằng cùng một quy trình thiết lập ứng dụng API WhatsApp Business. Chúng tôi đang nỗ lực tìm ra giải pháp phù hợp để hỗ trợ điều này trong tương lai.

Yes, Whatsapp Flows can be sent with On-Premises API. You can learn more about Whatsapp Flows here, or learn how to get started with Whatsapp Flows and On-Premises API here.

Có! Theo mặc định, Ứng dụng API WhatsApp Business sẽ tìm cách giao tiếp bằng chatd qua cổng 5222. Để có trải nghiệm tốt nhất, hãy mở cổng 5222 cho tất cả lưu lượng truy cập đi. Điều này không gây ra vấn đề về bảo mật vì lưu lượng truy cập chỉ đi từ trung tâm dữ liệu của bạn.

Nếu bạn không thể mở cổng 5222, Ứng dụng API WhatsApp Business sẽ tìm cách sử dụng cổng 443. Nếu tường lửa hoặc proxy của bạn vẫn đang ngắt các kết nối, vui lòng liên hệ với đội ngũ WhatsApp bằng cách gửi câu hỏi thông qua kênh Hỗ trợ trực tiếp để gỡ lỗi.

Không. Ứng dụng API WhatsApp Business sẽ mở một kết nối TCP đi tới cổng 5222 hoặc 443 trên máy chủ WhatsApp. Lưu lượng truy cập TCP xuất hiện trên kết nối dài hạn này. Thông thường, tường lửa sẽ phân loại kết nối này là cho phép “lưu lượng truy cập đi và lưu lượng truy cập đã thiết lập”. Tất nhiên, các gói tin sẽ truyền đi truyền lại sau khi kết nối này được thiết lập. Tuy nhiên, điểm bắt đầu kết nối sẽ đến từ Ứng dụng API WhatsApp Business nên không cần quy tắc cho phép các kết nối đến.

Các yêu cầu sẽ phụ thuộc vào dung lượng tải và trường hợp của bạn. Giải pháp này sẽ hoạt động trên bất kỳ máy nào có kết nối Internet và chạy Docker. Ví dụ: bạn có thể thực hiện kiểm tra đơn giản trên máy tính xách tay.

Đối với việc thiết lập máy chủ chính thức chứa một phiên bản, tối thiểu bạn nên sử dụng ổ SSD 250 GB, RAM 16 GB và CPU 4 lõi. Không nên dùng ổ HDD vì tốc độ Đầu vào/Đầu ra sẽ bị giảm xuống mức tối thiểu trong quá trình tải.

Đối với việc thiết lập máy chủ chính thức Đa kết nối, tối thiểu bạn nên sử dụng ổ SSD 50 GB, RAM 4 GB và CPU 2 lõi cho từng vùng chứa Coreapp/Master/Webapp.

Trong hầu hết các trường hợp, bạn nên chạy cơ sở dữ liệu trên một máy chủ thực tách biệt với vùng chứa core và web. Máy chủ cơ sở dữ liệu chỉ được chậm hơn (các) máy tính vài mili giây.

Phương thức thiết lập này hỗ trợ gửi xấp xỉ 20 tin nhắn/giây.

Bạn cần có MySQL 5.7.x, PostgreSQL 9.5.x, 9.6.x, 10.x. Việc sử dụng một phiên bản trước sẽ gây ra lỗi Unable to initialize config store.

Hãy làm theo Hướng dẫn về MySQL Docker để thiết lập MySQL nội bộ bằng Docker.

Hãy làm theo Hướng dẫn về PostgreSQL Docker để thiết lập PostgreSQL nội bộ bằng Docker.

Trong hầu hết các trường hợp, bạn nên chạy cơ sở dữ liệu trên một máy chủ thực tách biệt với vùng chứa core và web. Máy chủ cơ sở dữ liệu chỉ được chậm hơn (các) máy tính vài mili giây.

Có thể tạo danh sách hợp lệ bằng tên máy chủ hoặc địa chỉ IP.

Hãy xem phần Tên máy chủ trong tài liệu Yêu cầu về mạng để biết thêm thông tin.

Có, kết nối TCP rất cần thiết. Bạn có thể sử dụng SSL đã kết thúc nếu doanh nghiệp của bạn không thể mở thêm cổng.

Hãy xem tài liệu Yêu cầu về mạng để biết thêm thông tin.

Không, chúng tôi không hỗ trợ KOPS. Chúng tôi hỗ trợ giải pháp AWS dựa trên ECS. Ngoài ra, chúng tôi còn cung cấp tài liệu hướng dẫn chung về cách thiết lập Kubernetes bằng minikube.

MySQL và PostgreSQL được hỗ trợ. Nếu tự chạy Docker, bạn phải cung cấp cơ sở dữ liệu MySQL/PostgreSQL cho các vùng chứa để kết nối. Nếu bạn dùng mẫu AWS, cơ sở dữ liệu MySQL sẽ được thiết lập theo mặc định.

Không. Hiện tại, ứng dụng API WhatsApp Business không chạy trên Docker cho Windows. Đối với các nhu cầu phát triển, bạn nên dùng máy ảo Linux và chạy Docker trong máy đó. Đối với các phần việc sản xuất, bạn nên dùng máy chủ Linux để tránh các vấn đề về hiệu quả và khả năng tương thích.

Để khởi động lại các vùng chứa Docker, bạn có thể chạy mã sau:

Vùng chứa Docker Coreapp

docker restart wacore<Current_WABA_Version>

Vùng chứa Docker Webapp

docker restart webapp<Current_WABA_Version>

Bạn có thể kiểm tra xem mình đang chạy phiên bản nào

docker ps

Có, tính năng xoay nhật ký dành cho vùng chứa webapp và vùng chứa coreapp có các hành vi khác nhau một chút:

• Webapp: 30 file nhật ký gần đây nhất sẽ được giữ lại. File nhật ký chỉ xoay khi kích thước lớn hơn 20 MB.
• Coreapp: 30 file nhật ký gần đây nhất sẽ được giữ lại. File nhật ký chỉ xoay khi kích thước lớn hơn 15 MB. Các file đã xoay sẽ được nén.

Bạn có thể kích hoạt từ bên ngoài một tập lệnh để xóa các nhật ký cũ của một vùng chứa:

docker exec CONTAINER_NAME /opt/whatsapp/bin/cleanup.sh

Tập lệnh này hoạt động với cả vùng chứa webapp lẫn coreapp. Bằng cách chạy tập lệnh này, các file nhật ký cũ sẽ bị gỡ để chỉ giữ lại 30 file nhật ký của vùng chứa.

Hệ thống của bạn có thể bắt đầu hoạt động chậm lại vì đầy dung lượng. Tình trạng này có thể do nhiều file phương tiện, tin nhắn và file nhật ký lớn. Các file nhật ký tự động được xoay, nhưng nếu chúng bắt đầu lớn lên thì bạn nên xóa.

Tin nhắn được lưu trữ trong cơ sở dữ liệu. Bạn có thể xóa tin nhắn khi cần. Ngoài ra, nếu pass_through được đặt thành false trong phần cài đặt ứng dụng thì tất cả tin nhắn đều được lưu vào cơ sở dữ liệu cho đến khi bị xóa hoàn toàn.

Các file phương tiện mà người dùng gửi cho bạn được tải xuống ổ đĩa phương tiện. Doanh nghiệp có quyền quyết định sẽ xóa file phương tiện nào, nhưng thông thường, cách an toàn là xóa mọi file phương tiện. Bạn có thể sử dụng docker inspect your-container-id để kiểm tra vị trí của thư mục ổ đĩa phương tiện.

Có, bạn có thể dùng cơ sở dữ liệu theo những cách khác mà không ảnh hưởng đến các bảng liên quan đến WhatsApp.

Bảng cơ sở dữ liệu lưu trữ thông tin liên quan đến tùy chọn cài đặt ứng dụng, đoạn chat, tin nhắn, file phương tiện, v.v. do ứng dụng yêu cầu để hoạt động.

v2.25.x cải thiện hiệu quả kết nối đến và đi so với các bản phát hành trước. Tùy chọn tối ưu hóa này dựa trên việc tạo thêm lượt kết nối cơ sở dữ liệu. Đối với một số hoạt động triển khai, điều này có thể khiến số lượt kết nối cơ sở dữ liệu tăng lên và đạt đến giới hạn đã định cấu hình. Để hiệu quả luôn tăng, bạn có thể tăng số lượt kết nối tối đa mà máy chủ cơ sở dữ liệu của bạn có thể chấp nhận. Nếu không thể, bạn có thể thay đổi thông số axolotl_context_striping_disabled để tắt tùy chọn này. Hãy xem tài liệu về Cài đặt ứng dụng để biết thêm thông tin về cách thực hiện sự thay đổi này.

Theo định kỳ, công cụ dọn dẹp cơ sở dữ liệu sẽ dọn dẹp các bảng messages và messages_reciept_log để giúp quản lý cơ sở dữ liệu.

Công cụ dọn dẹp giữ lại một số tin nhắn để cho phép xử lý/gửi thành công. Ví dụ: giữ lại những tin nhắn đến trong một khoảng thời gian nhất định để cho phép các tiện ích tích hợp cho doanh nghiệp đánh dấu tin nhắn là đã đọc.

Coreapp tiến hành dọn dẹp theo tần suất ngẫu nhiên (ví dụ: vài giờ một lần). Điều này là để ngăn tình trạng suy giảm hiệu suất tiềm ẩn trong ngăn xếp Sẵn sàng cao do xung đột cơ sở dữ liệu.

Hoạt động dọn dẹp không phụ thuộc vào hàng đợi lệnh gọi lại. Ví dụ: nếu máy chủ Webhook không hoạt động trong 4 ngày, các lệnh gọi lại sẽ được lưu trữ để gửi đi khi kết nối máy chủ Webhook được khôi phục.

Sử dụng điểm cuối API services dọn dẹp cơ sở dữ liệu để xóa hoàn toàn các tin nhắn và biên lai tin nhắn tương ứng trong bảng messageStore.messages và messageStore.messages_receipt_log.

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.

Thao tác đăng xuất người dùng qua điểm cuối users sẽ vô hiệu hóa tất cả các mã xác thực được chỉ định cho tài khoản đó. Thao tác xóa người dùng cũng có tác dụng tương tự như vậy, mặc dù rõ rệt hơn rất nhiều. Lưu ý rằng thao tác đăng nhập người dùng qua điểm cuối users sẽ trả về mã xác thực mới, nhưng sẽ không vô hiệu hóa các mã xác thực đã lưu hành cho người dùng đó. Bất cứ ai sở hữu mã đã cung cấp trước đây đều sẽ tiếp tục sử dụng được mã đó cho đến khi mã hết hạn hoặc bị vô hiệu hóa bằng một trong những phương thức đề cập ở trên.

Lưu ý: Vui lòng không gửi cùng một tin nhắn nhiều lần cho cùng một người nhận bằng API WhatsApp Business.

Có thể có nhiều lý do khiến tỷ lệ gửi không đạt 100%. Một số trường hợp thường gặp bao gồm người dùng có quyền truy cập không thường xuyên vào mạng, không hoạt động trong một khoảng thời gian hoặc để tạo trải nghiệm chất lượng cao cho người dùng.

Tin nhắn có thể gửi được bằng WhatsApp sẽ có tỷ lệ gửi rất cao. Tuy nhiên, có nhiều lý do khiến hệ thống có thể không gửi được tin nhắn. Bạn sẽ có quyền truy cập vào trạng thái chính xác của tin nhắn bằng cách giám sát lệnh gọi lại. Điều này khác với việc gửi tin nhắn bằng SMS, chẳng hạn trong trường hợp bạn không có quyền truy cập vào trạng thái gửi cuối cùng và việc gửi lại tin nhắn có thể thực sự mang lại kết quả khác.

Tin nhắn có thể vẫn chưa gửi được vì điện thoại của người dùng không hoạt động hoặc hết pin hay người dùng bị mất điện thoại rồi có điện thoại mới và đã vô hiệu hóa SIM. Có thể xảy ra lỗi liên quan đến khả năng kết nối mạng của ứng dụng kinh doanh. Cũng có thể lệnh gọi lại (Webhooks) hiện không được gửi. Bạn có thể dùng nút health để giám sát những tình huống này. Bạn có thể bật lệnh gọi lại cho hoạt động nhận trên máy chủ để biết rằng tin nhắn đã đến đám mây trên máy chủ WhatsApp.

Nếu và khi một người dùng kết nối lại với mạng, người dùng đó sẽ nhận được tất cả tin nhắn bạn đã gửi. Việc nhận nhiều tin nhắn có cùng nội dung sẽ để lại trải nghiệm không tốt cho người dùng. Có nhiều khả năng người dùng sẽ chặn bạn hoặc phàn nàn. Có nhiều khả năng bạn sẽ bị cấm.

Nếu gửi một tin nhắn và nhận được ID tin nhắn từ API thì bạn không cần phải làm gì nữa để gửi tin nhắn này. Đừng gửi lại cùng một nội dung cho cùng một người nhận.

Nếu bạn nhận thấy tỷ lệ gửi thấp trong một khoảng thời gian dài, vui lòng gửi phiếu hỗ trợ qua kênh Hỗ trợ trực tiếp.

Khi gửi một tin nhắn, ngay khi bạn nhận lại ID tin nhắn thì nghĩa là yêu cầu tin nhắn đã được lưu trữ trong cơ sở dữ liệu. Ứng dụng API WhatsApp Business sẽ không ngừng tìm cách gửi tin nhắn đó cho đến khi được máy chủ WhatsApp công nhận. Quá trình này không có thời điểm kết thúc. Sau đó, máy chủ WhatsApp sẽ tìm cách gửi tin nhắn đó đến điện thoại của người dùng. Nếu điện thoại của người dùng không có kết nối mạng, tin nhắn sẽ được lưu trữ trong 30 ngày trước khi bị máy chủ WhatsApp xóa bỏ.

Hiện tại, không có cách nào để xem số người dùng hoặc người dùng nào đã chặn doanh nghiệp của bạn. Dấu hiệu tốt nhất là nghe lệnh gọi lại trạng thái và nếu bạn không nhận được trạng thái delivered thì nghĩa là người dùng đã chặn doanh nghiệp của bạn hoặc họ không có kết nối mạng. Hãy xem tài liệu Webhook để biết thêm chi tiết.

Nếu một người dùng đã chặn doanh nghiệp của bạn, API Danh bạ sẽ tiếp tục trả về số điện thoại đó dưới dạng người dùng WhatsApp hợp lệ. Tuy nhiên, khi bạn gửi tin nhắn, người dùng đó sẽ không bao giờ nhận được tin nhắn. Nếu đó là tin nhắn trả phí thì bạn sẽ không bị tính phí.

Trong tình huống sử dụng bình thường, điều này là do thiết kế khi người gửi không có trong sổ địa chỉ của bạn và trước đây bạn chưa gửi tin nhắn cho người gửi này. Trong tình huống của doanh nghiệp, doanh nghiệp nên sử dụng Mẫu tin nhắn khi lần đầu tương tác với người dùng để tạo dựng "lòng tin"; khi làm như vậy, Ứng dụng API WhatsApp Business sẽ tuân theo tùy chọn cài đặt tự động tải xuống.

Trong tình huống sử dụng bình thường, điều này là do thiết kế khi người gửi không có trong sổ địa chỉ của bạn và trước đây bạn chưa gửi tin nhắn cho người gửi này. Trong tình huống của doanh nghiệp, doanh nghiệp nên sử dụng Mẫu tin nhắn khi lần đầu tương tác với người dùng để tạo dựng "lòng tin"; khi làm như vậy, ứng dụng API WhatsApp Business sẽ có thể hiển thị liên kết và khiến người dùng có thể nhấp vào liên kết đó.

Tất nhiên là có! Hãy liên hệ với đại diện WhatsApp và đưa ra yêu cầu này.

Không, thứ tự tin nhắn đến nơi không được đảm bảo đúng như thứ tự tin nhắn đã gửi. Nếu thứ tự là yếu tố quan trọng trong trường hợp sử dụng của bạn, bạn nên nghe lệnh gọi lại đã gửi tin nhắn cho tin nhắn đầu tiên trước khi gửi tin nhắn thứ hai.

Khi sử dụng nút messages, bạn cần đặt tiêu đề Content-Type thành application/json để ứng dụng API WhatsApp Business phân tích chính xác nội dung tin nhắn. Bạn cũng cần đặt tiêu đề Authorization và tiêu đề này phải chứa một mã truy cập chưa hết hạn. Hãy xem tài liệu Đăng nhập và xác thực để biết thông tin về cách lấy mã và thời điểm mã hết hạn.

Có, hãy gửi lệnh gọi API tới nút contacts trước khi gửi tin nhắn. Thông tin khi kiểm tra contacts sẽ được lưu vào bộ nhớ đệm trong vùng chứa. Nếu không làm vậy, lỗi Unkown Contact có thể xảy ra. Hãy xem tài liệu Kiểm tra danh bạ để biết thêm thông tin.

If there is a delay in a subset of numbers, then it is likely not an issue affecting the customers integration but rather an issue on the recipients end, these delays in delivery can happen for a number of reasons. See Send Message Performance, Delays for more information.

No this is not possible. Numbers that are registered under WABAs (WhatsApp Business Accounts) can only message regular WhatsApp accounts.

Không có cơ chế xóa đối với file phương tiện đến hoặc đi. Bạn có thể tìm file phương tiện trên hệ thống file để xóa theo cách thủ công.

Để tìm điểm gắn kết của ổ đĩa phương tiện, bạn có thể chạy lệnh docker.

Yêu cầu

docker volume inspect whatsappMedia

Phản hồi

[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data",
        "Name": "whatsappMedia",
        "Options": {},
        "Scope": "local"
    }
]

Sau đó, để xem tất cả các file phương tiện đến, bạn có thể chạy lệnh ls với đường dẫn file Mountpoint nhận được:

ls /var/lib/docker/volumes/whatsappMedia/_data/

Đối với quá trình thiết lập AWS, ổ đĩa phương tiện được gắn vào đường dẫn /mnt/wa/media trên máy chủ.

Kích thước tải lên file tối đa là 64 MB, nghĩa là giới hạn này cũng áp dụng cho bất kỳ hình ảnh, tài liệu hoặc video nào mà bạn gửi kèm tin nhắn.

Bạn có quyền quyết định thời điểm xóa file phương tiện.

Sau khi tải file phương tiện lên, bạn sẽ nhận được ID file phương tiện. Bạn có thể dùng ID này để gửi tin nhắn bao gồm thành phần file phương tiện đã được tải lên. Sau khi gửi tin nhắn phương tiện, API WhatsApp Business sẽ mã hóa và tải file phương tiện lên máy chủ WhatsApp. Tại đây, file sẽ được lưu giữ trong 14 ngày. Sau đó, bạn có thể quyết định xóa file phương tiện bằng cách cung cấp ID file phương tiện hoặc giữ lại để sử dụng sau này. Mặc dù nên giữ file phương tiện trong 30 ngày, nhưng bạn có quyền quyết định chính sách lưu giữ theo chính sách hoặc trường hợp sử dụng của doanh nghiệp mình.

Đối với hình ảnh, chú thích sẽ được thêm dưới dạng nội dung mô tả. Văn bản chú thích cho hình ảnh hiển thị ở độ dài đầy đủ trên cả Android lẫn iPhone.

Đối với tài liệu, chú thích sẽ thay thế tên file. Điều này không có nghĩa là chú thích hiển thị trên thiết bị của người dùng dưới dạng văn bản mô tả, mà thay vào đó là hiển thị tên của file. iPhone hiển thị văn bản đầy đủ trong khi Android cắt bớt tên file; đây là giới hạn kỹ thuật của quá trình triển khai WhatsApp trên cả hai thiết bị vào thời điểm hiện tại.

Khi gửi hình ảnh dưới dạng album từ API WhatsApp Business, bạn cần gửi tối thiểu 4 hình ảnh liên tiếp. Nếu chế độ xem cuộc trò chuyện của người dùng đang hoạt động khi họ nhận được hình ảnh, bạn sẽ không dùng được chế độ xem album cho tới lần truy cập tiếp theo.

Bạn sẽ không tạo được album trong bất kỳ trường hợp nào sau đây:

1. Hình ảnh có chú thích
2. Công cụ phân chia tin nhắn chưa đọc - người dùng sẽ nhìn thấy một số hình ảnh nhưng không nhìn thấy phần còn lại
3. Tiêu đề ngày - ngày mới giữa những lần gửi

Không, hiện tại chúng tôi phải sử dụng AWS EFS để chia sẻ phần dữ liệu file phương tiện giữa Coreapp và Webapp.

Không, hiện tại chúng tôi không hỗ trợ thay đổi đường dẫn mặc định đến bộ nhớ file phương tiện (/usr/local/wamedia/). Tất cả bộ nhớ file phương tiện cần phải ở vị trí mặc định này thì mới có thể hoạt động bình thường.

Hiện tại là 7 ngày. Nếu không được cập nhật trong hơn 7 ngày, bộ nhớ đệm sẽ kéo gói ngôn ngữ mới nhất từ máy chủ, bất kể thành phần đã tồn tại trong gói hay chưa.

Lưu ý: kể từ v2.27.8, chúng tôi sẽ ngừng sử dụng chính sách ngôn ngữ fallback và deterministic giờ sẽ là chính sách ngôn ngữ mặc định.

Nếu tạo bản dịch ở ngôn ngữ mới, bạn cần dịch tất cả các thành phần mà bạn dùng sang ngôn ngữ đó. Nếu không, bạn có thể gặp lỗi "không có cấu trúc" vì điện thoại của người nhận không thể tìm thấy thành phần mong muốn bằng ngôn ngữ dùng trên điện thoại. Bạn gặp phải lỗi cấu trúc không mong muốn này khi gửi mẫu tin nhắn bằng chính sách dự phòng.

Nếu không tạo được bản dịch ngôn ngữ tại thời điểm này, bạn có thể dùng chính sách xác định để tránh những lỗi này.

Ứng dụng API WhatsApp Business gửi lệnh gọi lại Webhook cho bạn qua vùng chứa Coreapp. Do đó, bạn cần cấu hình điểm cuối Webhook để chấp nhận các yêu cầu đến từ Coreapp.

Nếu Webhook không gửi được lệnh gọi lại, lệnh gọi lại này sẽ được đưa vào hàng đợi thử lại. Hệ thống sẽ không nhận được bất kỳ lệnh gọi lại nào đã gửi sau sự cố lệnh gọi lại ban đầu. Bạn chỉ có thể gửi các lệnh gọi lại khác sau khi gửi được lệnh gọi lại không thành công ban đầu.

Nếu một sự kiện Webhook không gửi được vì bất kỳ lý do gì (ví dụ: ứng dụng không có kết nối mạng) hoặc nếu yêu cầu Webhook trả về mã trạng thái HTTP không phải là 200, chúng tôi sẽ thử gửi lại webhook. Chúng tôi sẽ tiếp tục thử gửi lại với thời gian trễ tăng dần tới một khoảng thời gian chờ nhất định (thường là 24 giờ, mặc dù khoảng thời gian này có thể thay đổi) hoặc cho đến khi gửi thành công.

Hệ thống có thể gửi tin nhắn trùng lặp tới WhatsApp Webhook với điều kiện duy nhất là người nhận sẽ nhận được tin nhắn đó tối thiểu một lần (trái ngược với trường hợp chỉ đúng một lần). Nếu điều này ảnh hưởng đến cách bạn xử lý tin nhắn thì bạn nên loại bỏ trùng lặp các tin nhắn Webhook dựa trên ID tin nhắn.

Hãy kiểm tra kỹ tùy chọn cài đặt ứng dụng pass_through của bạn. Bạn sẽ không nhận được bất kỳ lệnh gọi lại trạng thái đã đọc nào nếu đã bật pass_through cho ứng dụng API WhatsApp Business v2.29.1 trở lên.

Nếu muốn nhận được lệnh gọi lại trạng thái đã đọc, hãy tắt tùy chọn cài đặt ứng dụng pass_through. Lưu ý rằng khi tắt pass_through, dung lượng cơ sở dữ liệu có thể tăng lên nhanh chóng. Để biết thêm thông tin về cách quản lý cơ sở dữ liệu, hãy xem tài liệu về Quản lý cơ sở dữ liệu.

Đó là do lỗi trong phiên bản cũ của ứng dụng iOS. Chúng tôi mong muốn các lỗi này sẽ giảm đi theo thời gian khi mọi người nâng cấp.

Trước hết, hãy kiểm tra lệnh gọi lại để xem các lỗi nghiêm trọng nhằm chẩn đoán sự cố.

Nếu gặp phải lỗi "Xung đột: Đã phát hiện thấy nhiều phiên bản sử dụng cùng một số" thì bạn cần kiểm tra các vùng chứa. Khả năng lớn nhất là do bạn có nhiều vùng chứa Docker đang tìm cách kết nối với máy chủ WhatsApp bằng cùng một tài khoản WhatsApp. Hãy đảm bảo bạn chỉ có một vùng chứa đang hoạt động. Nếu bạn có các vùng chứa cũ, hãy tắt chúng và lỗi sẽ biến mất.

Nếu bạn muốn thử nghiệm giải pháp phức tạp hơn, luôn sẵn sàng hoạt động của chúng tôi, hãy xem tài liệu Độ sẵn sàng cao.

Đây là một sự cố đã biết. Đôi khi, việc nâng cấp Ứng dụng API WhatsApp Business bằng tập lệnh CloudFormation cũng yêu cầu cập nhật lên ngăn xếp DB RDS. Ngăn xếp RDS mới sẽ không có cùng tên máy chủ như ngăn xếp ban đầu và vùng chứa Docker không thể kết nối với cơ sở dữ liệu. Giải pháp là đưa SSH vào phiên bản EC2 do CloudFormation tạo và cập nhật file whatsapp.conf bằng tên máy chủ mới, sau đó khởi động lại các vùng chứa Docker để chúng chọn các tùy chọn cài đặt mới.

Lỗi này xuất hiện khi cơ sở dữ liệu chưa được thiết lập đúng cách.

• Hãy đảm bảo bạn đang dùng MySQL 5.7 trở lên hoặc PostgreSQL 9.5.x, 9.6.x, 10.x.
• Mật khẩu cơ sở dữ liệu không được chứa bất kỳ ký tự nào sau đây: ?{}&~!()^.
• Nếu bạn đang dùng AWS, hãy đảm bảo ngăn xếp của bạn có tên ngắn. Hãy xem tài liệu Cài đặt để biết thêm thông tin.

Lỗi này xảy ra khi cầu Docker bị hỏng. Cách xử lý tốt nhất cho lỗi này là dừng dịch vụ Docker và khởi động lại dịch vụ. Bạn cũng có thể dùng thử docker restart trên vùng chứa.

Lỗi "kết nối bị từ chối" nhiều khả năng có nghĩa là Coreapp hiện không chạy. Hãy dùng docker ps để xem Coreapp có đang hoạt động hay không. Nếu Coreapp không hoạt động, hãy xem nhật ký Docker. Coreapp có thể không kết nối được với cơ sở dữ liệu. Hãy đảm bảo thiết lập cơ sở dữ liệu đúng cách.

Có nhiều lý do cho điều này. Coreapp của bạn có thể ngừng hoạt động hoặc cơ sở dữ liệu chưa được thiết lập đúng cách. Nếu bạn không gặp phải những trường hợp này, vui lòng xem nhật ký Coreapp (hoặc nhật ký Coreapp chính nếu bạn đang chạy chế độ đa kết nối). Nếu bạn gặp phải lỗi kết nối cơ sở dữ liệu thì có khả năng cơ sở dữ liệu của bạn đã hết kết nối. Hãy xem tài liệu MySQL hoặc tài liệu PostgreSQL về lỗi này.

Bạn nên tăng số lượng kết nối cơ sở dữ liệu trên cơ sở dữ liệu của mình. Số lượng an toàn sẽ là 1000 kết nối cơ sở dữ liệu. Tuy nhiên, vui lòng đưa ra quyết định sáng suốt của riêng mình về số lượng kết nối. Nếu lỗi này vẫn tiếp diễn, vui lòng mở một phiếu hỗ trợ.

Nếu bạn gặp phải lỗi này nhưng thông số bắt buộc bị thiếu (mà lỗi đề cập đến) đã được đặt trong phần nội dung ở định dạng json thì đó có thể là lỗi phân tích cú pháp json. Lỗi này có thể xuất hiện khi không thể phân tích cú pháp toàn bộ phần tải dữ liệu ở định dạng json do lỗi định dạng json. Hãy kiểm tra giá trị của những thông số này để tìm các ký tự json không hợp lệ, chẳng hạn như ký tự xuống dòng ở cuối. Đôi khi, các thông số có thể bị sao chép thừa khoảng trắng, từ đó có thể có các ký tự phá vỡ định dạng json.

Lỗi không có cấu trúc xảy ra khi điện thoại không thể đọc tin nhắn mẫu.

Mẫu được lưu trữ trên máy chủ. Khi một tin nhắn mẫu được gửi thông qua nút messages, chỉ có vùng tên, ngôn ngữ, tên thành phần và các thông số đã bản địa hóa mới được gửi đến điện thoại chứ không phải toàn bộ tin nhắn. Sau khi nhận được những giá trị này, điện thoại sẽ cố gắng hiển thị tin nhắn đó.

Nếu có lỗi xảy ra trong quá trình hiển thị, lỗi structure unavailable (không có cấu trúc) sẽ được gửi đến URL gọi lại có chứa ID người nhận và ID tin nhắn. Những lỗi này có thể xảy ra do vùng tên sai, thông số đã bản địa hóa không khớp, tên thành phần sai, v.v.

Bạn có thể chuyển đến Trình quản lý WhatsApp trong Trình quản lý kinh doanh trên Facebook để xem số lượng thông số chính xác. Hãy kiểm tra cẩn thận để chắc chắn rằng vùng tên chính xác và tên thành phần có tồn tại.

Một nguyên nhân phổ biến gây ra lỗi là không tạo bản dịch cho tất cả các mẫu đang sử dụng. Ví dụ: nếu bạn thường gửi 2 mẫu nhưng chỉ thêm bản dịch ngôn ngữ mới cho một mẫu, hãy nhớ thêm cả bản dịch ngôn ngữ mới đó cho mẫu còn lại. Nếu định hỗ trợ nhiều ngôn ngữ thì bạn cần cung cấp bản dịch cho tất cả các mẫu ở mọi ngôn ngữ được hỗ trợ.

Tin vui là lỗi structure unavailable (không có cấu trúc) thường xảy ra do sai sót trong lệnh gọi API đến nút messages và có thể khắc phục được bằng cách thay đổi phần tải dữ liệu gửi.

Trước hết, bạn cần kiểm tra xem người liên hệ có tồn tại hay không rồi mới gửi tin nhắn. Hãy xem tài liệu về Người liên hệ để biết thêm thông tin về cách thực hiện việc này.

Lỗi này là do Coreapp chưa được khởi tạo. Điều đó nghĩa là chưa thực hiện đăng ký thành công. Vui lòng thử đăng ký trước khi thực hiện lệnh gọi tới một điểm cuối khác. Bước đầu tiên sau khi cài đặt API WhatsApp Business là đăng nhập. Bước thứ hai là đăng ký. Hai bước này là cần thiết trước khi đưa ra yêu cầu cho bất kỳ điểm cuối nào khác.

Tất cả các bản dựng của Ứng dụng API WhatsApp Business đều hết hạn sau 6 tháng kể từ ngày phát hành. Nếu bạn gặp lỗi này, hãy nâng cấp lên phiên bản phát hành mới nhất ngay khi có thể.

WhatsApp chạy các thử nghiệm để đo lường và tìm hiểu tác động của thông báo từ API WhatsApp Business đối với trải nghiệm của người dùng và toàn bộ sản phẩm nói chung. Nếu người dùng mà bạn đang nhắn tin thuộc một trong những thử nghiệm này thì họ có thể không nhận được thông báo từ bạn, ngay cả khi họ đã chọn nhận thông báo.

Nếu bạn gặp lỗi tương tự như sau khi thiết lập phương thức triển khai AWS, hãy thử thay đổi thành tên ngăn xếp có tối đa 8 ký tự.

Tên quốc gia (mã gồm 2 chữ cái) [AU]:Tên tiểu bang hoặc tỉnh (tên đầy đủ) [Tiểu bang nào đó]:Tên địa phương (ví dụ: thành phố) []:Tên tổ chức (ví dụ: công ty) [Internet Widgits Pty Ltd]:Tên đơn vị tổ chức (ví dụ: bộ phận) []:Tên phổ biến (ví dụ: FQDN máy chủ hoặc tên CỦA BẠN) []:chuỗi quá dài, độ dài cần ít hơn 64 byte Tên phổ biến (ví dụ: FQDN máy chủ hoặc tên CỦA BẠN) []:Địa chỉ email []:lỗi, không có đối tượng nào được chỉ định trong sự cố file cấu hình tạo ra khóa thiết bị do Yêu cầu chứng chỉ tạo cho internal-wa-inc-name-LB-123456789.ap-southeast-1.elb.amazonaws.com

Đối tượng profile trống sẽ được trả về nếu Trang kinh doanh chỉ điền một phần. Vui lòng nâng cấp lên v2.21.4 để khắc phục sự cố này.

Hãy xem tài liệu về Cài đặt trang kinh doanh để biết thêm thông tin về cách hoàn tất trang kinh doanh.

Mã lỗi 471 liên quan đến giới hạn tốc độ dựa trên chất lượng. Hãy xem tài liệu về Giới hạn tốc độ dựa trên chất lượng để biết thêm thông tin.

Sau đây là các lỗi xác thực khi gửi mẫu tin nhắn và lý do bạn có thể gặp phải lỗi:

• "Không có mẫu tin nhắn nào tồn tại ở ngôn ngữ ngôn ngữ của bạn" hoặc "Không có mẫu tin nhắn nào tồn tại ở ngôn ngữ ngôn ngữ của bạn và tiếng tiếng của bạn" - Gói ngôn ngữ đưa ra không tồn tại. Kiểm tra tài khoản Trình quản lý kinh doanh của bạn.
• "Mẫu tên mẫu của bạn không tồn tại ở ngôn ngữ ngôn ngữ của bạn" hoặc "Mẫu tên mẫu của bạn không tồn tại ở ngôn ngữ ngôn ngữ của bạn và tiếng tiếng của bạn" - Bạn đang cố sử dụng một mẫu không tồn tại (chưa được tạo hoặc chưa được phê duyệt). Nếu cố gửi tin nhắn bằng một mẫu đã bị xóa, bạn cũng sẽ gặp lỗi này.
• "Số lượng thông số có thể bản địa hóa num1 không khớp với số lượng thông số mong muốn num2" - Bạn đang cố gửi một mẫu tin nhắn có các thông số không khớp với số lượng thông số mong muốn. Vui lòng kiểm tra lệnh gọi API để khắc phục.
• "your-template-name là một mẫu đa dạng thức và cần phải sử dụng API Mẫu tin nhắn" - Bạn đang cố gắng gửi một mẫu tin nhắn chứa file phương tiện ở dạng mẫu tin nhắn thông thường. Đảm bảo loại tin nhắn là template. Hãy xem tài liệu về Mẫu tin nhắn chứa file phương tiện để biết thêm thông tin.
• Sau khi mẫu được phê duyệt trong Trình quản lý kinh doanh (hoặc bị xóa), có thể mất tới 20 phút để ứng dụng API WhatsApp Business nhận được mẫu cập nhật. Nếu đang cố gửi tin nhắn bằng mẫu vừa mới được phê duyệt và nhận được lỗi cho biết mẫu này không tồn tại, bạn có thể thử gửi lại tin nhắn sau khi chờ một khoảng thời gian đã chỉ định ở trên.

Đối với ứng dụng API WhatsApp Business đang chạy phiên bản 2.21.6, khi bị ngắt kết nối khỏi máy chủ, ứng dụng có thể vẫn ngắt kết nối trong vài phút (tối đa là 4 phút), sau đó sẽ thử kết nối lại. Nếu nâng cấp lên phiên bản 2.23.4, ứng dụng sẽ ngừng hoạt động trong thời gian ngắn hơn khi cố gắng kết nối với máy chủ.

Trước v2.29.x, kích thước hàng đợi tin nhắn đi có thể tăng theo thời gian do lỗi. Hãy nâng cấp lên v2.29.3 để khắc phục sự cố này.

Coreapp sẽ kiểm tra các thư mục /usr/local/waent/data và /usr/local/waent/log trong vùng chứa Coreapp để đảm bảo dung lượng lưu trữ tối thiểu là 10 MB, nếu không sẽ xảy ra lỗi nghiêm trọng này.

Hãy kiểm tra nhật ký và thư mục dữ liệu của bạn để đảm bảo có đủ dung lượng.

Hiện tại, không có cách nào để làm việc này. Nếu không có khả năng xử lý phản hồi đến từ người dùng trên WhatsApp, bạn nên gửi tin nhắn trả lời tự động để chuyển hướng họ đến các kênh hỗ trợ phù hợp của bạn.

Bạn nên đăng ký số điện thoại thứ hai và tăng tốc ngăn xếp CloudFormation thứ hai hoặc phiên bản Docker để thử nghiệm. Nếu bạn có 2 Ứng dụng API WhatsApp Business đang hoạt động sử dụng cùng một số điện thoại, máy chủ sẽ đăng xuất bạn vì các khóa mã hóa xung đột. Bạn nên có môi trường thứ hai mà bạn có thể dùng để thử nghiệm phiên bản không phải là phiên bản chính thức trước khi thực hiện bất kỳ quá trình di chuyển nào trên ứng dụng chính thức.

Hoạt động kiểm tra Tình trạng là hoàn toàn miễn phí và bạn có thể truy vấn thường xuyên khi cần.

Đọc tài liệu Số liệu thống kê để tìm hiểu thêm các số liệu thống kê về ứng dụng và cơ sở dữ liệu mà bạn có thể truy vấn. Số liệu thống kê về ứng dụng được lưu trữ trong bộ nhớ và bạn có thể truy vấn với chi phí không đáng kể. Số liệu thống kê về cơ sở dữ liệu cần nhiều tài nguyên hơn và bạn chỉ nên truy vấn khi cần.

Doanh nghiệp của bạn sẽ không nhận được thông báo khi một khách hàng thay đổi số điện thoại WhatsApp của họ. Khi bạn sử dụng nút contacts, trạng thái của số đó sẽ là invalid.

Nếu số điện thoại của khách hàng không hoạt động, nhưng khách hàng vẫn đang sử dụng WhatsApp thì họ sẽ tiếp tục có quyền truy cập vào WhatsApp cho đến khi/nếu số điện thoại được chỉ định lại hoặc đăng ký lại.

WhatsApp xác minh cẩn thận xem số được cung cấp có thực sự thuộc về một điện thoại hay không. Thực tế, khi một người dùng có tài khoản WhatsApp, nghĩa là họ đã xác nhận số này và sau đó không có ai khác sử dụng số đó để đăng ký trên WhatsApp. Tuy nhiên, điều đó không đảm bảo được vị trí thực của thẻ SIM.

Mặt khác, nếu điện thoại của người dùng bị mất hoặc bị đánh cắp, họ có thể vô hiệu hóa tài khoản WhatsApp của mình. Hãy xem phần Câu hỏi thường gặp về điện thoại bị mất và bị đánh cắp để đọc thêm thông tin về cách người dùng có thể vô hiệu hóa tài khoản của họ.

Không, không dùng được API WhatsApp Business để phát hiện nhiều thiết bị sử dụng cùng một số điện thoại.

Phần tải tin nhắn từ người dùng có thể là văn bản hoặc file phương tiện.

Đối với văn bản, chúng tôi chưa xác định được bất kỳ mối nguy hại nào.

Đối với file phương tiện:

• Thông thường, các doanh nghiệp nên có phần mềm bảo vệ nào đó (nghĩa là diệt vi rút, chống phần mềm độc hại, v.v.) tại chỗ để phân tích bất kỳ mối đe dọa tiềm ẩn nào.
• WhatsApp không thể xác định hay kiểm tra nội dung của file đang được truyền vì file đó được mã hóa đầu cuối (điều này cũng áp dụng cho nội dung chỉ gồm văn bản).
• Có một phương án ngăn chặn hành vi tự động tải xuống file phương tiện trong Ứng dụng API WhatsApp Business. Nếu doanh nghiệp không muốn nhận bất kỳ file nào từ người dùng, họ có thể đặt trường auto_download thành một mảng trống.

Vui lòng liên hệ với bộ phận Hỗ trợ và cung cấp bất kỳ thông tin nào bạn có. Chúng tôi sẽ điều tra và ngừng hoạt động của mọi số giả.

Kể từ bản phát hành phiên bản 2.18.26, điểm cuối Số liệu thống kê ứng dụng cho phép xuất số liệu nội bộ ở định dạng văn bản Prometheus. Hãy xem tài liệu về việc Giám sát phiên bản để biết thêm thông tin.

Ứng dụng API WhatsApp Business Tại chỗ yêu cầu có cơ sở dữ liệu để lưu trữ các khóa nhằm giải mã tin nhắn được gửi giữa doanh nghiệp và khách hàng. Mọi tin nhắn trên WhatsApp đều được mã hóa bằng khóa người gửi và khóa người nhận. Khóa khách hàng được lưu trữ trên thiết bị di động của khách hàng và khóa doanh nghiệp được lưu trữ trong cơ sở dữ liệu của doanh nghiệp. Hãy tìm hiểu thêm về Tính bảo mật của WhatsApp.

API WhatsApp Business Đám mây là giải pháp thay thế, trong đó Meta lưu trữ cơ sở dữ liệu của doanh nghiệp. Thông qua API Đám mây, bạn có thể triển khai các API WhatsApp Business mà không mất chi phí lưu trữ máy chủ của chính mình. Tìm hiểu thêm.