Studio nội dung
Chuẩn bị một tin nhắn dùng lại trong đợt gửi hoặc trên website: bản nháp, xuất bản, biến thay thế và kiểm tra.
Trên trang này
Trong Nội dung, bạn tạo tin một lần rồi dùng ở nhiều nơi. Ví dụ, cùng chương trình khóa học có thể gửi qua Telegram và VK. Văn bản, hình và nút cùng tạo thành tài liệu nội dung. Email, pop-up và push có loại tài liệu riêng.
Hãy tạo bản nháp, xem thử theo kênh rồi xuất bản phiên bản. Tài liệu Tin nhắn dùng được ở nhiều messenger và web chat nhưng phải kiểm tra/hiển thị theo từng kênh.
Sửa nội dung cần cùng quyền bot như sửa phản ứng. Thiếu quyền, bạn chỉ xem được tài liệu, không tạo, sửa, xuất bản, lưu trữ hay gửi thử.
Tài liệu, bản nháp và phiên bản
Mỗi tài liệu có loại quyết định nơi dùng: Tin nhắn, Email, Pop-up, Trong ứng dụng, Push, Trả lời nhanh, Lead bot. Tài liệu Push dùng cho push trình duyệt và di động trong gửi hàng loạt hoặc chiến dịch.
Mỗi tài liệu có đúng một bản nháp sửa được và nhiều phiên bản đã xuất bản:
- Sửa chỉ đổi bản nháp.
- Xuất bản chốt bản nháp thành phiên bản bất biến, rồi tạo bản nháp mới với cùng nội dung.
- Phiên bản đã xuất bản không bị ghi đè. Đợt gửi đã lên lịch hoặc pop-up đang bật giữ đúng phiên bản được gắn.
Ví dụ, đợt gửi dùng phiên bản 2. Bạn sửa bản nháp và xuất bản phiên bản 3 cũng không đổi đợt đó; muốn dùng tin mới, hãy chọn phiên bản mới trong đợt gửi hoặc pop-up.
Lưu có kiểm tra chỉnh sửa đồng thời: giao diện gửi phiên bản và revision đã đọc, máy chủ trả 409 nếu ai khác sửa trước. Tải lại rồi thử tiếp.
Lưu trữ đưa tài liệu ra khỏi danh sách. Không thể lưu trữ khi pop-up đang bật, chiến dịch email đã lên lịch/đang chạy/tạm dừng hoặc đợt push đã nhận/đang chạy còn tham chiếu tới nó. Hãy gỡ tham chiếu trước.
Khối và giới hạn
Tài liệu gồm các khối:
- Văn bản, Tiêu đề, Danh sách, Đường phân cách có thể định dạng.
- Ảnh, Tệp, Video từ thư viện media hoặc URL, có chú thích.
- Nút chứa liên kết hoặc dữ liệu thao tác khi bấm (
callback). - Cột nhóm tối đa bốn khối con. Khi gửi, khối con vẫn đi lần lượt; kênh không hỗ trợ cột thêm cảnh báo
columns_flattened. - Nội dung có điều kiện chỉ hiện khi điều kiện đúng.
Máy chủ kiểm tra khi lưu và xuất bản:
- Tên 1–120 ký tự.
- Ít nhất một khối, tối đa 200 khối tổng.
- Lồng sâu tối đa 8.
- Tối đa 10 nút ở cùng một cấp.
- Khối Cột tối đa 4 khối con.
- Mỗi khối có ID duy nhất trong tài liệu.
Máy chủ cũng kiểm tra mọi tệp media thuộc chính bot này. Dữ liệu lọt qua kiểm tra trình duyệt vẫn có thể bị từ chối ở máy chủ.
Biến thay thế
Biến có hai dấu ngoặc nhọn và được điền lúc gửi:
Xin chào {{profile.first_name}}! Đơn {{event.order_id}} đang được giao.
Chỉ bốn dạng được phép:
{{profile.<field>}}: trường hồ sơ người nhận.{{event.<field>}}: trường sự kiện hiện tại.{{system.unsubscribe_url}}: URL hủy đăng ký riêng cho người này.{{system.current_date}}: ngày hiện tại dạngYYYY-MM-DD.
Dạng khác bị từ chối. Nội dung không chạy JavaScript, SQL, trình tạo mẫu hoặc HTTP.
Không phải mọi trường hồ sơ đều tự dùng được. Chỉ các trường profile và event được nơi gửi cung cấp mới nằm trong danh sách cho phép. Dùng trường khác sẽ báo «biến không được phép» dù trường đó tồn tại trong cơ sở dữ liệu.
Nếu trường được phép nhưng thiếu giá trị, tài liệu báo lỗi trừ khi có giá trị dự phòng trong fallbacks, khóa là toàn đường dẫn:
{ "fallbacks": { "profile.first_name": "bạn" } }
Giá trị dự phòng chỉ được đặt cho đường dẫn đã được phép và tối đa 16.000 ký tự.
Hệ thống tự thoát ký tự theo vị trí: giá trị trong văn bản HTML được escape HTML, trong URL được percent-encode. system.* trong URL không mã hóa lại vì vốn là URL hoàn chỉnh.
Khối có điều kiện
Có thể gắn điều kiện lên mọi khối, còn Nội dung có điều kiện nhóm nhiều khối dưới cùng điều kiện. Điều kiện nội dung hẹp hơn điều kiện phân khúc: lúc hiển thị chỉ có hồ sơ và sự kiện hiện tại.
- Chủ thể: chỉ
profilehoặcevent. - Toán tử:
eq,ne,gt,lt,ge,le,gte,lte,exists,not_exists,contains,not_contains,in,not_in,between,before,after,has_any,not_has_any. - Không hỗ trợ điều kiện có cửa sổ thời gian như «trong N ngày qua».
Điều kiện cần dữ liệu không có lúc hiển thị bị đánh dấu condition_unsupported; điều kiện sai là condition_invalid. Ngay cả phiên bản đã xuất bản trước đây cũng qua kiểm tra này trước khi gửi, nên lỗi xuất hiện ở khâu kiểm tra thay vì lỗi giao nhận.
Kiểm tra theo kênh và xem trước
Kiểm tra hiển thị phiên bản theo khả năng kênh thật và trả hai danh sách.
Lỗi chặn xuất bản và gửi:
text_too_long: vượt giới hạn văn bản của kênh.media_missing: khối media không có tệp hay URL.media_unsupported: kênh không hỗ trợ loại đính kèm.button_unsupported: kênh không có nút inline, nút cũng không có URL để chuyển thành liên kết.invalid_document: vi phạm cấu trúc.condition_invalid,condition_unsupported.
Cảnh báo không chặn, nhưng cho biết cách nội dung được đơn giản hóa:
columns_flattened: khối con của cột đi nối tiếp.format_flattened: định dạng không hỗ trợ thành văn bản thường.button_as_link: nút thành liên kết.missing_image_alt: ảnh thiếu văn bản thay thế.vague_link_text: nhãn nút rỗng hoặc chung chung như «click here», «here», «link», «more».
Bản xem trước hiển thị theo kênh Website, Email, Telegram, VK hoặc WhatsApp trên máy tính và điện thoại. Chọn người nhận thật để điền dữ liệu của họ và phát hiện lỗi biến trước khi gửi. Cùng tài liệu có thể hợp lệ ở kênh này nhưng bị chặn ở kênh khác. Email, chẳng hạn, giữ cột/HTML, gửi ảnh và tệp nhưng không gửi video; nút thành liên kết với cảnh báo button_as_link.
Gửi thử
Gửi thử đi qua cùng bước kiểm tra, hiển thị và hàng đợi như gửi thật, nhưng chỉ cho một người nhận. Không thể nhập email hoặc chat ID bất kỳ; chọn trong danh sách liên hệ bot đã có thể gửi.
Yêu cầu bị từ chối nếu:
- Liên hệ chưa xác minh (
422). - Liên hệ bị loại, ví dụ đã hủy đăng ký hoặc địa chỉ không giao được (
409). - Tài liệu đổi sau khi tải (
409). - Kênh không có trong cài đặt hiện tại (
422). - Nội dung không hiển thị hợp lệ trên kênh (
422). - Hết hạn mức kênh (
409). - Gửi thử quá thường xuyên (
429): tính theo tài khoản, cho phép ba lần liên tiếp, sau đó một lần mỗi 15 giây.
Thành công trả 202 và đưa tin vào hàng đợi để hệ thống thông thường giao tiếp.
Mẫu
Mẫu là điểm khởi đầu: chọn mẫu sẽ sao chép khối vào bản nháp mới, không tạo liên kết sống. Sửa mẫu sau này không đổi tài liệu đã tạo.
Thư viện gồm mẫu có sẵn trong cài đặt và mẫu của bot; nếu chưa có thì rỗng. Giao diện hiện chưa có nút Lưu thành mẫu. Mẫu bot được tạo/xóa qua API (POST /api/bots/{botID}/content-templates).
Chủ đề, kích thước và khoảng cách
Chủ đề tài liệu đặt phông và màu chung; có thể sửa riêng khối trong inspector. Padding tách nội dung khỏi viền, margin tách khối khỏi khối bên cạnh. Khoảng cách dùng pixel; chiều rộng phần trăm tính theo vùng nội dung.
Chiều cao dòng là hệ số: 1.5 nghĩa là cách dòng một rưỡi. Kiểm tra xuống dòng ở bản xem trước rộng và di động. Tùy chọn khác theo kênh; bước kiểm tra cảnh báo khi giản lược giao diện hoặc gửi các cột nối tiếp.
HTML nguồn của email
Email có chế độ trực quan và HTML. Sau khi sửa HTML nguồn, hãy đợi kiểm tra. Nếu lỗi, sửa trước khi chuyển lại trực quan hoặc lưu.
Nhập HTML có thể biến đổi phần tử không hỗ trợ. Xem lại và thử trong ứng dụng email của người nhận vì cách hiển thị HTML khác nhau.
Sửa phần tử email
Chọn phần tử trong trình sửa trực quan rồi sửa thuộc tính ở inspector: văn bản, liên kết, ảnh hoặc vùng chứa. Giá trị trường được áp dụng khi rời khỏi trường. Liên kết có URL và nhãn nhìn thấy; ảnh có văn bản thay thế cho người không xem được ảnh.
Nếu gặp vấn đề
- Biến không được phép: đường dẫn không nằm trong danh sách cho phép hoặc sai chính tả. Dùng bộ chọn biến thay vì gõ tay.
- Thiếu biến: người nhận không có giá trị cho trường được phép. Thêm
fallbacks. - Xuất bản trả
409: ai khác đã sửa tài liệu. Tải lại rồi xuất bản. - Không lưu trữ được: pop-up bật, đợt gửi còn chạy hoặc push đang tham chiếu.
- Không gửi thử được: bot chưa có liên hệ đã xác minh và không bị loại trong kênh đã kết nối.
Bước tiếp theo
- Chiến dịch email: gửi phiên bản đã xuất bản.
- Widget trên website: pop-up dùng tài liệu Pop-up.
- Thư viện media: tệp ảnh, video.
- Điều kiện: mô hình điều kiện đầy đủ.