# Mẫu tin nhắn WhatsApp

> Tami · Cập nhật lần cuối ngày 12 thg 8, 2025

Mẫu tin nhắn WhatsApp là các định dạng tin nhắn đã được phê duyệt trước, cho phép bạn chủ động bắt đầu cuộc hội thoại với khách hàng. Chúng rất cần thiết để gửi tin nhắn quảng cáo, cập nhật đơn hàng và thông báo hỗ trợ qua nền tảng WhatsApp Business.

**Lưu ý:** Mẫu tin nhắn WhatsApp hiện chỉ được hỗ trợ cho inbox WhatsApp Cloud.

## **Mẫu tin nhắn WhatsApp là gì?**

Mẫu tin nhắn WhatsApp là các tin nhắn có cấu trúc phải được WhatsApp phê duyệt trước khi bạn có thể gửi chúng đến khách hàng. Chúng giúp đảm bảo tuân thủ chính sách nhắn tin của WhatsApp trong khi vẫn cho phép bạn gửi thông tin liên lạc chuyên nghiệp, nhất quán.

Mẫu tin nhắn có thể bao gồm:

-   **Tin nhắn văn bản** với các biến được cá nhân hóa
    
-   **Hình ảnh, video hoặc tài liệu** làm phần tiêu đề
    
-   **Nút hành động** để khách hàng phản hồi nhanh
    
-   **Nút kêu gọi hành động** liên kết đến website hoặc số điện thoại
    

## **Phân loại mẫu tin nhắn**

WhatsApp phân loại mẫu tin nhắn theo các danh mục khác nhau dựa trên mục đích sử dụng:

-   **Tiện ích** - Tin nhắn giao dịch như xác nhận đơn hàng và biên lai
    
-   **Marketing** - Nội dung quảng cáo và ưu đãi đặc biệt
    
-   **Cập nhật vận chuyển** - Cập nhật trạng thái giao hàng và bưu kiện
    
-   **Cập nhật yêu cầu hỗ trợ** - Thông báo về trường hợp hỗ trợ
    
-   **Giải quyết vấn đề** - Theo dõi sau hỗ trợ khách hàng
    

## **Những tính năng không được hỗ trợ**

### **Mẫu xác thực**

-   Mẫu **AUTHENTICATION** với mã OTP và tin nhắn xác minh
    
-   **Tự động điền** tham số nút bằng giá trị OTP
    
-   **Xác thực OTP** và xử lý thời gian hết hạn
    

### **Thành phần tương tác**

-   Mẫu **LIST** với các tùy chọn có thể chọn
    
-   Mẫu **PRODUCT** tích hợp danh mục sản phẩm
    
-   Mẫu **CATALOG** để duyệt sản phẩm
    
-   Thành phần **chọn nhiều**
    

### **Thành phần yêu cầu quyền gọi điện**

-   Mẫu **CALL\_PERMISSION\_REQUEST** yêu cầu bật API gọi điện WhatsApp
    
-   Nút **quyền gọi điện** và các thành phần gọi điện tương tác
    

### **Thành phần vị trí**

-   Tiêu đề **LOCATION** với tọa độ bản đồ
    
-   Tham số **địa chỉ** với vĩ độ/kinh độ
    
-   Mẫu tin nhắn **dựa trên vị trí**
    

### **Tính năng nâng cao**

-   **Định dạng văn bản phong phú** khi tạo mẫu (được giữ nguyên khi gửi)
    
-   Mẫu **Carousel** với nhiều thẻ
    
-   Thành phần **Form** để thu thập dữ liệu
    
-   Mẫu tích hợp **thanh toán**
    
-   Mẫu **Flow** với logic điều kiện
    

## **Mẫu cũ và mẫu nâng cao**

SquareHub hỗ trợ hai định dạng mẫu để đảm bảo tương thích với tất cả các mẫu hiện có của bạn:

### **Mẫu cũ (Legacy)**

Đây là các mẫu truyền thống sử dụng biến văn bản đơn giản. Chúng hoạt động với:

-   Tin nhắn văn bản cơ bản
    
-   Thay thế biến đơn giản (như chèn tên khách hàng)
    
-   Tương tác nút đơn giản
    

**Ví dụ định dạng cũ:**

```
{
  "parameters": ["John Doe", "12345", "2025-01-15"]
}
```

**⚠️ Quan trọng:** Hỗ trợ mẫu cũ sẽ bị ngừng trong phiên bản v4.7. Chúng tôi khuyến nghị chuyển sang mẫu nâng cao để đảm bảo tính năng hoạt động liên tục.

### **Mẫu nâng cao (Enhanced)**

Định dạng nâng cao mới cung cấp các tính năng phức tạp hơn:

-   **Hỗ trợ media** - Gửi hình ảnh, video và tài liệu
    
-   **Biến nâng cao** - Cá nhân hóa văn bản linh hoạt hơn
    
-   **Nút tương tác** - Nút URL với liên kết động, mã sao chép và trả lời nhanh
    
-   **Xác thực tốt hơn** - Kiểm tra thời gian thực các tham số mẫu của bạn
    

**Ví dụ định dạng nâng cao:**

```
{
  "body": {
    "1": "John Doe",
    "2": "12345",
    "3": "2025-01-15"
  },
  "header": {
    "media_url": "https://example.com/image.jpg",
    "media_type": "image"
  },
  "buttons": [
    {
      "type": "url",
      "parameter": "track123"
    }
  ]
}
```

**Lưu ý:** Tất cả các mẫu cũ hiện có của bạn vẫn tiếp tục hoạt động trong thời gian này, nhưng bạn nên lên kế hoạch chuyển sang mẫu nâng cao. Các tính năng nâng cao sẽ tự động có sẵn khi bạn sử dụng các loại mẫu được hỗ trợ.

Vui lòng xem [API](https://docs.squareomni.com/api-reference/messages/create-new-message) này để biết về các định dạng yêu cầu.

## **Cách tạo mẫu tin nhắn WhatsApp**

Hiện tại, mẫu tin nhắn WhatsApp phải được tạo thông qua **WhatsApp Business Manager**:

1.  **Truy cập WhatsApp Business Manager** - Vào [business.facebook.com](http://business.facebook.com/)
    
2.  **Điều hướng đến mẫu tin nhắn** - Tìm phần "Công cụ tài khoản" và chọn "Mẫu tin nhắn"
    
3.  **Tạo mẫu mới** - Nhấp vào "Tạo mẫu" và chọn loại mẫu
    
4.  **Thiết kế mẫu của bạn** - Thêm tiêu đề, nội dung, chân trang và các nút theo nhu cầu
    
5.  **Gửi để phê duyệt** - WhatsApp sẽ xem xét mẫu của bạn (quá trình này có thể mất đến 24 giờ)
    
6.  **Đồng bộ với SquareHub** - Sau khi được phê duyệt, mẫu sẽ tự động xuất hiện hoặc bạn có thể đồng bộ thủ công qua cài đặt inbox trong SquareHub
    

**🚀 Sắp ra mắt:** Chúng tôi đang lên kế hoạch thêm tính năng tạo mẫu trực tiếp trong giao diện SquareHub trong một bản phát hành tương lai, giúp bạn thiết kế và quản lý mẫu dễ dàng hơn mà không cần rời khỏi SquareHub.

## **Cách gửi mẫu tin nhắn WhatsApp**

Mẫu tin nhắn WhatsApp có thể được gửi theo hai cách:

-   **Cuộc hội thoại riêng lẻ** - Gửi mẫu đến khách hàng cụ thể trong các cuộc hội thoại
    
-   **Chiến dịch** - Gửi mẫu đến nhiều khách hàng cùng lúc bằng tính năng chiến dịch của SquareHub
    

### **Gửi mẫu trong cuộc hội thoại**

#### **Bước 1: Truy cập tùy chọn mẫu**

Mở bất kỳ cuộc hội thoại nào với liên hệ WhatsApp, nhấp vào **biểu tượng mẫu** trong khung soạn tin nhắn, chọn **"Mẫu WhatsApp"** từ menu thả xuống

![](/assets/images/4d2071d4_CleanShot_2025-08-12_at_01.12.20_2x_1.png)

#### **Bước 2: Chọn mẫu**

Duyệt qua các mẫu đã được phê duyệt, sử dụng thanh tìm kiếm để tìm mẫu cụ thể nhanh chóng

![](/assets/images/ab885a04_CleanShot_2025-08-12_at_01.17.34_2x_1.png)

#### **Bước 3: Tùy chỉnh tin nhắn**

Tùy thuộc vào loại mẫu, bạn có thể cần điền:

![](/assets/images/2c66eabe_CleanShot_2025-08-12_at_01.16.32_2x_1.png)

**Đối với mẫu văn bản:**

-   Tên khách hàng, số đơn hàng hoặc thông tin cá nhân hóa khác
    
-   Các trường biến được đánh dấu bằng {{1}}, {{2}}, v.v.
    

**Đối với mẫu media:**

-   **URL hình ảnh/video** - Cung cấp đường dẫn trực tiếp đến tệp media
    
-   **URL tài liệu** - Liên kết đến PDF, tài liệu Word hoặc các tệp khác
    
-   **Media phải có thể truy cập công khai** (không yêu cầu đăng nhập)
    

**Đối với mẫu có nút:**

-   **Tham số URL** - Liên kết động cho nút kêu gọi hành động
    
-   **Mã sao chép** - Mã giảm giá hoặc mã giới thiệu
    
-   **Số điện thoại** - Cho nút nhấn để gọi
    

#### **Bước 4: Xem trước và gửi**

1.  Xem lại tin nhắn trong bảng xem trước
    
2.  Kiểm tra tất cả các biến đã được điền đúng
    
3.  Xác minh URL media đang hoạt động (nếu có)
    
4.  Nhấp **"Gửi mẫu"** để gửi tin nhắn
    

### **Gửi mẫu qua Chiến dịch**

Để gửi mẫu đến nhiều khách hàng cùng lúc:

Vào **Chiến dịch** WhatsApp trong bảng điều khiển SquareHub của bạn, tạo chiến dịch mới và chọn **WhatsApp** làm kênh

![](/assets/images/4a3c2b86_CleanShot_2025-08-12_at_01.19.07_2x_1.png)

Chọn mẫu WhatsApp từ các tùy chọn có sẵn và cấu hình đối tượng cũng như tham số mẫu

![](/assets/images/c8361fd1_og-help-center_1_.png)

**Lưu ý:** Tính năng chiến dịch cho phép bạn tiếp cận nhiều khách hàng một cách hiệu quả với cùng một mẫu tin nhắn.

## **Câu hỏi thường gặp (FAQ)**

### **Câu hỏi chung**

**Tại sao tôi không thấy tất cả mẫu WhatsApp trong SquareHub?**

Chỉ những mẫu đã được WhatsApp phê duyệt và được SquareHub hỗ trợ mới xuất hiện. Các loại mẫu không được hỗ trợ (như mẫu xác thực với mã OTP) sẽ tự động bị lọc ra.

**Mất bao lâu để mẫu mới xuất hiện trong SquareHub?**

Mẫu thường tự động đồng bộ sau một khoảng thời gian, và bạn cũng có thể cập nhật thủ công từ cài đặt inbox.

**Tôi có thể chỉnh sửa mẫu trực tiếp trong SquareHub không?**

Không, mẫu phải được tạo và chỉnh sửa trong WhatsApp Business Manager. SquareHub chỉ dùng để gửi các mẫu đã được phê duyệt.

**Tại sao tôi cần cung cấp URL cho hình ảnh và video?**

WhatsApp yêu cầu tệp media phải được lưu trữ trực tuyến và có thể truy cập công khai. Bạn không thể tải tệp lên trực tiếp — bạn phải cung cấp URL hoạt động đến nội dung media của mình.

**Tôi có thể dùng cùng một mẫu cho nhiều khách hàng khác nhau không?**

Có! Mẫu được thiết kế để sử dụng lại. Chỉ cần điền thông tin khách hàng khác nhau mỗi lần gửi mẫu.

### **Xử lý sự cố**

**Mẫu của tôi không gửi được. Tôi cần kiểm tra gì?**

Các vấn đề thường gặp bao gồm:

-   **Thiếu biến** - Đảm bảo tất cả các trường bắt buộc đã được điền
    
-   **URL media bị hỏng** - Xác minh các liên kết hình ảnh/video/tài liệu hoạt động
    
-   **Tệp quá lớn** - Kiểm tra tệp media đáp ứng giới hạn kích thước của WhatsApp
    
-   **Mẫu chưa được phê duyệt** - Xác nhận trạng thái mẫu trong WhatsApp Business Manager
    

**Tại sao khách hàng không thể xem hình ảnh/video của tôi?**

Điều này thường có nghĩa là:

-   URL không thể truy cập công khai
    
-   Định dạng tệp không được hỗ trợ
    
-   Tệp quá lớn
    
-   Máy chủ lưu trữ bị ngừng hoạt động hoặc yêu cầu xác thực
    

**Nút URL của tôi không hoạt động đúng. Làm thế nào để khắc phục?**

Đối với các mẫu có nút URL động, có một số vấn đề đã biết với một số cấu hình mẫu nhất định. Hãy thử sử dụng URL tĩnh thay vì tham số động để có độ tin cậy cao hơn.

**Tôi có thể gửi mẫu đến khách hàng chưa nhắn tin cho tôi trước không?**

Có, nhưng chỉ đối với một số danh mục mẫu nhất định:

-   Mẫu **tiện ích** có thể gửi bất cứ lúc nào cho mục đích giao dịch
    
-   Mẫu **marketing** yêu cầu khách hàng đăng ký nhận tin và có khung thời gian gửi cụ thể
    
-   Luôn tuân thủ hướng dẫn tuân thủ của WhatsApp cho khu vực của bạn
    

### **Media và tệp**

**Tôi có thể dùng loại tệp nào trong mẫu?**

Các định dạng được hỗ trợ bao gồm:

-   **Hình ảnh:** JPEG, PNG (dưới 5MB)
    
-   **Video:** MP4, 3GPP (dưới 16MB)
    
-   **Tài liệu:** PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT (dưới 100MB)
    

### **Tuân thủ và giới hạn**

**Tôi có thể gửi bao nhiêu mẫu mỗi ngày?**

Điều này phụ thuộc vào giới hạn tài khoản WhatsApp Business và hạn mức tin nhắn của bạn. Liên hệ bộ phận hỗ trợ WhatsApp để biết giới hạn cụ thể cho tài khoản của bạn.

**Có hạn chế về thời gian gửi mẫu marketing không?**

Có, mẫu marketing có khung thời gian gửi cụ thể và yêu cầu khách hàng đăng ký nhận tin. Kiểm tra chính sách hiện tại của WhatsApp cho khu vực và loại hình doanh nghiệp của bạn.

**Điều gì xảy ra nếu tôi gửi quá nhiều tin nhắn?**

WhatsApp theo dõi chất lượng tin nhắn và tỷ lệ phân phối. Việc gửi quá nhiều tin nhắn không thành công hoặc không mong muốn có thể ảnh hưởng đến giới hạn tin nhắn và tỷ lệ phê duyệt mẫu của tài khoản bạn.

## **Cần thêm trợ giúp?**

Nếu bạn gặp sự cố không được đề cập trong hướng dẫn này:

1.  **Kiểm tra trạng thái mẫu** trong WhatsApp Business Manager
    
2.  **Xác minh URL media** đang hoạt động và có thể truy cập công khai
    
3.  **Thử nghiệm với dữ liệu mẫu** trước khi gửi đến khách hàng
    
4.  **Liên hệ quản trị viên SquareHub** để giải quyết các vấn đề liên quan đến tài khoản
    
5.  **Xem lại chính sách mẫu của WhatsApp** để giải đáp các câu hỏi về tuân thủ
    

Hãy nhớ rằng mẫu tin nhắn WhatsApp là công cụ mạnh mẽ để giao tiếp với khách hàng khi được sử dụng đúng cách. Hãy tập trung vào việc cung cấp giá trị cho khách hàng bằng những tin nhắn có liên quan, đúng thời điểm và tôn trọng sở thích của họ.
