跳到主要内容

Odoo Sync

Odoo Sync 将您的 MonoChat 工作区连接到您的 Odoo 数据库,支持 Odoo Online、Odoo.sh 或您自己的服务器。该应用:

  • 将客户的姓名、电话号码、电子邮箱和已映射的资料字段发送到其在 Odoo 中的联系人或 CRM 线索,没有时会新建一个,
  • 每 10 分钟读取 Odoo 中有变化的联系人和线索,并更新 MonoChat 中对应的客户,
  • 将每个已关闭的对话作为备注发布到联系人或线索的 chatter 中,
  • 在对话旁显示客户的发票和销售订单,并为未付发票发送付款链接,
  • 客户通过链接付款后,在 Odoo 中将付款登记到发票上。

开始之前​

您需要:

  1. 具有 API 访问权限的 Odoo 17 或更高版本。 Odoo 在 Custom 方案中提供 API 访问;您自行托管的 Odoo 也有。
  2. 一个 API 密钥。 在 Odoo 中,打开应用将代表其操作的用户的 Preferences › Account Security,点击 New API Key。Odoo 只显示一次密钥:请复制。Odoo 建议为集成使用专用用户,并只授予所需权限。
  3. 您在 Odoo 中使用的应用。 联系人始终同步。线索需要 CRM 应用,订单需要销售应用,发票需要开票或会计应用。
  4. MonoChat 中的支付系统,用于发送付款链接。应用使用您的默认支付系统。

连接 Odoo​

  1. 从 MonoStore 安装应用。
  2. 打开 设置 › Odoo。
  3. 输入 Odoo address(例如 https://yourcompany.odoo.com)和 Database 名称。
  4. 对于 Odoo 18 及更早版本,在 Login (Odoo 18 and earlier) 中输入 API 密钥所属用户的登录名。Odoo 19 及更高版本不需要。
  5. 粘贴 API key,点击 Save,然后点击 Test connection。

应用在 Odoo 19 及更高版本中使用 Odoo 的 JSON-2 API,在更早版本中使用 JSON-RPC;界面会显示使用了哪种方式。API 密钥不会再次显示;留空即可保留已保存的密钥。只有所有者或经理可以更改这些设置。更改地址或数据库时,请重新输入 API 密钥。

同步内容​

设置作用
Sync customers with当 Odoo 中没有某个 MonoChat 客户的记录时,在哪里创建:Contacts 或 CRM leads。
Add new Odoo records with a phone number as MonoChat customers连接后在 Odoo 中新建且带有电话号码的联系人或线索,会成为您的团队可以发消息的 MonoChat 客户。
Post each closed conversation to the record’s chatter对话关闭时,自上次备注以来的消息(最多最近 100 条)会作为备注发布到 chatter。内部备注不包含在内。
Journal已付款链接的付款所登记的银行或现金日记账。未选择时由 Odoo 决定。
Field mapping最多五个资料字段,每个字段对应一个 Odoo 字段的技术名称(Odoo 在开发者模式中显示)和一个方向:Both ways、To Odoo only 或 From Odoo only。姓名、电话号码和电子邮箱始终同步。
  • 从 MonoChat 到 Odoo: 客户资料变化时,应用通过电子邮箱或电话号码找到其联系人或线索,或新建一个,并只发送有变化的值。
  • 从 Odoo 到 MonoChat: 应用每 10 分钟读取 Odoo 中有变化的联系人和线索,并更新与之关联的客户,或电话号码、电子邮箱相同的客户。来自 Odoo 的值不会被发回。
  • 当某条线索的客户之后以 Odoo 联系人出现时,该客户会被关联到该联系人。
  • 设置 › Odoo 显示上次读取的时间,以及失败时的错误。
  • 无法应用到 MonoChat 的记录不会中断读取:界面会显示跳过的数量,以及最后一条记录和原因。

对话旁边​

对话旁的 Odoo 卡片列出客户最近的发票(含未付金额和付款状态)以及最近的销售订单。在未付发票上,Send payment link 会向客户发送一条消息,附带未付金额的付款链接。

在流程中使用​

在 设置 › 自动化 › 流程 中为流程添加一个 函数 节点,并选择应用的某个节点。参见 流程。

节点作用输出
Odoo · Send orders or invoices在您填写的标题下,向客户发送其未付发票或最近的销售订单(编号、金额和日期)。Sent、None、Not in Odoo
Odoo · Send invoice payment link为客户最早的未付发票按未付金额创建付款链接,并随您的消息一起发送。在消息中相应位置写入 {invoice}、{amount} 和 {link}。Sent、No invoice、Not in Odoo、No payment system

Not in Odoo 表示应用未找到该客户的 Odoo 联系人。Odoo 拒绝请求时,节点走失败分支。

与 AI 智能体一起使用​

将应用的工具添加到您的 AI 智能体:

  • Odoo · Read the customer's orders and invoices 向智能体提供客户最近的销售订单和发票,包括金额、日期和未付金额。
  • Odoo · Get an invoice payment link 为客户提到的发票或其最早的未付发票向智能体提供付款链接,供其在回复中分享。

客户付款时​

付款链接使用发票的币种。客户付款后,应用会在 Odoo 中将付款登记到发票上,记入您选择的日记账,备忘为 MonoChat 加付款编号。在 Odoo 中已付清的发票保持不变。

须知​

  • Odoo 目前还无法通知 MonoChat,因此 Odoo 中的变化会在 10 分钟内到达 MonoChat。
  • 连接之前在 Odoo 中变化的记录不会被读取。客户在其资料变化、对话关闭或应用读取到 Odoo 中的变化时与 Odoo 关联。
  • 应用在 Odoo 中以 API 密钥所属用户的身份操作:能查看和更改该用户被允许的内容。