从 Google Sheets 同步线索

同步的工作方式

你连接自己的 Google 账户，用 Google 自带的文件选择器选取电子表格，并一次性告诉 LumaKol 每一列的内容。工作表中已有的行会先导入。之后 LumaKol 大约每 15 分钟读取一次表格，底部新增的每一行都会成为一条线索，因此无需任何人导出或上传文件。如果你为此选择了列，阶段、最近结果、通话时间和坐席会回写到该线索所在的行。

先连接 Google Drive

表格通过你自己的 Google 账户读取，也就是在“设置 → Google Drive”中连接的账户。在那里点击“连接 Google Drive”，Google 会询问要使用哪个账户并请求你的授权。之后，“Integrations → Google Sheets”会显示该账户（“表格从 Google 账户 … 中选取”），并提供“使用其他账户”链接。

• 在连接 Google Drive 之前，“Integrations → Google Sheets”中显示的是指向 Google Drive 的链接，而不是“连接表格”
• 每个人连接自己的 Google 账户，表格始终通过连接它的那个人的账户读取
• 选取一个电子表格只会让 LumaKol 访问这一个文件，而不是你 Drive 中的其他内容

连接表格

在“Integrations → Google Sheets”中点击“连接表格”。Google 的文件选择器会打开并列出你的 Google Sheets 文件；选择存放线索的电子表格。LumaKol 读取其中的工作表后，会打开“设置同步”窗口。

选择工作表并映射列

在“哪个工作表”中选择存放线索的工作表；其第一行会被读取为表头。“列”按字母和表头列出每一列，并附上第一行数据中的示例。LumaKol 会根据表头猜测每列的内容，因此请检查这些猜测，并更正看起来不对的地方。

• 必须有一列映射为“电话号码”。没有可用号码的行无法成为线索，会计为不可用
• 线索字段包括：姓名、电话号码、其他电话、邮箱、公司、职位、城市、省/州、国家、PIN / 邮政编码、地址、来源、营销活动、漏斗阶段、备注、标签和你自己的编号。其他列请保留为“— 跳过此列 —”
• 其他电话、备注和标签可以对应多列。标签按逗号和分号拆分
• 线索从你的第一个漏斗阶段开始。漏斗阶段列必须使用你的阶段名称（不区分大小写）；阶段为其他值的行会计为不可用
• 国家只接受两个字母的代码，例如 IN 或 AE；其他内容会使国家留空。没有国家代码的号码按你工作区所在的国家读取

把其他列保存到自定义字段

其他值得保留的信息，例如预算、产品或分支机构，可以放入自定义字段。每一列的下拉列表都会以“自定义字段：…”的形式列出你的自定义字段；如果没有与表头匹配的自定义字段，还会提供以表头命名的“新建自定义字段”。如果表头与你已有的某个自定义字段名称相同，LumaKol 会自动为你选择该字段。

• 点击“开始同步”时，新的自定义字段会以文本字段的形式创建
• 新的自定义字段计入你套餐的自定义字段上限。如果已达到上限，“开始同步”会停止并显示提示，且不会同步任何内容：请将该列对应到现有字段，或跳过该列
• 不符合字段要求的值会被忽略，但线索仍会导入。表格中留空的必填自定义字段也不会阻止线索导入
• 之后可以在“设置向导 → 自定义字段”中重命名或删除自定义字段

将结果回写到表格（可选）

在“将结果回写到表格”中，LumaKol 可以把四项内容写入该线索自己所在的行：漏斗阶段、最近通话结果、上次拨打时间和负责坐席。为你需要的每一项选择一列，其余保留为“不回写”：这些项永远不会被改动。然后点击“开始同步”。

• 每个选项都会按字母和表头显示列，例如“D 列 · 预算”。前几行没有任何内容的列会标为“空”，你最后一列之后的几个空列也会列出。请选择空列，以免覆盖你输入的内容
• 一列只能对应四项中的一项；选定后，它不会再出现在其他项的选项中
• 在应用或网页上保存通话结果后不久就会写入值，此后线索每次变化都会再次写入。还没有通话结果的线索不会写入
• 上次拨打时间是最近一次拨打该线索的日期和时间，以 UTC 写入
• 只有通过此同步成为线索的行才会被回写。号码已是线索的行保持不变

新行会怎样处理

点击“开始同步”后几分钟内，第一批行就会到达。此后 LumaKol 大约每 15 分钟读取一次表格，从上次读取的最后一行的下一行开始，每个新行都会成为一条线索，进入以电子表格和工作表命名的名单。很长的表格会分几次检查导入。

• 每一行只读取一次。编辑已读取的行不会更改其线索，也不会再次添加
• 在公司工作区中，新线索导入时未分配：在“线索”页面选择该表格的名单并分配，或在“管理列表”中重新分配整个名单。在个人账户中，线索都归你
• 请在底部添加新线索。不要对工作表排序，也不要在最后读取的行上方插入或删除行：LumaKol 按行号记录读取位置以及要回写的行
• 请粘贴整行，或一次填完每一行。在输入到一半时被读取的行会按当时的内容导入，还没有电话号码的行会计为不可用
• 每条线索的“Added”日期是其所在行导入的时间，而不是连接表格的那一天。“Integrations → Google Sheets”中该表格的条目会显示今天的新线索数，点击“View new leads”可在“线索”页面打开这些线索

立即同步、暂停或停止

每个已连接的工作表在“已同步的表格”下都有自己的条目：显示电子表格和工作表、状态（“同步中”、“已暂停”或“需要处理”）、结果回写到该工作表时显示的“回写”标记，以及一行说明，列出导入了多少行、多少行重复或不可用，以及上次检查的时间。

• “立即同步”会马上读取新行，而不必等待下一次检查，并告诉你有多少条新线索导入
• 暂停按钮会停止同步：不会导入新行，也不会回写任何内容。播放按钮会恢复同步，表格很快会再次检查
• 垃圾桶按钮在你确认后停止同步。新行不再导入，已导入的线索保持原样
• 如果之后要更改列，请停止同步并重新连接表格。工作表会从头读取：已在 LumaKol 中的行计为重复，结果只会回写到此后新增的行

表格需要处理时

“需要处理”表示上次检查失败，条目会以红色显示原因。LumaKol 会自动继续重试，不会丢失任何内容：下一次成功的检查会从同一行继续，状态也会恢复为“同步中”。解决问题后，点击“立即同步”即可马上检查。

• “LumaKol cannot open that sheet any more”：电子表格已被删除、其所有者取消了你的访问权限，或者你更换了 Google 账户。请确认你的账户可以打开它，点击“连接表格”并选取同一个电子表格：重新选取即可恢复访问权限。设置窗口会在该工作表上打开，并提示它已连接。关闭窗口，然后在条目上点击“立即同步”
• “Connect Google Drive first”或“Google Drive access was revoked”：在“设置 → Google Drive”中重新连接 Google Drive
• “Google Sheets refused the request”：通常是工作表被重命名或删除了。LumaKol 按名称查找工作表，因此请把它改回原来的名称
• “Your plan stores up to … leads”或“The free trial stores up to … leads”：工作区中的线索数已达到其套餐允许的上限。请在“账单”中选择更大的套餐，然后点击“立即同步”
• “Write-back failed”：写入表格失败，通常是上述原因之一。按同样的方法解决

切换到其他 Google 账户

打开“设置 → Google Drive”，点击“更换账户”，然后点击“选择账户”。Google 会显示其账户选择器，你可以选择任一 Google 账户或添加其他账户，之后“Integrations → Google Sheets”会显示新账户。

• 从旧账户连接的表格会停止同步，并在下次检查时显示“需要处理”，因为新账户尚未授予 LumaKol 访问这些表格的权限
• 用新账户逐个重新连接，新账户必须拥有该电子表格或已获得共享：点击“连接表格”并选取同一个电子表格。设置窗口会提示该工作表已连接：关闭窗口，然后在条目上点击“立即同步”。同步会从之前到达的行继续
• 工作区中其他人连接的表格不受影响：每个表格都通过连接它的人的 Google 账户读取