Bắt đầu
Hướng dẫn này sẽ hỗ trợ bạn sử dụng API Đám mây để gửi và nhận tin nhắn đầu tiên. Bạn cũng sẽ tìm hiểu cách đặt cấu hình Webhooks để sử dụng với một ứng dụng mẫu.
Đây là hướng dẫn dành cho những người phát triển ứng dụng để chính họ hoặc tổ chức của họ sử dụng. Nếu bạn đang phát triển một ứng dụng để doanh nghiệp khác sử dụng, hãy xem bài viết Nhà cung cấp giải pháp.
Trước khi bạn bắt đầu
Bạn sẽ cần:
- Tài khoản nhà phát triển trên Meta - tìm hiểu thêm về cách đăng ký làm nhà phát triển trên Meta.
- Ứng dụng dành cho doanh nghiệp - tìm hiểu thêm về cách tạo ứng dụng. Nếu bạn không nhìn thấy tùy chọn tạo ứng dụng dành cho doanh nghiệp, hãy chọn Khác > Tiếp > Doanh nghiệp trong quá trình tạo ứng dụng).
Bước 1: Thêm sản phẩm WhatsApp vào ứng dụng
Ở bước này, bạn sẽ được nhắc Thêm sản phẩm vào ứng dụng nếu tạo một ứng dụng mới. Hãy cuộn xuống phần WhatsApp rồi chọn Thiết lập. Nếu không, hãy chọn ứng dụng của bạn từ màn hình Ứng dụng của tôi. Bạn có thể làm lại theo hướng dẫn tương tự để thêm sản phẩm WhatsApp vào ứng dụng của mình.
Nếu có Tài khoản kinh doanh trên Meta (MBA), bạn sẽ được nhắc đính kèm tài khoản này khi thêm sản phẩm WhatsApp vào ứng dụng đó. Nếu không có MBA, bạn sẽ thấy một số lời nhắc hỗ trợ bạn tạo tài khoản. Khi đã đính kèm MBA vào ứng dụng, bạn sẽ sẵn sàng để bắt đầu thử nghiệm.
Khi bạn thêm sản phẩm WhatsApp vào ứng dụng của mình, hệ thống sẽ giúp bạn thực hiện một số việc sau đây:
- Nhắc bạn tạo Tài khoản kinh doanh trên Meta nếu bạn chưa có.
- Tự động tạo một Tài khoản WhatsApp Business thử nghiệm cho bạn. Tài khoản này bị giới hạn và chỉ được dùng cho mục đích thử nghiệm, phát triển vì bạn không phải trả tiền cho tin nhắn.
- Tạo một số điện thoại thử nghiệm của doanh nghiệp được liên kết với Tài khoản WhatsApp Business của bạn. Với số này, bạn có thể gửi tin nhắn miễn phí cho tối đa 5 số điện thoại người nhận.
- Tạo một loạt mẫu tin nhắn được phê duyệt trước.
Bước 2: Thêm số người nhận
Thêm một số WhatsApp hợp lệ mà bạn có thể gửi tin nhắn thử nghiệm.
Ở menu bên trái của Bảng điều khiển ứng dụng, hãy chuyển đến phần WhatsApp > Thiết lập API. Trong phần Gửi và nhận tin nhắn, hãy chọn trường Đến rồi chọn Quản lý danh sách số điện thoại.
Bạn có thể thêm bất kỳ số WhatsApp hợp lệ nào làm người nhận. Số người nhận sẽ nhận được mã xác nhận trong WhatsApp. Bạn có thể sử dụng mã này để xác minh số đó.
Sau khi bạn xác minh số người nhận, số đó sẽ được chọn trong trường Đến. Lặp lại quy trình này nếu bạn muốn thêm một người nhận khác, tổng cộng tối đa là 5 người nhận.
Bước 3: Gửi tin nhắn thử nghiệm
Gửi mẫu tin nhắn hello_world được phê duyệt trước đến số người nhận bạn đã chọn.
Trong bảng điều khiển WhatsApp > Thiết lập API:
- Đảm bảo chọn số điện thoại thử nghiệm của doanh nghiệp bạn trong trường Từ.
- Đảm bảo chọn số điện thoại người nhận mà bạn muốn nhắn tin trong trường Đến. Nếu thêm nhiều số, bạn có thể gửi nhiều tin nhắn cùng lúc.
- Trong bảng điều khiển Gửi tin nhắn bằng API, hãy nhấp vào nút Gửi tin nhắn.
Hoặc bạn có thể sao chép lệnh cURL, sau đó dán lệnh này vào một cửa sổ dòng lệnh mới rồi chạy lệnh.
Lưu ý rằng mã cho biết bạn đang gửi một tin nhắn mẫu (”type”:”template”) và xác định một mẫu cụ thể để sử dụng (”name”:”hello_world”).
Bước 4: Sao chép ứng dụng mẫu và đặt cấu hình webhook
Với webhook, bạn có thể nhận được thông báo HTTP theo thời gian thực về những thay đổi đối với các đối tượng cụ thể. Trong WhatsApp, webhook có thể thông báo cho bạn về nhiều sự kiện trong ứng dụng (ví dụ: thông báo đã phân phối tin nhắn và đã đọc tin nhắn) và cả những thay đổi về tài khoản.
Thêm một URL gọi lại để xem nội dung webhook. Hãy làm theo hướng dẫn về URL gọi lại mẫu để thử nghiệm webhook để sao chép ứng dụng mẫu của chúng tôi. Ứng dụng này chấp nhận thông báo webhook và hiển thị phần tải dữ liệu JSON của thông báo đó trên màn hình.
Sau khi bạn thiết lập xong webhook, hãy gửi lại tin nhắn mẫu rồi trả lời tin nhắn đó. Bạn sẽ thấy 4 thông báo webhook riêng biệt: Thông báo đã gửi tin nhắn, đã phân phối tin nhắn, đã đọc tin nhắn và nội dung tin nhắn đến.
Bước 5: (Không bắt buộc) Thêm số điện thoại thật của doanh nghiệp
Với số điện thoại thử nghiệm của doanh nghiệp và tài khoản WhatsApp Business thử nghiệm, bạn có thể bắt đầu phát triển ứng dụng của mình. Khi sử dụng những tài sản thử nghiệm này, bạn không phải trả tiền để gửi tin nhắn trong quá trình phát triển ứng dụng.
Khi đã sẵn sàng bắt đầu gửi tin nhắn cho khách hàng, bạn có thể thêm số điện thoại thật của doanh nghiệp trong bảng điều khiển Thiết lập API và tạo Tài khoản WhatsApp Business thật.