# Mẫu nội dung Twilio

> Tami · Cập nhật lần cuối ngày 5 thg 1, 2026

Mẫu nội dung Twilio cho phép bạn gửi các mẫu tin nhắn WhatsApp đã được phê duyệt trước thông qua các kênh WhatsApp Business Twilio của bạn trong SquareHub. Các mẫu này cho phép bạn khởi tạo cuộc hội thoại và gửi các tin nhắn có cấu trúc tuân thủ chính sách nhắn tin của WhatsApp.

## **Các loại mẫu được hỗ trợ**

**Mẫu văn bản**

-   Tin nhắn văn bản đơn giản với các biến tùy chọn
    
-   Hỗ trợ tối đa 100 biến mỗi mẫu sử dụng định dạng `{{1}}`, `{{2}}`
    
-   Hỗ trợ đa ngôn ngữ
    

**Mẫu đa phương tiện**

-   **Mẫu hình ảnh**: Văn bản với tiêu đề là hình ảnh (JPEG/PNG, tối đa 5MB)
    
-   **Mẫu video**: Văn bản với tiêu đề là video (MP4/3GPP, tối đa 16MB)
    
-   **Mẫu tài liệu**: Văn bản với tệp đính kèm tài liệu (định dạng PDF/Office, tối đa 100MB)
    
-   Hỗ trợ URL đa phương tiện động với các biến
    

**Mẫu trả lời nhanh**

-   Phản hồi bằng nút tương tác được xử lý bởi WhatsApp
    
-   Các thao tác nút đơn giản cho các phản hồi thông thường
    
-   Hỗ trợ nhiều biến thể ngôn ngữ
    

**Mẫu kêu gọi hành động**

-   **Mẫu nút URL**: Gửi tin nhắn với các nút hành động có thể nhấp
    
-   **Hỗ trợ biến**: Cả văn bản tin nhắn và tham số nút đều có thể bao gồm các biến
    
-   **Loại hành động**: Nút URL cho thanh toán, đặt chỗ, trang web, v.v.
    

## **Điều kiện tiên quyết**

Trước khi sử dụng Mẫu nội dung Twilio:

1.  **Tài khoản Twilio**: Tài khoản Twilio đang hoạt động có quyền truy cập WhatsApp Business API
    
2.  **Mẫu đã được phê duyệt**: Các mẫu được tạo và phê duyệt trong Twilio Console
    
3.  **Tích hợp SquareHub**: Kênh WhatsApp Twilio được cấu hình trong SquareHub
    
4.  **Tài khoản WhatsApp Business**: Hồ sơ WhatsApp Business đã được xác minh
    

## **Thiết lập mẫu**

1.  Đăng nhập vào [Twilio Console](https://console.twilio.com/) của bạn
    
2.  Điều hướng đến **Messaging** → **Content Template Builder**
    
3.  Nhấp vào **Create new template**
    
4.  Chọn loại mẫu: **Text**: Cho tin nhắn văn bản đơn giản, **Media**: Cho hình ảnh, video hoặc tài liệu, **Quick Reply**: Cho các nút tương tác
    
5.  Cấu hình mẫu dựa trên mục đích.
    
6.  Gửi mẫu để WhatsApp phê duyệt
    
7.  Chờ phê duyệt (5 phút đến 24 giờ)
    
8.  Các mẫu được phê duyệt sẽ nhận được ContentSid
    
9.  Các mẫu hiện đã sẵn sàng để sử dụng trong SquareHub
    

## **Đồng bộ hóa mẫu với SquareHub**

**Tự động đồng bộ qua API**

Các mẫu được tự động đồng bộ khi bạn:

1.  Mở cửa sổ mẫu nội dung trong một cuộc hội thoại
    
2.  Tạo cuộc hội thoại mới với kênh WhatsApp Twilio
    

**Đồng bộ thủ công**

Dành cho quản trị viên inbox:

1.  Vào **Cài đặt** → **Inboxes**
    
2.  Chọn inbox WhatsApp Twilio của bạn
    
3.  Nhấp vào nút **Sync Templates**
    
4.  Chờ thông báo hoàn tất đồng bộ
    

## **Sử dụng 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 trình soạn thảo tin nhắn, Chọn **“WhatsApp Templates”** từ menu thả xuống

![](/assets/images/46882472_CleanShot_2025-08-26_at_13.49.16_2x.png)

#### **Bước 2: Chọn mẫu của bạn**

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

![](/assets/images/d2f9f57f_CleanShot_2025-08-26_at_13.51.19_2x.png)

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

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

![](/assets/images/37b9929a_CleanShot_2025-08-26_at_13.51.56_2x.png)

## **Thực hành tốt nhất**

**Thiết kế mẫu**

-   Giữ tin nhắn ngắn gọn và rõ ràng
    
-   Sử dụng biến để cá nhân hóa
    
-   Đảm bảo các tệp phương tiện được tối ưu hóa và có thể truy cập
    
-   Kiểm tra mẫu trước khi gửi phê duyệt
    

**Sử dụng biến**

-   Sử dụng tên biến mô tả trong Twilio Console
    
-   Cung cấp ví dụ rõ ràng để phê duyệt
    
-   Giữ số lượng biến hợp lý (dưới 10 để có trải nghiệm người dùng tốt nhất)
    

**Hướng dẫn đa phương tiện**

-   Lưu trữ tệp phương tiện trên các máy chủ đáng tin cậy, nhanh chóng
    
-   Sử dụng URL HTTPS cho tất cả phương tiện
    
-   Tối ưu hóa kích thước tệp để gửi nhanh hơn
    
-   Bao gồm văn bản dự phòng cho các mẫu đa phương tiện
    

**Tuân thủ**

-   Tuân thủ hướng dẫn Chính sách doanh nghiệp WhatsApp
    
-   Đảm bảo các mẫu phục vụ mục đích kinh doanh hợp pháp
    
-   Tôn trọng quyền riêng tư và sự đồng ý của người dùng
    
-   Theo dõi hiệu suất mẫu và trạng thái phê duyệt
    

## **Khắc phục sự cố**

**Các vấn đề thường gặp**

**Mẫu không hiển thị**

-   **Nguyên nhân**: Mẫu chưa được WhatsApp phê duyệt
    
-   **Giải pháp**: Kiểm tra trạng thái phê duyệt trong Twilio Console
    

**Đồng bộ mẫu thất bại**

-   **Nguyên nhân**: Sự cố kết nối API hoặc thông tin xác thực không hợp lệ
    
-   **Giải pháp**: Xác minh thông tin xác thực Twilio và thử đồng bộ lại
    

**Phương tiện không tải được**

-   **Nguyên nhân**: URL phương tiện không thể truy cập hoặc sai định dạng
    
-   **Giải pháp**: Xác minh URL có thể truy cập công khai, Kiểm tra định dạng tệp và giới hạn kích thước, Đảm bảo giao thức HTTPS
    

**Biến không hoạt động**

-   **Nguyên nhân**: Định dạng biến không đúng hoặc thiếu giá trị
    
-   **Giải pháp**: Sử dụng đúng định dạng `{{1}}`, `{{2}}` trong Twilio, Điền tất cả các biến bắt buộc trong SquareHub, Kiểm tra số lượng biến khớp với mẫu
    

## **Thông báo lỗi**

**“Template not found”**

-   Mẫu chưa được đồng bộ với SquareHub
    
-   Chạy đồng bộ thủ công hoặc kiểm tra phê duyệt mẫu
    

**“Media file too large”**

-   Tệp vượt quá giới hạn của WhatsApp
    
-   Nén tệp hoặc sử dụng định dạng khác
    

**“Invalid template parameters”**

-   Thiếu hoặc sai giá trị biến
    
-   Xem xét và điền đầy đủ tất cả các trường bắt buộc
    

## **Ví dụ mẫu**

**Mẫu văn bản cơ bản**

```

Name: welcome_message

Content: "Welcome to {{1}}! We're excited to help you with {{2}}."

Variables: Company name, Service type
```

**Trình bày sản phẩm (Mẫu đa phương tiện)**

```

Name: product_launch

Media: Product image

Content: "🎉 New arrival! {{1}} is now available for {{2}}. Limited time offer!"

Variables: Product name, Price
```

**Xác nhận đơn hàng (Mẫu văn bản)**

```

Name: order_confirmed

Content: "Hi {{1}}! Your order {{2}} has been confirmed. Delivery expected: {{3}}."

Variables: Customer name, Order ID, Delivery date
```

**Mẫu trả lời nhanh**

```

Name: support_options

Content: "How can we help you today?"

Buttons: "Technical Support", "Billing", "General Info"
```

## **Giới hạn**

**Các giới hạn hiện tại**

-   Mẫu không được hỗ trợ trong các chiến dịch (sẽ có trong các bản cập nhật tương lai)
    
-   Mẫu chọn danh sách
    
-   Mẫu danh mục
    
-   Mẫu carousel
    

**Giới hạn mẫu**

-   Tối đa 100 biến mỗi mẫu
    
-   Tệp phương tiện phải có thể truy cập công khai
    
-   Mẫu yêu cầu phê duyệt từ WhatsApp
    
-   Yêu cầu đánh số tham số tuần tự
    

## **Hỗ trợ**

Để được hỗ trợ thêm:

-   Xem [Tài liệu Twilio WhatsApp](https://www.twilio.com/docs/whatsapp)
    
-   Xem [Hướng dẫn Nền tảng WhatsApp Business](https://developers.facebook.com/docs/whatsapp/business-platform)
    
-   Liên hệ quản trị viên hệ thống của bạn cho các vấn đề kỹ thuật
    
-   Tham khảo tài liệu SquareHub để biết hướng dẫn chung về nền tảng