Gửi tin nhắn văn bản

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.

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

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.

Giới hạn:

  • Tin nhắn văn bản có thể dài tối đa 4096 ký tự.

Bước 1: Gửi yêu cầu 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.

Gửi URL 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.

Ví dụ

{
    "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:

  1. Doanh nghiệp đã gửi mẫu tin nhắn cho người dùng.
  2. Người dùng bắt đầu cuộc trò chuyện thông qua liên kết "nhấp để chat".
  3. Người dùng thêm số điện thoại doanh nghiệp vào sổ địa chỉ của họ và bắt đầu cuộc trò chuyện.

Bước 2: Kiểm tra phản hồi

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.