Bạn có thể dùng nút messages
để gửi tin nhắn văn bản cho khách hàng của mình.
Bạn cần đáp ứng mọi yêu cầu tiên quyết nêu trong phần Trước khi bạn bắt đầu của tài liệu về Tin nhắn.
POST
đến /messages
Sau khi có ID WhatsApp của người dùng mà bạn muốn nhắn tin, hãy sử dụng ID đó để gửi tin nhắn văn bản. Chỉ định text
trong trường type
.
POST /v1/messages { "preview_url": false | true, "recipient_type": "individual", "to": "whatsapp-id", "type": "text", "text": { "body": "your-text-message-content" } }
Để biết thêm thông tin về các thông số, hãy xem:
Nếu bạn muốn định dạng tin nhắn, hãy xem phần Định dạng trong tin nhắn văn bản.
Theo mặc định, ứng dụng WhatsApp dành cho di động sẽ nhận ra URL và điều chỉnh để mọi người có thể nhấp vào URL này. Để thêm bản xem trước URL, hãy thêm "preview_url": true
vào phần nội dung tin nhắn và đảm bảo URL bắt đầu bằng http://
hoặc https://
. Bạn phải cung cấp tên máy chủ. Nếu không, địa chỉ IP sẽ không được so khớp.
Lưu ý rằng việc sử dụng preview_url
ở đây khác với API Đám mây. Hãy xem tài liệu về Tin nhắn qua API Đám mây.
{ "preview_url": true, "to": "whatsapp-id", "text": { "body": "You have to check out this amazing messaging service https://www.whatsapp.com/" }
Cho dù URL có kèm bản xem trước hay không thì hầu như mỗi khi bạn gửi, người nhận tin nhắn đều sẽ thấy một URL mà họ có thể nhấp vào.
Bản xem trước URL chỉ hiển thị sau khi một trong những hành động dưới đây diễn ra:
Nếu thành công, phản hồi sẽ bao gồm một đối tượng messages
cùng với ID của tin nhắn mới tạo.
{ "messages": [{ "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU" }] }
Nếu không thành công, phản hồi sẽ chứa thông báo lỗi. Hãy xem phần Mã lỗi và mã trạng thái để biết thêm thông tin.