FIRST LINE 企業級客服系統
🫱 官方網站🔥 最新消息
  • ❤️關於 FIRST LINE
    • 🥰客服中心
    • 📔更新日誌
      • 🐍2025
      • ☎️電話管理系統
      • 🍱Archive
        • 🐲2024
        • 🐰2023
        • 🐯2022
        • 🐮2021
        • 🐭2020
  • 指南與解答
    • 🚀指南
      • 🤖打造專屬聊天機器人
      • 🧠FIRST LINE AI
      • 🏗️管理者系統建置
      • 👋客服人員:訊息服務
      • 📥服務台:解決與紀錄客戶問題
      • 🔃交談分派的運作模式
      • 💬3 種 WhatsApp 帳號種類大解析!
    • 📔名詞解釋
    • ❓系統疑難
      • ⚠️提示或告警訊息
      • 📶網路離線提醒
      • 🌎支援的瀏覽器
      • 🪠清除瀏覽器快取
  • 功能教學
    • 💬管道
      • 💬即時聊天
        • 疑難雜症
        • 客戶身份驗證
        • 安裝範例
          • 嵌入至 LINE 內服務客戶
          • 安裝於 SHOPLINE 內
          • 安裝於 Shopify 內
      • 💬LINE 官方帳號
        • 如何啟用 Messaging API
        • LINE 訊息費用怎麼算
        • LINE Developer 相關
      • 💬Facebook Messenger
        • 疑難雜症
        • 錯誤代碼 #2022
      • 💬Instagram
      • 💬微信公眾號
      • 💬WhatsApp (Cloud API)
        • 疑難雜症
      • 💬WhatsApp (Twilio)
      • 💬Telegram
      • 💬Viber
      • 📮電子信箱
        • 電子郵件分隔文本
        • 電子郵件附件
        • Gmail 串接測試
      • 📱簡訊
        • Twilio
        • 三竹簡訊
      • ☎️電話
        • ❓疑難雜症
        • 👨‍💻調整或分配分機給專員
        • 📕通話時服務紀錄沒有建立
        • ⤴️轉接與三方通話
        • 😃座席狀態
        • ☎️電話 SIP 代碼
        • 📊通話資訊
      • 🏪線上下通路
    • 📈儀錶板
      • 📊服務水平
      • ☎️電話
      • ☎️專員電話即時狀態
      • 😃社群媒體好友數
      • 📈訊息統計
      • 💬交談佇列
    • 😀客戶關係管理
      • 😀客戶
        • 🔃客戶合併
      • 🏢公司
      • ⬇️匯入客戶
      • 匯入自訂表格
      • 🤝服務紀錄
        • 💬交談紀錄
      • 🔖服務結果
      • ✏️服務原因
      • 自訂欄位
      • 資料匯出
      • 電話紀錄
    • 🤖聊天機器人
      • 📒交談腳本
        • ❓疑難雜症
        • 🚀功能詳解
          • 🧠FIRST LINE AI
          • 📃模組腳本
          • 🔜分派權重
          • 📒事件紀錄
          • 📔草稿與發佈
          • 🗂️輪播訊息
          • 🔘按鈕行為
        • 🎬情境範例
          • 串接 ChatGPT
          • 搜尋與回覆知識庫文章
          • 緊急信件轉派
          • 封鎖名單
          • Webhook 整合指南
          • 如何透過 API 溝通
        • 📊統計數字
        • 從即時聊天 URL 添加數據
      • 😀滿意度調查
      • 🧠AI 訓練資源
      • 🕐營業時間
      • 🤖自動回應
        • 關鍵字回應
    • 💡知識庫
      • 幫助中心
        • 擴充自訂義 HTML
      • 聊天機器人
    • 🎟️工單
      • 工單範本
      • 關注工單
      • 透過電子信箱發送
      • 狀態細項
    • 🛍️行銷
      • 🛍️產品目錄
      • 📢分眾訊息
        • 自動化活動
      • 🎡LINE 圖文選單
      • 📃貼文自動回覆
      • 😁對話角色
      • 🎟️優惠卷
      • 🔗追蹤連結
    • 🔌整合
      • 🚗自動化
        • 範例:發送 LINE 訊息
        • 範例:會員同步
        • 範例:發送 Teams 通知
      • ⛓️Webhook 腳本
    • 📃報表
      • ☎️電話
        • 專員通話效率
        • 通話紀錄報表
        • ACD 號碼分析
      • 服務紀錄明細與樞紐
      • 專員服務效率
      • 訊息管道樞紐
    • ⚒️輔助工具
      • 管道整合
      • 信件範本
      • 對話腳本
      • 訊息範本
    • ⚙️系統設定
      • 🏢企業
        • 🏢系統設定
        • 🧑‍🤝‍🧑部門
        • 💰帳務總覽
        • 🔥IP 允許清單
        • 組別
        • 業主
        • 🗺️地址
          • 縣市
          • 行政區域
          • 國家
        • 🔐權限
      • 😀客戶
        • 客戶分派
      • 🤝服務紀錄
        • 服務原因
      • 🎙️員工
        • 服務狀態
        • 更改或忘記密碼
      • 🗄️檔案管理
      • 💪技能
      • 👜職位
      • 💬開場白與話術
    • 🚀其他資料
      • 🔵Fancy 點數
      • 👨‍💻模板語法
      • 💬交談狀態
      • 🔍全域搜尋
      • 👨‍💻交談腳本變數
      • 📄資料欄位類型
      • 🌐IP 與網域清單
      • 💬各管道訊息類型支援度
    • ✊合作夥伴
      • 📞電話疑難雜症
      • 🎛️其他相關設定
  • 開發文件
    • API 說明
      • 請求方式說明
      • 回應物件資料
      • 😀客戶
      • 🔖客戶標籤
      • 🏢公司
      • ⬇️客戶匯入排程
      • ⬇️客戶自訂表格匯入排程
      • 📄自訂欄位主分類
      • 📄自訂欄位
      • 📄自訂表格
      • ☎️電話號碼
      • 🌎國家、縣市及區域
      • 🏠地址
      • 📧電子信箱
      • 🎫工單
      • 💬服務紀錄
      • 😃滿意度調查
      • 🛍️產品
      • 📄訂單
      • 📦訂單品項
    • Advanced
      • 透過 Hash 值取得 Text-Call ID
      • 透過 Text-Call ID 發送訊息
      • 搜尋聯絡人資料(Partner Limit)
      • Push (Partner Limit)
    • 即時聊天 Javascript API
Powered by GitBook
On this page
  • 列出指定客戶自訂表格
  • Parameters
  • 對指定客戶增加自訂表格紀錄
  • URL Parameters
  • Form Data
  • Response
  • 範例
  • 對指定客戶更新自訂表格紀錄
  • URL Parameters
  • Form Data
  • Response
  • 範例
  • 對指定客戶刪除自訂表格紀錄
  • URL Parameters
  • 對指定客戶刪除指定分類的自訂表格紀錄
  • URL Parameters
  1. 開發文件
  2. API 說明

自訂表格

Previous自訂欄位Next電話號碼

Last updated 12 months ago

列出指定客戶自訂表格

GET https://{API_HOST}/api/v1/contact/{contact}/contact-cz-relation
curl -X GET
    -H "Content-Type: application/json:Authorization: Bearer eyJhbGciOiJIUzI1NiI..." https://{API_HOST}/api/v1/contact/1/contact-cz-relation?cz_col_category_id=5

Parameters

Parameter

Required

Default

Type

DESCRIPTION

contact

true

Null

Number

cz_col_category_id

false

Null

Number

自訂欄位分類的 ID

請參考 回應格式


{
    "data": [
        {
            "id": 1,
            "relation_id": 1, // CzColCategory (自訂欄位分類) 的 id
            "relation_name": "健康檢查",
            "information": [
                {
                    "id": 1,
                    "value": 70,
                    "col_id": 1,
                    "col_name": "體重"
                },
                {
                    "id": 2,
                    "value": "A",
                    "col_id": 2,
                    "col_name": "血型"
                },
                {
                    "id": 3,
                    "value": [0,1],
                    "col_id": 3,
                    "col_name": "檢查項目"
                }
            ],
            "created_at": "2019-11-24 22:58:21",
            "updated_at": "2019-11-24 22:58:21"
        }
    ],
    "links": {
        "first": "https://firstline.localhost/api/contact/2197607/contact-cz-relation?page=1",
        "last": "https://firstline.localhost/api/contact/2197607/contact-cz-relation?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://firstline.localhost/api/contact/2197607/contact-cz-relation",
        "per_page": 15,
        "to": 1,
        "total": 1
    }
}

對指定客戶增加自訂表格紀錄

POST https://{API_HOST}/api/v1/contact/{contact}/cz-col-category/{cz_col_category}/contact-cz-relation

URL Parameters

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

contact

true

NULL

Number

cz_col_category

true

NULL

Number

Form Data

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

cz_cols

false

NULL

Array or Objects

動態欄位,參數型態參考 CzCol 表格說明

Cz_Col

此欄位為包含以下格式之陣列

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

id

true

NULL

Number

動態欄位的 id

value

true

NULL

String

動態欄位的值

Response


{
    "data": [
        {
            "id": 2,
            "relation_id": 1, // CzColCategory (動態關聯分類) 的 id
            "relation_name": "健康檢查",
            "information": [
                {
                    "id": 4,
                    "value": 65,
                    "col_id": 1,
                    "col_name": "體重"
                },
                {
                    "id": 5,
                    "value": "A",
                    "col_id": 2,
                    "col_name": "血型"
                },
                {
                    "id": 6,
                    "value": [1,2],
                    "col_id": 3,
                    "col_name": "檢查項目"
                }
            ],
            "created_at": "2019-11-25 22:58:21",
            "updated_at": "2019-11-25 22:58:21"
        }
    ],
    "links": {
        "first": "https://firstline.localhost/api/contact/2197607/contact-cz-relation?page=1",
        "last": "https://firstline.localhost/api/contact/2197607/contact-cz-relation?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://firstline.localhost/api/contact/2197607/contact-cz-relation",
        "per_page": 15,
        "to": 2,
        "total": 2
    }
}

範例

  • id=1, type=1 (字串), name='體重'

  • id=2, type=6 (單選), name='血型', options (選項)=[{"text": "A型", "value":"A"},{"text": "B型", "value":"B"},{"text": "O型", "value":"O"},{"text": "AB型", "value":"AB"}]

  • id=3, type=7 (多選), name='檢查項目', options (選項)=[{"text": "X光", "value": 0}, {"text": "抽血", "value": 1}, {"text": "量身高", "value": 2}]

參數範例如下:(注意不論是單選還是多選,都是丟 value,若誤丟 text 會導致前端顯示出現問題)

{
    "cz_cols": [
        {
            "id":1,
            "value":65
        },
        {
            "id":2,
            "value":"A"
        },
        {
            "id":3,
            "value":[1,2]
        }
    ]
}

Form Data cz_cols

[
    {"id":1, "value":"65"}, // 1: 體重
    {"id":2, "value":"A"}, // 2: 血型
    {"id":3, "value": [1, 2]} // 3. 檢查項目: 抽血+量身高
]

對指定客戶更新自訂表格紀錄

PUT https://{API_HOST}/api/v1/contact/{contact}/contact-cz-relation/{contact_cz_relation}

URL Parameters

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

contact

true

NULL

Number

contact_cz_relation

true

NULL

Number

Form Data

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

cz_cols

false

NULL

Array

動態欄位,參數型態參考 CzCol 表格說明

Cz_Col

此欄位為包含以下格式之陣列

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

id

true

NULL

Number

動態欄位的 id

value

true

NULL

String

動態欄位的值

Response


{
    "data": {
        "id": 1,
        "relation_id": 1, // CzColCategory 的 id
        "relation_name": "寶寶資料",
        "information": [
            {
                "id": 4,
                "value": 55,
                "col_id": 1,
                "col_name": "體重"
            },
            {
                "id": 5,
                "value": "A",
                "col_id": 2,
                "col_name": "血型"
            },
            {
                "id": 6,
                "value": [1,2],
                "col_id": 3,
                "col_name": "檢查項目"
            }
        ]
    }
}

範例

  • id=1, type=1 (字串), name='體重'

  • id=2, type=6 (單選), name='血型', options (選項)=[{"text": "A型", "value":"A"},{"text": "B型", "value":"B"},{"text": "O型", "value":"O"},{"text": "AB型", "value":"AB"}]

  • id=3, type=7 (多選), name='從事運動', options (選項)=[{"text": "籃球", "value": 0}, {"text": "跑步", "value": 1}, {"text": "游泳", "value": 2}]

參數範例如下: (注意不論是單選還是多選,都是丟 value,若誤丟 text 會導致前端顯示出現問題)


{
    "cz_cols": [
        {
            "id": 1, // 體重欄位的 id
            "value": 55
        }
    ]
}

Form Data cz_cols

[
    {"id":1, "value":"70"}, // 1: 體重
    {"id":2, "value":"AB"}, // 2: 血型
    {"id":3, "value": [1, 2]} // 3. 運動: 跑步+游泳
]

對指定客戶刪除自訂表格紀錄

DELETE https://{API_HOST}/api/v1/contact/{contact}/contact-cz-relation/{contact_cz_relation}
curl -X DELETE
    -H "Content-Type: application/json:Authorization: Bearer eyJhbGciOiJIUzI1NiI..." https://{API_HOST}/api/v1/contact/1/contact-cz-relation/1

URL Parameters

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

contact

true

NULL

Number

contact_cz_relation

true

NULL

Number

回應 204 http status

對指定客戶刪除指定分類的自訂表格紀錄

DELETE https://{API_HOST}/api/v1/contact/{contact}/cz-col-category/{cz_col_category}
curl -X DELETE
    -H "Content-Type: application/json:Authorization: Bearer eyJhbGciOiJIUzI1NiI..." https://{API_HOST}/api/v1/contact/1/cz-col-category/1

URL Parameters

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

contact

true

NULL

Number

cz_col_category

true

NULL

Number

回應 204 http status

的 ID

的 id

的 id

請參考 和 回應格式

的 id

的 id

請參考 回應格式

的 id

的 id

的 id

的 id

📄
客戶自定關聯表格
客戶自訂表格
客戶自訂表格內容
客戶動態關聯表格
客戶
客戶
動態欄位分類
客戶
客戶動態關聯表格
客戶
客戶動態關聯表格
客戶
動態欄位分類