在墨西哥的贸易公司里,很多订单以零散文字、照片或语音的形式通过WhatsApp进来,然后有人把它们重新敲进企业资源计划(ERP)系统。本指南以Transgenia(特兰斯赫尼亚)的方法说明如何把这个渠道接入Odoo与一个人工智能(AI)层,同时不让智能体自行确认订单、发明价格或开票。
查看 Mermaid 图
mindmap
root(("用 AI 把 WhatsApp 订单接入 Odoo"))
要求与范围
Meta:业务组合、应用、号码、令牌、Webhook
Enterprise:Odoo 的 WhatsApp 应用
Community 或 Online:外部 API
七个步骤
Meta 基础设施
连接 Odoo
不杜撰地理解消息
只读查询
报价单草稿
用模板回复
人工确认
Enterprise 与 Community 的对比
可能出错的地方
假设示例
我们的立场与来源
本指南需要哪些前提,适用范围是什么?
| 要点 | 你需要什么 | 本指南不涵盖 |
|---|---|---|
| Meta一侧 | 一个商业资产组合(“你必须拥有商业资产组合才能使用该平台”)、一个开发者账户、一个带WhatsApp用例并连接到WhatsApp Business账户的应用、一个专用号码、一个永久令牌和一个webhook。企业验证可提升能力(例如更高的消息量)。 | Meta的费用:按国家与会话类型变化;请带日期查阅Meta的定价页面。我们不发布金额。 |
| Enterprise路径 | 带WhatsApp应用的Odoo 17、18或19 Enterprise:“WhatsApp,配置,WhatsApp Business账户,新建”,填入应用ID、WhatsApp Business账户ID与访问令牌;测试连接时Odoo生成回调URL与验证令牌。 | 高级模板配置与营销活动:不在范围内。 |
| Community或Online路径 | 一个中间服务(编排器或智能体),接收Meta的webhook并通过外部API与Odoo对话。在Odoo Online上,外部API仅在Custom套餐可用。Odoo 19使用JSON-2 API,以API密钥作为bearer令牌。 | 不经官方API读取WhatsApp Web的连接器:号码有被封禁的风险,我们不推荐。 |
| AI层 | 通过API使用Claude或ChatGPT(或使用只读模式的开源MCP服务器查询Odoo)。模型提取客户、产品、数量与日期;缺信息时提问;不计算价格。向集成商书面索取什么,见Claude或ChatGPT与Odoo集成商采购指南。 | 语音转写:取决于你选择的AI服务商;本指南不评估转写产品。 |
| 人员 | 一位确认订单的销售人员、一位目录负责人(同义词与包装)以及一位审批消息模板的人。 | WhatsApp群发或陌生拓客:不是本指南的目标,也不是我们的做法。 |
查看 Mermaid 图
flowchart TB
C["WhatsApp 上的客户"] --> M["Meta 的 WhatsApp Business Platform:Webhook"]
M --> E["Enterprise:Odoo 的 WhatsApp 应用"]
M --> S["Community 或 Online:通过外部 API 的中间服务"]
E --> IA["AI 智能体:提取行项目、数量与日期;缺信息时提问"]
S --> IA
IA --> O["只读访问 Odoo:目录、库存、价格表"]
O --> Q["处于“报价单”状态的草稿,带标签与备注"]
Q --> P{"由人确认"}
P --> V["销售订单;CFDI 走自身流程"]
从消息到报价草稿,具体分几步?
1. 准备Meta的基础设施
创建或选择商业资产组合与Meta开发者账户。在应用面板中创建一个带WhatsApp用例的新Meta应用,并把它连接到一个WhatsApp Business账户。使用一个专用于该平台的号码。创建一个供整个WhatsApp Business Platform使用的永久令牌,并配置webhook以接收入站消息与送达状态。如需更高容量,请完成企业验证。
2. 按版本类型把WhatsApp接入Odoo
Enterprise。 在Odoo中进入“WhatsApp,配置,WhatsApp Business账户”,点击“新建”。填入应用ID、WhatsApp Business账户ID与访问令牌。测试连接时,Odoo会生成要粘贴到Meta webhook中的回调URL与验证令牌。模板需要审批:WhatsApp有一个审批流程,完成之后才能使用模板。
Community或Custom套餐的Online。 Meta的webhook指向你的中间服务,由它验证发送方、保存消息并通过外部API(Odoo 19上为带API密钥的JSON-2)调用Odoo。会话不在Odoo内部,但每一笔订单都在:它以报价形式登记,来源写在沟通记录里。
3. 用AI解读消息,不发明任何内容
智能体把“给我发3箱16号的和5箱20号的,周四要”转换成带产品、数量、单位的行项目,外加日期。要做好这一点,它需要一本目录词典,收录客户使用的叫法(纸箱、箱、件、短代码)。遇到歧义或缺信息时,它在同一会话里用提问回应;它不猜。防止面向B2B销售的受控AI智能体发明内容或发垃圾消息的规则,在这里同样适用。
4. 以只读权限查询Odoo
按电话或名称查找联系人,把每一行映射到目录(编码、变体、单位),读取客户的价格表与各仓库的可用量。价格、折扣与税费由Odoo计算。使用只读模式的MCP服务器时,任何写入尝试都会在到达Odoo之前被拒绝;如何用API密钥和受限权限把Odoo连接到Claude,以及在Odoo副本上测试智能体前要隔离什么,各有专门指南。
5. 以“报价单”状态创建报价
一个与智能体不同的技术账户创建报价,附“由AI生成”标签以及一条带来源消息与时间的沟通记录。状态:“报价单”。什么都不确认,什么都不发送。这一步的Odoo状态、服务器端控制与常见故障,见由AI准备、由人工审批的报价指南。
6. 只用能确定的内容回复客户
行项目、数量与由Odoo计算的总额摘要,并注明交付日期待验证后确认。如果会话已超出客服时间窗,只能发送已审批的模板:模板是客服时间窗之外唯一可以发送给WhatsApp用户的消息类型。
7. 人工确认以及之后的流程
销售人员打开草稿,核对库存与条件,调整后点击“确认”。根据Odoo 19文档,确认后“报价单被确认,状态变为销售订单”,并且“它正式转为可开票、可收款的销售订单”。拣货、交货与发票遵循公司的常规流程;电子发票(CFDI)不会因为一条消息而开出。
查看 Mermaid 图
flowchart TB
S1["1. Meta 基础设施:业务组合、应用、专用号码、令牌、Webhook"] --> S2["2. 按版本连接 Odoo"]
S2 --> S3["3. AI 理解消息,遇到歧义就提问"]
S3 --> S4["4. 只读查询:联系人、目录、价格表、库存"]
S4 --> S5["5. 处于“报价单”状态的草稿,标签为“AI 生成”"]
S5 --> S6["6. 用 Odoo 计算的摘要回复;窗口期外只用已审核模板"]
S6 --> S7{"7. 销售人员是否确认?"}
S7 -- "调整或致电客户" --> S5
S7 -- "是" --> V["销售订单;交付与开票走常规流程"]
Enterprise与Community有什么不同?
| 方面 | 带WhatsApp应用的Odoo Enterprise | 通过外部API的Odoo Community或Online |
|---|---|---|
| 会话存放在哪里 | Odoo内部(WhatsApp应用) | 中间服务内;Odoo中保留订单及其来源备注 |
| 模板 | 在Odoo中管理,由Meta审批 | 在Meta或中间件中管理;同样需要审批 |
| 套餐要求 | Enterprise订阅 | Community:无。Online:外部API需Custom套餐 |
| AI层 | 两种情况下都在Odoo外部(Odoo不会自行解读订单);可用Studio的“发送WhatsApp”动作通知 | 外部;由中间件编排AI与API |
| 订单控制 | 报价草稿加人工确认 | 相同 |
查看 Mermaid 图
flowchart TB
A{"你使用哪个 Odoo 版本?"}
A -- "Enterprise" --> E["Odoo 的 WhatsApp 应用:WhatsApp、配置、WhatsApp Business 账号"]
A -- "Community" --> C["通过外部 API 的中间服务"]
A -- "Online" --> P{"Custom 套餐?"}
P -- "是" --> C
P -- "否:One App Free 或 Standard" --> X["没有外部 API:集成前先更换套餐"]
E --> R["报价单草稿与人工确认"]
C --> R
哪些地方容易出错?
- 号码在Meta处于待处理状态。 Odoo文档提醒,号码可能在开发者应用中停留在待处理状态,这可能导致WhatsApp集成无法正常工作。
- 未审批的模板。 没有Meta的审批,消息发不出去;在服务时间窗之外,只有模板能发出。
- 用WhatsApp应用代替平台。 手机应用不是API;在同一号码上混用两者会导致故障和封禁风险。
- 会确认的智能体。 如果技术账户能确认或开票,一条误读的订单就会变成一笔销售或一张CFDI。
- 发明的价格。 模型不得计算或“估算”价格;由Odoo按客户价格表计算。
- 重试造成的重复。 同一条消息可能通过webhook到达两次;用消息标识符作为幂等键。
- 没有同义词的目录。 “16号的一箱”在Odoo里不存在,存在的是一个编码。没有词典,智能体要么问得太多,要么弄错;目录的清理按在Odoo中纠正库存差异的流程进行。
- 没有外部API的Odoo Online套餐。 使用One App Free或Standard时,Community或Online路径无法工作。
一个假设的例子长什么样?
本例仅说明拟议的流程,不报告任何客户的结果或数字。一家运行Odoo Community的五金批发商在WhatsApp上收到:“你好,这里是Construcciones del Valle,给我发12箱2英寸镀锌螺丝和4箱8号膨胀螺栓,明天要”。Meta的webhook把消息送到中间服务;智能体识别出两行与日期,发现螺丝有两种规格(100装与500装)并询问是哪一种;得到回答后查询库存与客户价格表,以“报价单”状态创建报价并附“由AI生成”标签。它回复摘要与由Odoo计算的总额,不承诺日期。销售人员看到只有10箱可用,调整后致电客户并确认。会计在到期时开具CFDI。如果智能体没有读取价格表的权限,流程会停下并请求验证。
Transgenia的立场是什么?
- WhatsApp是运营渠道,不是陌生拓客渠道。 我们把AI与WhatsApp集成用于预约确认、订单处理与销售跟进,每条消息都记录在Odoo中。在我们自身的运营里,智能体阅读并起草;由人授权发送:这就是Transgenia用受控AI智能体运营企业的方式。
- AI提议;人来确认。 这项集成的正确结果是一份报价草稿,而不是一笔已确认的订单。草稿加签核的模式,与我们治理十二个AI智能体团队所用的模式相同。
- 先只读。 智能体以只读权限查询Odoo,由独立的技术账户创建草稿。我们的MCP服务器在该模式下拒绝所有写入。
- 版本类型决定路径,不决定结果的质量。 Enterprise自带应用;Community与Online通过外部API达到同样的草稿订单。不变的是控制。分阶段实施并在每道关口设定验收标准,见Transgenia的Claude.ai实施手册。
- 目录先于AI。 如果目录没有同义词、正确的单位与包装,智能体就无法准确解读;因此库存指南排在前面。
关于我们查询Odoo所用的工具:MCP-Odoo-Tools是一个开源的MCP服务器(MIT许可证),提供28个工具,覆盖Odoo 10至19的Community、Enterprise与Online,具备只读模式;它在PyPI上以odoo-mcp-tools 1.4.0发布,也以开源MCP插件“Odoo Tools”的形式进入Claude目录;根据截至2026年10月11日的目录管理面板数据,它累计安装506次,28天内活跃账户203个。Transgenia不代理也不存储数据:结果流向MCP客户端与模型服务商。我们自身基础设施上运行着哪些MCP服务器、如何审计,见MCP基础设施盘点。
资料来源有哪些?
本指南的每一项技术事实都有在2026年10月12日核查过的公开来源。插件数字来自Transgenia自身,并已明确标注。
- Odoo 19,WhatsApp(西班牙语文档):WhatsApp是Odoo Enterprise独有的应用,在Community版本中无法使用;Meta商业与开发者账户;“WhatsApp,配置,WhatsApp Business账户”路径;应用ID、账户ID与访问令牌;由Odoo生成的回调URL与验证令牌;模板审批;号码的待处理状态。
- Meta,WhatsApp Business Platform Cloud API:平台定义;商业资产组合为必需;企业验证;“模板消息通常需要审批后才能发送”;模板是服务时间窗之外唯一的消息类型。
- Meta,WhatsApp Business Platform入门:带WhatsApp用例的应用、WhatsApp Business账户、永久令牌与webhook。
- Odoo 19,外部JSON-2 API:“通过外部API访问数据仅在Custom定价套餐上可用”;API密钥作为bearer令牌;XML-RPC与JSON-RPC将在Odoo 22中移除。
- Odoo 19,创建报价单:确认后,报价转为可开票的销售订单。
- Odoo 19,自动化规则(Studio):自动化规则中的“发送WhatsApp”动作。
- MCP-Odoo-Tools仓库(MIT许可证):覆盖Odoo 10至19;只读模式;隐私说明。
- PyPI上的odoo-mcp-tools软件包:版本1.4.0,MIT许可证。
- Claude目录管理面板,截至2026年10月11日的数据,Transgenia内部来源:Odoo Tools插件的安装量与活跃账户。
常见问题
Odoo的WhatsApp模块在Community上能用吗,还是只有Enterprise?
只有Enterprise。Odoo 19文档原文写明:WhatsApp是Odoo Enterprise独有的应用,在Community版本中无法使用。在Community(以及Custom套餐的Online)上,通过外部API与一个中间服务完成接入。
把WhatsApp接入Odoo,我需要从Meta那里拿到什么?
一个商业资产组合、一个开发者账户、一个带WhatsApp用例并连接到WhatsApp Business账户的应用、一个专用号码、一个永久令牌,以及一个接收消息与状态的webhook。企业验证是可选的,但能提升能力。
可以用我现在的WhatsApp Business号码(手机应用)吗?
手机应用不是平台。这项集成使用Meta的WhatsApp Business Platform和一个专用号码;在同一号码上混用两者会导致故障。此外,开发者应用中处于待处理状态的号码可能导致集成无法工作。
如何把WhatsApp消息变成Odoo报价,又不让AI确认订单?
智能体提取行项目与日期,以只读权限查询目录、库存与价格表,再由一个技术账户以“报价单”状态创建报价,附标签与来源备注。确认权保留给人;当人确认时,Odoo把报价转为销售订单。
语音和照片怎么处理?
如果你选择的AI服务商能转写音频或读取图片,智能体就能处理;本指南不评估转写产品。无论如何,同样的规则适用:结构化数据、有疑问时提问,以及报价草稿。
为什么智能体不能在WhatsApp上随意回复?
因为在WhatsApp的客服时间窗之外只能发送经Meta审批的模板,也因为一条带有未经验证的价格或交付日期的消息会让公司承担义务。智能体回复由Odoo计算的摘要,把确认留给人。
在Odoo Online上可行吗?
Online上的Enterprise确实有WhatsApp应用。至于外部API路径,Odoo 19文档写明通过外部API访问数据仅在Custom套餐可用,One App Free与Standard不可用。
我需要哪个Odoo版本?
Odoo的WhatsApp应用在Enterprise 17、18与19的文档中有记载。外部API方面,Odoo 19提供带API密钥的JSON-2;更早版本使用JSON-RPC或XML-RPC,两者计划在Odoo 22中移除。Transgenia的服务面向Odoo 13至19。
webhook重试时如何避免重复订单?
用Meta的消息标识符作为幂等键:如果已存在该来源的报价,就不再创建另一份。这是向真实客户开放渠道之前测试的控制之一。
已确认的报价会自动开票吗?
不会。确认订单不应自动开具CFDI;开票遵循会计的授权流程。把商业确认与发票分开,可以避免因一条误读的消息而开出电子发票。
这能用于WhatsApp拓客或群发吗?
这不是本指南的目标,也不是我们的做法。我们把WhatsApp当作运营渠道:预约确认、订单处理,以及对已主动联系的客户做销售跟进。服务时间窗之外的发送需要已审批的模板与客户同意。
申请这一流程的评估之前,我应该准备什么?
通过WhatsApp收到的真实订单示例、你目前使用的号码与Meta账户、Odoo的版本号、版本类型与套餐、带编码与包装的目录、目前由谁确认订单,以及试点的验收标准。访问权限与令牌在评估中商定;请勿在表单中分享。
下一步做什么?
如果贵公司通过WhatsApp接收订单并运行Odoo,请阅读面向贸易公司的Odoo页面,那里汇集了本指南、迁移前的库存指南与AI报价指南,以及AI实施服务。然后申请评估:我们在报价之前先定义渠道、版本类型、权限与验收标准。
关于作者和Transgenia
Efraín Carreón Ortiz是墨西哥科技精品公司Centrum Transgenia的首席执行官。他持有Anthropic颁发的官方Claude Code徽章(Claude Partner Badge),可在Credly上验证。
Transgenia是OpenAI Partner Network中的OpenAI Select Partner,也是Anthropic Claude Partner Network中的Anthropic Registered Partner。团队:Víctor Estrada Bello,Chief PMO;Danild Johan Zambrana López,Chief Technology Officer;Jaime Lozano Castañeda,Chief Marketing Officer;Efraín Carreón Ortiz,Director General(Chief Executive Officer)。
联系我们:contacto@transgenia.org、WhatsApp +52 55 8034 0405、15分钟预约或联系页面。
继续阅读
- 如何把AI与Odoo集成,准备由人工审批的报价:本指南默认采用的Odoo状态与服务器端控制。
- 迁移前如何在Odoo中纠正库存差异:接入任何渠道之前,先要可靠的目录与库存。
- 墨西哥B2B销售的受控AI智能体:我们如何设计受控的销售智能体,以及为什么它不发垃圾消息。
- 墨西哥谁能把Claude或ChatGPT与Odoo集成?:向集成商书面索取的内容。
- 我们发布了MCP-Odoo-Tools以及MCP服务器页面:对Odoo的查询层。
- 面向B2B贸易公司的Odoo:行业中心页。
本文由AI撰写并经内部审校,尚待母语人士审阅。