Odoo Sync
Odoo Sync 将您的 MonoChat 工作区连接到您的 Odoo 数据库,支持 Odoo Online、Odoo.sh 或您自己的服务器。该应用:
- 将客户的姓名、电话号码、电子邮箱和已映射的资料 字段发送到其在 Odoo 中的联系人或 CRM 线索,没有时会新建一个,
- 每 10 分钟读取 Odoo 中有变化的联系人和线索,并更新 MonoChat 中对应的客户,
- 将每个已关闭的对话作为备注发布到联系人或线索的 chatter 中,
- 在对话旁显示客户的发票和销售订单,并为未付发票发送付款链接,
- 客户通过链接付款后,在 Odoo 中将付款登记到发票上。
开始之前
您需要:
- 具有 API 访问权限的 Odoo 17 或更高版本。 Odoo 在 Custom 方案中提供 API 访问;您自行托管的 Odoo 也有。
- 一个 API 密钥。 在 Odoo 中,打开应用将代表其操作的用户的 Preferences › Account Security,点击 New API Key。Odoo 只显示一次密钥:请复制。Odoo 建议为集成使用专用用户,并只授予所需权限。
- 您在 Odoo 中使用的应用。 联系人始终同步。线索需要 CRM 应用,订单需要销售应用,发票需要开票或会计应用。
- MonoChat 中的支付系统,用于发送付款链接。应用使用您的默认支付系统。
连接 Odoo
- 从 MonoStore 安装应用。
- 打开 设置 › Odoo。
- 输入 Odoo address(例如
https://yourcompany.odoo.com)和 Database 名称。 - 对于 Odoo 18 及更早版本,在 Login (Odoo 18 and earlier) 中输入 API 密钥所属用户的登录名。Odoo 19 及更高版本不需要。
- 粘贴 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 密钥所属用户的身份操作:能查看和更改该用户被允许的内容。