GetMyBot 知識庫

內容工作室

準備一次訊息並用於群發或網站:草稿、發佈、變數替換與發送前檢查。

本頁內容

在**「內容」中可以準備訊息並在多處使用。例如將同一份已發佈課程介紹送到 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 呈現方式不同。

修改郵件元素

在視覺編輯器選元素後,可在檢查面板修改文字、連結、圖片或容器屬性。欄位失焦後才套用。連結同時有目的網址與可見文字;圖片的替代文字供看不到圖片的收件者閱讀。

遇到問題時

  1. 「禁止的變數替換」:路徑不在此情境的允許清單中,或有拼寫錯誤。請用選擇器插入。
  2. 「缺少變數值」:收件者沒有允許欄位的值。請在文件設定加入後備值。
  3. 發佈回傳 409:他人已修改文件。重新載入再發佈。
  4. 無法封存:啟用的彈出視窗、進行中的活動或 Push 群發仍引用文件。
  5. 無法測試發送:已連接頻道中尚無已驗證且未排除的聯絡人。

下一步