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
  • 地址 Address
  • 國家 Country
  • 城市 State
  • 區 City
  • 客戶 Contact
  • 客戶個資物件 Profile
  • 電子信箱 Email Contact
  • 自訂欄位 CzCol
  • 自訂欄位分類 CzColCategory
  • 客戶自訂表格 Contact Cz Relation
  • 客戶自訂表格 Contact Cz RelationInformation
  • 客戶標籤 Contact Tag
  • 客戶勿擾設定 Disturb Setting
  • 員工 Employee
  • 職稱 Job Title
  • 分機 Extension
  • 電話專員 CtiAgent
  • 員工群組 Employee Group
  • 部門 Deaprtment
  • 電話 Phone Number
  • 工單 Ticket
  • 工單狀態細項代碼 Ticket Termination Code
  • 主分類 Category
  • 子分類 SubCategory
  • 業主 Sponsor
  • 服務紀錄 Interact-collection
  • 自訂表格匯入範本 Relation Import Recipe
  • 自訂表格匯入排程 Relation Import Task
  • 客戶匯入範本 Entity Import Recipe
  • 客戶匯入排程 Entity Import Task
  1. 開發文件
  2. API 說明

回應物件資料

地址 Address

PROPERTY

TYPE

DESCRIPTION

id

Number

地址 id

type

Number

地址類型

  • 0: 住家

  • 1: 郵寄

  • 2: 帳單

  • 3: 寄送

  • 4: 現居

  • 5: 其他

address

String

地址內容

profile_id

Number

客戶個資物件的 id

state

Object

state_id

Number

縣市的id

country

Object

country_id

Number

國家的id

city

Object

city_id

Number

區的id

description

String

地址描述說明

國家 Country

PROPERTY

TYPE

DESCRIPTION

id

Number

id

name

String

名稱

城市 State

PROPERTY

TYPE

DESCRIPTION

id

Number

id

name

String

名稱

區 City

PROPERTY

TYPE

DESCRIPTION

id

Number

id

name

String

名稱

客戶 Contact

PROPERTY

TYPE

DESCRIPTION

id

Number

客戶的 id

name

String

全名

first_name

String

姓氏

last_namt

String

名字

membership_no

String

會員編號

identity_no

String

身分證字號

gender

Number

性別

birth_at

Datetime

生日

profile_id

Number

客戶個資物件 的 id

profile

Object

sponsor

Object

sponsor_id

Number

業主id

campaign_queues

Array of objects

此欄位請忽略,尚未具備正式功能

email_contacts

Array of objects

fbs

Array of objects

此欄位請忽略,尚未具備正式功能

lines

Array of objects

此欄位請忽略,尚未具備正式功能

cz_cols

Array of objects

tags

Array of objects

disturb_setting

Object

客戶個資物件 Profile

PROPERTY

TYPE

DESCRIPTION

id

Number

客戶個資物件的 id,會被用來撈取住址,電話

phones

Array of object

電子信箱 Email Contact

PROPERTY

TYPE

DESCRIPTION

id

Number

電子郵件信箱 id

contact_id

Number

address

String

電子郵件位址

draft

String

草稿

name

String

自定義的電子信箱別名

description

String

電子信箱描述

自訂欄位 CzCol

PROPERTY

TYPE

DESCRIPTION

id

Number

動態欄位的 id

name

String

動態欄位的名稱

description

String

動態欄位的描述說明

is_allowed_null

Boolean

是否允許空值

default

Object

此動態欄位的預設值

type

Number

動態欄位的類型

  • 0: 數字

  • 1: 字串

  • 2: 布林值

  • 3: 日期

  • 4: 時間

  • 5: 日期時間

  • 6: 單選

  • 7: 多選

category_id

Number

主分類的 id

category

Object

creater_id

Number

建立此動態欄位的員工id

creater

Object

自訂欄位分類 CzColCategory

PROPERTY

TYPE

DESCRIPTION

id

Number

動態欄位分類 的 id

name

String

動態欄位分類名稱

type

Number

動態欄位分類類型 {0: 客戶動態關聯表單 1: 客戶動態關聯表格 2: 工單動態關聯表單 3: 工單動態關聯表格}

description

String

動態欄位分類描述

cols

Array of objects

客戶自訂表格 Contact Cz Relation

PROPERTY

TYPE

DESCRIPTION

id

Number

客戶動態關聯表格 id

relation_id

Number

relation_name

String

information

Array of Objects

客戶自訂表格 Contact Cz RelationInformation

PROPERTY

TYPE

DESCRIPTION

id

Number

客戶動態關聯表格內容的 id

value

String

客戶動態關聯表格內容的值

col_id

Number

col_name

String

客戶標籤 Contact Tag

PROPERTY

TYPE

DESCRIPTION

id

Number

id

name

String

名稱

description

String

說明

客戶勿擾設定 Disturb Setting

PROPERTY

TYPE

DESCRIPTION

id

Number

id

type

Array of string

勿擾設定的類型,包含電話,Fb,Line

no_disturb_start_at

Time

勿擾設定起始時間

no_disturb_end_at

Time

勿擾設定結束時間

reason

String

勿擾理由

員工 Employee

PROPERTY

TYPE

DESCRIPTION

id

Number

員工的id

name

String

姓名

first_name

String

姓氏

last_name

String

名字

employee_no

String

員工編號

photo_url

String

照片路徑

identity_no

String

身分證字號

job_title_id

Number

職稱 id

job_title

Object

department_id

Number

部門 id

department

Object

extension_id

Number

分機 id

extension

Object

profile

Object

is_active

Boolean

是否啟用

role

String

權限

email

String

信箱地址

group_id

Number

員工群組 id

group

Object

is_immortal

Boolean

不可被修改

cti_agent_account

String

cti 帳號名稱

cti_agent

Object

created_at

Datetime

初始建立時間

updated_at

Datetime

最後更新時間

職稱 Job Title

PROPERTY

TYPE

DESCRIPTION

id

Number

id

abbrev

String

簡稱

name

String

名稱

description

String

說明

分機 Extension

PROPERTY

TYPE

DESCRIPTION

id

Number

id

type

Number

類型 <0: 分機, 1: ACD, 2: IVR, 3: WEBRTC>

extension

String

分機號碼

description

String

說明

media_cluster_id

Number

待補

media_cluster

Object

待補

employee_id

Number

employee

Object

員工 id

電話專員 CtiAgent

PROPERTY

TYPE

DESCRIPTION

id

Number

id

account

String

帳號

employee

Object

group_id

Number

員工群組 id

group

Object

員工群組 Employee Group

PROPERTY

TYPE

DESCRIPTION

id

Number

員工的id

name

String

姓名

description

String

說明

supervisor_id

Number

督導的 id

supervisor

Object

members

Array of object

部門 Deaprtment

PROPERTY

TYPE

DESCRIPTION

id

Number

id

name

String

名稱

abbrev

String

簡稱

number

Number

代號

description

String

說明

電話 Phone Number

PROPERTY

TYPE

DESCRIPTION

id

Number

id

type

Number

0: 住家, 1: 公司, 2: 手機, 3: 傳真, 4: 其他

extension

String

分機

number

String

號碼

description

String

說明

工單 Ticket

PROPERTY

TYPE

DESCRIPTION

id

Number

id

subject

String

標題

content

String

內容

due_at

Datetime

截止時間

status

Number

工單狀態 < 0: 待處理 1: 處理中 2: 已解決 3: 已關閉 >

status_memo

String

狀態備註

priority

Number

優先順序

termination_code_id

Number

狀態細項 id

termination_code

Object

contact

Object

contact_id

Number

客戶 id

sub_category

Object

sub_category_id

Number

子分類 id

creater

Object

handler_id

Number

建立此工單的員工 id

handler

Object

sponsor_id

Number

負責此工單的員工 id

sponsor

Object

created_at

Datetime

初始建立時間

updated_at

Datetime

最後更新時間

工單狀態細項代碼 Ticket Termination Code

PROPERTY

TYPE

DESCRIPTION

id

Number

id

name

String

名稱

description

String

說明

status

Number

對應工單狀態 < 0: 待處理 1: 處理中 2: 已解決 3: 已關閉 >

creater_id

Number

建立此狀態細項的員工 id

creater

Object

主分類 Category

PROPERTY

TYPE

DESCRIPTION

id

Number

id

name

String

名稱

description

String

說明

children

Array of objects

子分類 SubCategory

PROPERTY

TYPE

DESCRIPTION

id

Number

id

name

String

名稱

description

String

說明

category

Object

category_id

Number

主分類 id

業主 Sponsor

PROPERTY

TYPE

DESCRIPTION

id

Number

id

name

String

名稱

description

String

說明

is_immortal

Boolean

是否不可更改

服務紀錄 Interact-collection

PROPERTY

TYPE

DESCRIPTION

id

Number

服務紀錄系統 ID

is_acw_completed

Boolean

是否已完成服務,0:未完成、1:完成

first_enter_queue_time

String

客戶進線開始分派的時間。

first_start_service_at

Datetime

專員接應與客戶開始服務時間。

last_finished_at

Datetime

與客戶結束交談時間,但並不表示服務完成。

acw_at

Datetime

專員結束完成此筆服務時間。

handler_id

Number

負責專員系統 ID

handler

Object

負責專員資料

contact_id

Number

客戶 ID

contact

Object

客戶資料

memo

String

服務紀錄備註

bound_type

Number

服務的方向。 0 表示專員主動拜訪;1 客戶表示主動聯繫。

logs

Array

此服務紀錄所有相關連的交談紀錄,列表方式不包含完整資訊,請由單筆讀取獲取完整資訊。

sponsor_id

Number

業主 ID

sponsor

Object

業主資料

reasons

Array

服務原因資料

reason_ids

Arrary

服務原因所以 ID

result_id

Number

服務結果 ID

result

Object

服務結果資料

media_cluster_id

Number

管道整合 ID

media_cluster

Object

管道整合

transfer_logs

Array

此服務紀錄轉派過的紀錄

created_at

Datetime

服務紀錄系統建立時間

自訂表格匯入範本 Relation Import Recipe

Property

Type

Description

id

Number

自訂表格批次匯入範本的 id

name

String

自訂表格批次匯入範本的名稱

importable_type

String

自訂表格批次匯入範本的類型,目前僅支援 App\Contact

description

String

自訂表格批次匯入範本的詳細描述

headers

Array

匯入檔案的欄位定義

cz_col_category_id

Number

動態欄位分類 的 id

cz_col_category

Object

動態欄位分類

unique_columns

Array

定義的客戶唯一值判斷欄位

relation_unique_column

Array

定義的自訂表格唯一值判斷欄位

creater_id

Number

建立人員 的 id

creater

Object

建立人員

tasks_count

Number

根據此自訂表格批次匯入範本所建立的自訂表格批次匯入任務數量

自訂表格匯入排程 Relation Import Task

僅說明重要欄位

Property

Type

Description

id

Number

自訂表格匯入任務的 id

size

Number

檔案大小 (byte)

total_amount

Number

總行數

description

String

任務描述

status

Number

狀態 (0: 建立, 1: 匯入中, 2: 完成, 10: 錯誤, 11: 暫停)

current_sheet_index

Number

目前匯入檔案執行到第幾個 sheet

current_row_index

Number

目前匯入到第幾行

executed_start_at

Datetime

開始執行時間

executed_end_at

Datetime

結束執行時間

creater_id

Number

建立人員 的 id

created_at

Datetime

初始建立時間

updated_at

Datetime

最後更新時間

客戶匯入範本 Entity Import Recipe

Property

Type

Description

id

Number

批次匯入範本的 id

name

String

批次匯入範本的名稱

importable_type

String

批次匯入範本的類型,目前僅支援 App\Contact

description

String

批次匯入範本的詳細描述

headers

Array

匯入檔案的欄位定義

cz_col_category_id

Number

動態欄位分類 的 id

cz_col_category

Object

動態欄位分類

unique_columns

Array

定義的客戶唯一值判斷欄位

creater_id

Number

建立人員 的 id

creater

Object

建立人員

tasks_count

Number

根據此批次匯入範本所建立的批次匯入任務數量

客戶匯入排程 Entity Import Task

僅說明重要欄位

Property

Type

Description

id

Number

匯入任務的 id

size

Number

檔案大小 (byte)

total_amount

Number

總行數

description

String

任務描述

status

Number

狀態 (0: 建立, 1: 匯入中, 2: 完成, 10: 錯誤, 11: 暫停)

current_sheet_index

Number

目前匯入檔案執行到第幾個 sheet

current_row_index

Number

目前匯入到第幾行

executed_start_at

Datetime

開始執行時間

executed_end_at

Datetime

結束執行時間

creater_id

Number

建立人員 的 id

created_at

Datetime

初始建立時間

updated_at

Datetime

最後更新時間

Previous請求方式說明Next客戶

Last updated 12 months ago

所屬 的id

建立此動態欄位的

的 id

的名稱

的陣列

的 id

的名稱

督導,格式為

群組成員,格式為的陣列

縣市
國家
區
客戶個資物件
業主
客戶電子信箱陣列
客戶的動態欄位陣列
標籤陣列
勿擾
電話陣列
客戶
主分類
員工
動態欄位
動態欄位分類
動態欄位分類
客戶動態關聯表格內容
動態欄位
動態欄位
職稱
部門
分機
客戶個資
員工群組
電話專員
員工
員工
員工群組
員工
員工
狀態細項
客戶
子分類
建立此工單的員工
負責此工單的員工
此工單所屬的業主
建立此狀態細項的員工
子分類陣列
主分類