內容工作室
準備一次訊息並用於群發或網站:草稿、發佈、變數替換與發送前檢查。
本頁內容
在**「內容」中可以準備訊息並在多處使用。例如將同一份已發佈課程介紹送到 Telegram 和 VK。文字、圖片和按鈕合稱內容文件**;email、彈出視窗和推播則各有對應的文件型別。
先準備草稿,在目標頻道預覽,再發佈版本。訊息文件可供多個通訊軟體和網站聊天使用,但各頻道會獨立檢查和呈現。
編輯需要與反應相同的機器人權限。缺少權限時,仍可查看文件,但不能建立、修改、發佈、封存或測試發送。
文件、草稿與版本
每份文件都有決定用途的型別:訊息、Email、彈出視窗、應用程式內、Push 通知、快速回覆、潛在客戶機器人。Push 文件可供群發或活動中的瀏覽器與行動推播使用。
一份文件始終只有一份可編輯草稿,可有任意數量的已發佈版本:
- 編輯只改目前草稿。
- **「發佈」**將草稿固定為不可變版本,並立即開啟內容相同的新草稿。
- 已發佈版本不會被改寫;已排程群發或啟用的彈出視窗持續使用當初選定的版本。
例如群發已選版本 2,後來修改草稿並發佈版本 3,不會改變那筆群發。要使用新文字,請在群發或彈出視窗中重新選版本。
儲存會檢查並行修改:介面傳回載入時的版本和修訂號,若他人已修改,伺服器回傳 409。請重新載入再試。
**「封存」**會從清單移除文件。若啟用的彈出視窗、已排程/發送中/已暫停的 email 活動,或已接受/發送中的 Push 群發仍引用它,不能封存;先移除引用。
區塊與限制
文件由區塊組成:
- 文字、標題、清單、分隔線:可選格式化的文字。
- 圖片、檔案、影片:媒體庫檔案或網址,及說明文字。
- 按鈕:連結文字或點擊時送出的
callback資料。 - 欄位組:最多四個子區塊,在編輯器中分組;發送時按順序輸出。不支援欄位組的頻道會顯示
columns_flattened警告。 - 條件式內容:只有條件成立時顯示的區塊組。
儲存和發佈都由伺服器檢查:文件名稱 1–120 字元、至少 1 個且最多 200 個區塊、巢狀最多 8 層、同層最多 10 個按鈕、欄位組最多 4 個子區塊;每個區塊需有文件內唯一 ID。所有媒體還須屬於這個機器人。即使瀏覽器放行,伺服器仍可能拒絕。
變數替換
雙大括號中的值會在發送時替換:
你好,{{profile.first_name}}!訂單 {{event.order_id}} 已出貨。
只支援四種形式:
{{profile.<欄位>}}:收件者客戶資料欄位。{{event.<欄位>}}:目前事件欄位。{{system.unsubscribe_url}}:該收件人的退訂連結。{{system.current_date}}:YYYY-MM-DD格式的當前日期。
其他形式都會被拒絕。內容不能執行 JavaScript、SQL、範本程式或 HTTP 請求。
文件不能任意讀取所有客戶欄位,只能使用發送位置提供的 profile、event 允許清單。清單外欄位會報「禁止的變數替換」,即使資料庫中有該值。
允許欄位若沒有值,且文件未提供後備值,也會報錯。後備值放在 fallbacks 中,鍵名是完整路徑:
{ "fallbacks": { "profile.first_name": "朋友" } }
後備值只可對允許的路徑使用,最多 16,000 字元。平台會依插入位置自動跳脫:HTML 格式文字以 HTML 跳脫,URL 以百分比編碼;system.* 在 URL 中不重複編碼,因它們已是完整連結。
條件式區塊
任何區塊都可加條件;條件式內容可讓數個區塊共用一個條件。內容的條件刻意比區隔條件少,因為渲染時只有客戶資料和目前事件。
- 主體只能是
profile或event。 - 運算子:
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。 - 不支援「最近 N 天」等時間視窗條件。
需要渲染時不可用資料的條件回傳 condition_unsupported,格式錯誤回傳 condition_invalid。舊已發佈版本在發送前也接受相同檢查,問題會在驗證時顯示,而非等到送達失敗。
依頻道檢查與預覽
**「檢查」**會依選定頻道的實際能力渲染文件,回傳錯誤與警告兩份清單。
阻止發佈和發送的錯誤:
text_too_long:文字超過頻道限制。media_missing:圖片、檔案或影片區塊既無檔案也無網址。media_unsupported:頻道不支援該附件。button_unsupported:頻道不支援 inline 按鈕,且按鈕沒有可轉成普通連結的網址。invalid_document:違反上述結構規則。condition_invalid、condition_unsupported:條件錯誤或不支援。
警告不阻止發送,但說明內容如何簡化:
columns_flattened:不支援欄位組,子區塊按順序發送。format_flattened:不支援格式,改用純文字。button_as_link:按鈕改成普通連結。missing_image_alt:圖片缺少替代文字。vague_link_text:按鈕文字為空,或是「click here」、「here」、「link」、「more」。
預覽可在桌面或手機模型查看網站、Email、Telegram、VK、WhatsApp 頻道。選擇真實收件者後,會以其資料渲染,發送前就能發現變數替換錯誤。
同一文件可能在一個頻道通過,在另一個頻道被阻止。例如 Email 保留欄位組與 HTML 格式,支援圖片和檔案、不支援影片,按鈕會轉為連結(button_as_link)。
測試發送
測試發送使用與正式送達相同的驗證、渲染和佇列流程,但只對一位收件者。不能輸入任意 email 或聊天 ID,只能選機器人已有且可送達的聯絡人。
以下情況會拒絕:
- 聯絡方式未驗證(
422)。 - 聯絡人被排除,例如退訂或地址無法送達(
409)。 - 載入後文件已改變(
409)。 - 此部署未提供頻道(
422)。 - 內容無法在所選頻道渲染(
422)。 - 頻道額度已用盡(
409)。 - 短時間測試過多(
429):帳號可連續三次,此後每 15 秒一次。
成功回傳 202,訊息進入佇列,由一般發送程序送達。
範本
範本是起始內容。選用時會把區塊複製到新草稿,不保留即時連結;之後修改範本不影響已建立文件。
範本庫顯示平台提供和此機器人的範本,沒有時為空。目前沒有「儲存為範本」按鈕;機器人範本需透過 API 建立或刪除(POST /api/bots/{botID}/content-templates)。
主題、尺寸與間距
文件主題設定共用字型和顏色;區塊可在檢查面板單獨修改。內距分隔內容與邊框,外距分隔相鄰區塊。間距使用像素,區塊寬度百分比以內容區域為基準。
行高是倍率,例如 1.5 表示 1.5 倍行距。請在桌面和手機預覽換行。可用外觀設定依頻道而異;驗證會指出格式簡化或欄位組按順序輸出。
郵件原始 HTML
Email 可在視覺模式與 HTML 原始碼間切換。改動原始碼後請等驗證完成;出錯時,先修正 HTML,再切回視覺模式或儲存。
匯入時可能改寫不支援的元素。請檢查結果,並在收件者實際使用的郵件客戶端測試,因不同客戶端的 HTML 呈現方式不同。
修改郵件元素
在視覺編輯器選元素後,可在檢查面板修改文字、連結、圖片或容器屬性。欄位失焦後才套用。連結同時有目的網址與可見文字;圖片的替代文字供看不到圖片的收件者閱讀。
遇到問題時
- 「禁止的變數替換」:路徑不在此情境的允許清單中,或有拼寫錯誤。請用選擇器插入。
- 「缺少變數值」:收件者沒有允許欄位的值。請在文件設定加入後備值。
- 發佈回傳
409:他人已修改文件。重新載入再發佈。 - 無法封存:啟用的彈出視窗、進行中的活動或 Push 群發仍引用文件。
- 無法測試發送:已連接頻道中尚無已驗證且未排除的聯絡人。