Bắt đầu

Hướng dẫn này mô tả cách thiết lập ứng dụng API Tại chỗ, đăng ký số điện thoại doanh nghiệp, cập nhật các chế độ cài đặt và gửi tin nhắn thử nghiệm.

Quá trình bắt đầu sử dụng API này có thể được chia thành 3 phần:

1. Chuẩn bị tài sản - Trước khi bắt đầu, bạn phải thiết lập các tài sản cần thiết để hoàn tất quá trình tích hợp API, trong đó có Tài khoản WhatsApp Business.
2. Cài đặt ứng dụng API Tại chỗ - Cài đặt ứng dụng API. Sau khi ứng dụng hoạt động, bạn có thể cập nhật các chế độ cài đặt ứng dụng.
3. Bắt đầu sử dụng ứng dụng - Đăng ký số điện thoại của bạn bằng lệnh gọi API đến /account và gửi tin nhắn thử nghiệm bằng lệnh gọi đến /messages.

Trước khi bạn bắt đầu

Phiên bản phần mềm khuyên dùng

Bước 1: Cài đặt ứng dụng API Tại chỗ

Môi trường

Về cơ bản, ứng dụng API Tại chỗ hoạt động dựa trên vùng chứa Docker. Hãy xem bài viết Cấu trúc ứng dụng để biết thông tin về từng thành phần.

Thiết bị

Ứng dụng API Tại chỗ sẽ chạy trên bất kỳ máy nào có kết nối Internet có thể chạy Docker cho Linux, dù là trên máy ảo hay trên máy chủ Linux. Để biết thêm thông tin, hãy xem bài viết Câu hỏi thường gặp. Ví dụ: bạn có thể tiến hành thử nghiệm đơn giản trên laptop Đối với máy chủ môi trường chính thức, bạn nên sử dụng tối thiểu ổ 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.

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 Coreapp và Webapp. Máy chủ cơ sở dữ liệu chỉ được chênh lệch với (các) máy tính vài mili giây.

Cài đặt

Có 2 cách để bắt đầu sử dụng API Tại chỗ:

• Cài đặt tại chỗ - Bạn có thể tự thiết lập vùng chứa Docker theo Hướng dẫn cài đặt. Bạn nên bắt đầu bằng một trong những Cách thiết lập dành cho nhà phát triển để làm quen với quy trình thiết lập và gửi tin nhắn. Bạn có thể sử dụng giải pháp Tại chỗ này trên máy tính của mình trước khi chuyển sang môi trường chính thức.
• Amazon Web Services (AWS): Nếu bạn sử dụng AWS hoặc muốn một giải pháp độc lập hơn, hãy xem hướng dẫn về AWS. Giải pháp AWS thiết lập toàn bộ giải pháp API Tại chỗ bằng cách sao lưu, khôi phục, v.v. trong đám mây AWS mà bạn quản lý và sở hữu.

Cập nhật chế độ cài đặt

Bạn có thể thay đổi Cài đặt ứng dụng sau khi ứng dụng API Tại chỗ hoạt động. Tuy nhiên, bạn không có quyền truy cập vào các chế độ cài đặt trang cá nhân khác nhau của ứng dụng API Tại chỗ cho đến khi quá trình đăng ký hoàn tất.

• Cài đặt ứng dụng có liên quan đến cách hoạt động của ứng dụng - chế độ cài đặt gọi lại, Webhooks, máy nhắn tin trực sẵn, trạng thái đã gửi, hành vi tải file phương tiện xuống, v.v. Lưu ý: Bạn nên thiết lập URL Webhook để nhận thông báo về tin nhắn đến hoặc lỗi.
• Cài đặt trang kinh doanh và Cài đặt trang cá nhân bao gồm các thông tin về doanh nghiệp, chẳng hạn như địa chỉ, email, trang web, ngành, thông tin giới thiệu và ảnh đại diện.

Bước 2: Bắt đầu sử dụng ứng dụng

Đăng ký

Sau khi thiết lập và chạy ứng dụng API Tại chỗ, bạn có thể đăng ký số điện thoại của mình bằng cách gửi lệnh gọi API đến điểm cuối account.

Gửi tin nhắn thử nghiệm

Bạn có thể gửi tin nhắn thử nghiệm bằng điểm cuối messages. Trước tiên, hãy kiểm tra trạng thái của số điện thoại mà bạn đang dùng để thử nghiệm. Bạn cần gửi cho tài khoản WhatsApp một tin nhắn từ số điện thoại thử nghiệm này để bật cửa sổ Dịch vụ khách hàng. Thông qua cửa sổ này, bạn có thể gửi mọi loại tin nhắn trong khoảng thời gian 24 giờ (Xem phần Kiểm soát theo giới hạn để biết chi tiết). Sau đó, gửi tin nhắn văn bản đến số điện thoại thử nghiệm. Nếu số đó nhận được tin nhắn thì tức là bạn đã cài đặt thành công. Nếu số đó không nhận được tin nhắn, hãy kiểm tra Webhook để xem các thông báo có chỉ ra sự cố nào không.

Bảo mật

Hãy xem tài liệu hướng dẫn về Bảo mật của chúng tôi để biết thông tin về mật khẩu, xác thực, cấu hình SSL, phân tách mạng, thông tin giao tiếp được mã hóa, tiêu đề HTTP và giao thức TLS cho máy chủ web có liên quan đến ứng dụng API Tại chỗ.

Quy trình khởi động

API Tại chỗ của WhatsApp sẽ trải qua quy trình khởi động sau khi thiết lập kết nối với máy chủ. Đây là quy trình thiết yếu để đảm bảo đem lại một phương tiện gửi và nhận tin nhắn liền mạch cũng như đáng tin cậy. Trong giai đoạn khởi động này, ứng dụng cốt lõi (coreapp) sẽ chờ quá trình thực hiện một vài điều kiện tiên quyết, bao gồm:

• Tải tin nhắn mẫu: API này sẽ tải tin nhắn mẫu từ máy chủ trong quá trình khởi tạo.

• Nhận và xử lý tin nhắn offline: API này cũng xử lý việc nhận và xử lý tin nhắn offline.

Nếu cố gửi tin nhắn trong khi chưa đáp ứng các điều kiện tiên quyết nêu trên, ứng dụng cốt lõi sẽ phản hồi bằng thông báo lỗi "Coreapp chưa sẵn sàng", đồng thời nhật ký sẽ hiển thị lỗi "Dịch vụ chưa sẵn sàng". Lưu ý rằng quy trình khởi động này sẽ diễn ra mỗi khi thiết lập kết nối mới với máy chủ WhatsApp. Do đó, nếu ứng dụng cốt lõi được khởi động lại hoặc bị ngắt kết nối, quy trình khởi động sẽ bắt đầu lại để đặt trạng thái của ứng dụng cốt lõi thành "sẵn sàng". Nhờ vậy mà API Tại chỗ của WhatsApp trở nên đáng tin cậy và sẵn sàng cho hoạt động trao đổi qua tin nhắn.

Xử lý tin nhắn offline

Khi không tìm thấy tin nhắn offline nào, bước xử lý tin nhắn offline sẽ bị bỏ qua. Nói cách khác, nếu không có tin nhắn nào đang chờ ở trạng thái offline, giai đoạn xử lý tin nhắn cụ thể này sẽ bị bỏ qua.

Trong những điều kiện thông thường, API Tại chỗ của WhatsApp sẽ xử lý tin nhắn offline theo một giao thức tiêu chuẩn. API này sẽ chờ nhận và xử lý tất cả tin nhắn offline trong thời gian chờ tối đa định sẵn là 6 phút. Sau khi hết khoảng thời gian 6 phút nêu trên, giai đoạn xử lý tin nhắn offline sẽ được xem là đã hoàn tất thành công.

Gợi ý khác

Nếu phát hiện thấy bạn vi phạm bất kỳ chính sách hoặc nguyên tắc nào của chúng tôi, chúng tôi có quyền giới hạn hoặc gỡ quyền truy cập của bạn vào WhatsApp.

Tìm hiểu thêm

• Thiết lập nâng cao
• Bộ sưu tập Postman
• Nền tảng WhatsApp Business
• Nhật ký thay đổi của Nền tảng WhatsApp Business