GetMyBot 知識庫

使用者(CRM)

尋找客戶、查看對話、新增標籤,以及保存電話等資料;了解客戶卡片、篩選與匯出。

本頁內容

使用者頁面收集曾向機器人傳訊的客戶。開啟客戶卡片,可查看對話、檔案及已保存的資料,例如電話、感興趣的課程或付款狀態。卡片會隨事件自動建立及更新。

這種客戶資料庫也稱 CRM。標籤可標出「已付款」等群組;參數則保存 phone、order_id 等具體值。

使用者清單

表格顯示姓名、Telegram ID、標籤和活動狀態,例如最後一次活動或是否封鎖機器人。可按姓名或 ID 搜尋,亦可使用全部、VIP、已付款、新使用者、取消訂閱快速篩選;各按鈕旁會顯示人數。點擊一列即可開啟對話。

已封鎖機器人按鈕只顯示封鎖者,封鎖日期可在卡片查看。匯出 CSV 會按目前搜尋及篩選結果下載清單,最多 10,000 列。檔案欄位為 tg_user_id, name, username, platform, is_blocked, blocked_at, first_seen, last_seen, labels;標籤以 ; 分隔,日期採 RFC3339 格式。文字儲存格會防止在試算表中被當作公式執行。若達到列數上限,API 會回傳 X-Export-Truncated: true。

API 範例:GET /api/bots/{botID}/users?is_blocked=true&format=csv。is_blocked=true|false 也可用於一般 JSON 清單;封鎖者資料會有 blocked_at 欄位。

客戶卡片保存什麼

卡片包含頭像、姓名、@username、「在 Telegram 開啟」連結、訊息數、第一次及最近一次對話、標籤和全域參數。也會標示使用者是否封鎖機器人,或正在等待客服回覆。

訂閱者來源顯示對方第一次從哪條連結進入機器人,例如可用不同的春季廣告連結區分訪客。辨識廣告來源的值稱為 UTM 標記。Telegram 連結中 start= 後的部分稱為啟動標記(payload)。

  • Telegram:t.me/<bot>?start=utm_source-vk__utm_medium-cpc__utm_campaign-spring。payload 只可包含英文字母、數字、_ 和 -;項目以 __ 分隔,鍵和值由第一個 - 分開。
  • VK:vk.me/<group>?ref=utm_source=vk&utm_medium=post。
  • 推薦連結:t.me/<bot>?start=ref_<他的 ID>。卡片和 {{referrals.count}} 可顯示邀請人數。ref=<ID> 和 ref_<ID> 會與 UTM 分開解析。

平台保存 utm_source、utm_medium、utm_campaign、utm_content、utm_term 五個欄位,各取第一個非空值。可在變數替換及受眾群組中以 attribution.utm_source 等欄位使用。

來源在第一次帶非空標記的啟動連結固定,稱為 first-touch。後續 /start 不會改變來源,也不會補入新連結的 UTM。如果第一條標記是一般文字或推薦連結,UTM 欄位會保持空白;沒有標記的連結不會設定來源。

建立受眾群組時,啟動連結的 UTM 優先於同名的網站造訪標記;連結沒有提供的欄位可由網站資料補足,沒有 UTM 的連結不會清除網站資料。來源屬於第一次啟動所用的頻道,只有同一頻道、同一訂閱者 ID 的資料在重新計算後才會進入受眾群組。

標籤

標籤可標示「VIP」、「已付款」、「新使用者」等群組,也可自訂名稱和顏色。可手動新增,或由變更標籤動作加入,再用於條件和群發受眾。

標籤可永久有效,也可在指定天數後自動移除並觸發標籤到期事件。API 使用 POST /api/bots/{botID}/users/{tgUserID}/labels,須提供標籤的標準 UUID label_id,可選填 ttl_days(0 至 106751)。ttl_days: 0 表示永久;臨時標籤的到期時間在使用者清單的 label_expires_at 欄位。

參數

參數保存使用者的任意資料,例如姓名、Email、金額、訂單狀態或分數。變更參數、儲存訊息動作及對話步驟會填入資料。之後可用 {{param.鍵}} 插入訊息,或在條件中檢查,無須外部資料庫。

對話

對話顯示文字、相片、影片、語音、文件、按鈕及送達標記;發出的反應各有獨立卡片。底部可直接回覆、附加檔案,或從清單傳送反應。

附件

附件按鈕會開啟對話檔案庫,可篩選相片、檔案、語音及連結,亦可按全部下載。

對話歷史與匯入

對話會保存與使用者的完整通訊記錄。向上捲動才會分批載入舊訊息,因此長對話不必等整份歷史下載完才能開啟。開啟中的對話會即時顯示新訊息,與客服收件匣相同。

從 sambot 移轉時,對話歷史會連同使用者資料匯入,卡片可立即顯示舊訊息及附件。詳見從 sambot 匯入。

客戶卡片與大量操作

卡片整合個人資料、事件時間軸、受眾群組、對話和客服備註。事件會分批載入,可按類型、來源與期間篩選。修改屬性或標籤後須儲存,變更會進入操作記錄並觸發受眾群組更新。

可在清單選取多位客戶,批次套用屬性。操作使用已保存的選中受眾快照,最多 5,000 人,重複提交不會重複套用。CSV 匯出會建立另一項已保存操作,下載前可取消;已套用的大量變更無法局部撤回。

合併檔案

專案擁有者可在同一清單頁選擇兩個人,再選擇合併檔案。檢查聯絡方式與管道,選擇主要檔案並確認。歷史紀錄與資料將合併;欄位衝突時以主要檔案為準。合併無法復原。

請先完成或檢查尚未結束的 CRM 同步或 Ozma 操作,並解決衝突的聯絡資訊以及指向不同 CRM 紀錄的關聯。

相同的電子郵件不會自動合併檔案。使用帶簽章的 identify 連結網站已登入使用者;只有所在地區啟用功能後,才能使用已確認的 Telegram 連結;僅連接渠道並不足夠。

下一步

動態受眾群組

在受眾群組中使用「且」或「或」條件定義受眾,儲存前先預覽。資料變更後須重新計算成員,並在用於群發前確認受眾群組已就緒;只儲存定義不代表成員人數已更新。