WhatsApp

WhatsApp 是一款即时通讯和语音通话（VoIP）应用，用户可以发送消息、拨打电话并共享内容。企业可以使用 WhatsApp Business 与客户通过文字沟通、发送文档并提供支持。

:::: warning ::: title 警告 :::

WhatsApp 仅在 Odoo Enterprise 版本中可用，Odoo Community 版不支持。若需注册 Odoo Enterprise 版，请点击此处：Odoo 免费试用。 ::::

::: seealso 欲了解从 Odoo Community 版迁移至 Odoo Enterprise 版的更多信息，请参阅文档：/administration/on_premise/community_to_enterprise。 :::

使用 Odoo WhatsApp 应用，企业可以将 WhatsApp Business 账户（WABA）连接至 Odoo 数据库，实现以下功能：

  • 在 Odoo 数据库中直接接收并回复 WhatsApp 消息
  • 使用动态占位符/变量创建新模板
  • 发送已批准的、使用动态变量的模板，例如：
    • 来自 销售 应用的报价单
    • 来自 POS（销售点）应用的收据和发票
    • 来自 活动 应用的门票

::: seealso

WhatsApp 是 Meta（Facebook 母公司）运营的消息服务，已在全球众多国家和企业中广泛使用。本文档涵盖 WhatsApp Business 账户与 Odoo 的集成，Meta 账户在 Odoo 中通过 API（应用程序编程接口） 进行配置。

WhatsApp 连接器支持两种流程：公司发起和客户发起。公司可通过发送模板给一个或多个收件人来发起对话。模板发送后，收件人若回复，则在 讨论 窗口中出现对话（若在 15 天内回复则出现）。

若对话由客户发起（例如向公司的公开 WhatsApp 号码发送消息），Odoo 将打开一个包含所有负责该渠道的运营人员的群聊。

:::: tip ::: title 提示 :::

建议为不同部门设置多个 WhatsApp 账户，例如帮助台团队和销售团队使用不同的渠道。 ::::

::: seealso Magic Sheet - WhatsApp 配置 [PDF] :::

Odoo 与 WhatsApp 的集成使用标准的 API（应用程序编程接口） 连接，在 Meta 中的配置步骤如下：

  1. 创建 Meta 商业账户
  2. 创建 Meta 开发者账户
  3. 在 Meta 开发者控制台设置 应用 与 WhatsApp 产品
  4. 测试 API 连接

连接成功后，消息将通过 Odoo 的 讨论 应用使用 WhatsApp API 进行收发。

前往 Facebook Business Manager 创建业务账户。点击 Create account，填写企业名称、管理员姓名及工作邮箱，随后点击 Next，确认邮箱后点击 Done。

随后按照 Facebook 发送的邮件指示完成业务账户的创建与设置。

::: seealso 设置 Meta 商业账户 :::

:::: important ::: title 重要 :::

如果业务账户绑定了个人 Facebook 账户，后续配置时必须切换至业务账户。

在 Facebook Developer Console 右上角点击账户名称，在 Business Accounts 中选择对应的业务账户，即为 Odoo 发送/接收 WhatsApp 消息的目标账户。

::::

:::: important ::: title 重要 :::

创建 Meta 商业账户前，用户必须已拥有至少一小时以上的个人 Facebook 账户，否则会报错。 ::::

在 Meta for Developers 仪表盘登录开发者账户（若无则先关联 Facebook 账户创建）。

:::: note ::: title 注意 :::

Facebook 开发者 账户与 业务 账户不同；前者基于个人账户，后者管理企业资产（如应用）。 ::::

::: seealso 设置 WhatsApp Business 平台 :::

登录后点击右上角 My Apps，进入已创建的应用列表，点击 Create App 开始配置新应用。

在 Create an app 页面，选择 Other（在 “Looking for something else?” 部分），点击 Next，随后在 Select an app type 中选择 Business（第一个选项），该类型可创建并管理 WhatsApp API。

点击 Next，按照需求配置应用。

在 Details 步骤，填写 Add an app name 为 Odoo（可后续在设置中修改）。

:::: note ::: title 注意 :::

应用名称可在设置中后续更改。 ::::

:::: warning ::: title 警告 :::

不要在此文本中使用商标或品牌元素（包括 Meta 系列），否则会触发错误。 ::::

填写 App contact email（开发者邮箱），在 Business Account – Optional 中选择对应的 Meta 商业账户，最后点击 Create app。系统会弹出 Meta 平台条款与开发者政策协议。

接受协议后需输入 Facebook 密码确认，点击 Submit 完成创建，随后跳转至 Meta for Developers 仪表盘。

:::: note ::: title 注意 :::

若 Meta 商业账户被限制投放广告，则无法创建应用。可前往 https://business.facebook.com/business 进行处理，详见 Meta 广告限制文档。 ::::

在 https://developers.facebook.com/apps 中打开已创建的应用，点击页面底部的 Set up（WhatsApp 所在的框）。

::: seealso Meta WhatsApp 开发者文档 :::

进入 WhatsApp Business Platform API 配置页，使用下拉框选择要绑定的 Meta 商业账户，点击 Continue 确认。

:::: note ::: title 注意 :::

点击 Continue 即表示同意 Meta 的条款与条件。 ::::

:::: note ::: title 注意 :::

添加产品后，Meta 会提供一个测试电话号码及 5 条测试消息。 ::::

完成向导并点击 Continue 后，浏览器会跳转至 WhatsApp Quickstart 页面，在此页面可添加电话号码并发送首次测试消息。

:::: note ::: title 注意 :::

若未自动跳转，可手动前往 https://developers.facebook.com/apps，选择对应应用，在左侧菜单的 WhatsApp 部分点击 v (menu toggle)，出现 Quickstart、API Setup、Configuration 选项，选择 Quickstart 并点击 Start using the API。 ::::

点击 Start using the API 进入 API Setup，在 Send and receive messages 部分的 To 下拉框选择 Manage phone number list，添加最多 5 个号码用于测试。

:::: important ::: title 重要 :::

必须先添加接收号码才能成功发送测试，否则 API 无法验证。 ::::

系统会向所选号码发送验证码，输入后完成号码验证。

在 Step 2 Send messages with the API 中点击 Send Message，系统会向前一步配置的号码发送测试消息。收到后即可继续配置 Webhook。

以下步骤均在 Odoo 数据库内完成，需要在 Odoo 中配置令牌、电话号码、账户 ID 等信息，以生成 Callback URL 与 Webhook Verify Token，用于在 Meta 中设置 Webhook，使消息能够回传至 Odoo。

在 Odoo 中，进入 WhatsApp 应用 → 配置 → WhatsApp Business 账户，点击 New 新建业务账户。

打开另一个标签页，访问 https://developers.facebook.com → My Apps → WhatsApp → API Configuration，将下表对应的值复制到 Odoo 相应字段：

名称Meta 控制台Odoo 界面
电话Phone number IDPhone Number ID
令牌Temporary access tokenAccess Token
App IDApp IDApp ID
账户 IDWhatsApp Business Account IDAccount ID

获取 App Secret：在 Meta 开发者控制台 https://developers.facebook.com/apps 选择对应应用，左侧菜单 App settings → Basic，点击 Show 旁的 App secret，输入账户密码验证后复制。

将 App secret 粘贴到 Odoo WhatsApp Business Account 配置页的 App Secret 字段。

完成后点击 Test Connection，若配置正确，右上角会出现绿色成功提示。

在 Meta 开发者控制台的 WhatsApp → API Setup 中，找到 Step 3: Configure webhooks to receive messages，点击 Configure webhooks。

:::: tip ::: title 提示 :::

也可直接在 Meta 开发者控制台左侧菜单选择 Webhooks 进行配置。 ::::

在 Webhook configuration 页面点击 Edit，填写 Odoo 中的 Callback URL 与 Webhook Verify Token（点击 Test Connection 后已自动生成）。

在 Odoo 中打开 WhatsApp 应用 → 配置 → WhatsApp Business 账户，复制 Callback URL 与 Webhook Verify Token，分别粘贴回 Meta 对应字段，最后点击 Verify and save。

在 Meta 控制台的 Webhook fields 区域点击 Manage，勾选以下字段的 Subscribe：

  • account_update
  • message_template_quality_update
  • message_template_status_update
  • messages
  • template_category_update

点击 Done 完成。

:::: important ::: title 重要 :::

只有在 Callback URL 与 Webhook Verify Token 验证成功后，字段才会出现。 ::::

::: seealso Meta 设置 Webhook 的官方文档 :::

回到 Meta 开发者控制台的 WhatsApp → API Setup → Step 5: Add a phone number，点击 Add phone number。

填写 Business name 与 Business website or profile page（可填社交媒体 URL），选择业务所在国家，填写地址（可选），点击 Next。

在 WhatsApp Business profile 页面填写：

  • 显示名称
  • 时区
  • 类别
  • 企业描述（可选）

完成后再次点击 Next，输入要用于 WhatsApp 的电话号码。

选择验证方式（短信或电话），系统会向该号码发送验证码，输入后完成验证。

:::: warning ::: title 警告 :::

若未添加支付方式，将无法继续。请参考 Meta 添加支付方式的文档。 ::::

::: seealso Meta 添加电话号码文档 :::

完成配置并测试后，需要生成永久令牌以替代临时令牌。

  1. 前往 https://business.facebook.com/，进入 Business settings → Users → System Users。选择已有系统用户或点击 Add 新建。
  2. 为系统用户添加资产：点击 Add assets，在弹窗中选择 Apps，勾选 Odoo 应用并开启 Full control 权限，保存。
  3. 在系统用户页面点击 Generate new token，选择对应的 App，设置有效期为 60 days 或 Never。
  4. 勾选以下权限后生成令牌：
    • business_management
    • whatsapp_business_messaging
    • whatsapp_business_management
    • whatsapp_business_manage_events

复制生成的令牌，回到 Odoo WhatsApp Business Account 配置页，将其粘贴到 Access Token 字段。

:::: warning ::: title 警告 :::

若未使用永久令牌，Odoo 将出现 token error <whatsapp/token_error>。 ::::

在 Meta 开发者控制台 https://developers.facebook.com/apps 选择对应应用，将右上角的 App Mode 从 Development 切换为 Live。

:::: important ::: title 重要 :::

若未切换为 Live，Odoo 只能与测试号码通信。 ::::

:::: warning ::: title 警告 :::

上线前必须填写 Privacy Policy URL（隐私政策链接），否则无法切换为 Live。路径：App Settings → Basic → Privacy Policy URL，保存后即可上线。 ::::

WhatsApp 模板是可重复使用的预设消息，帮助企业快速发送标准化内容，提高沟通质量与用户参与度。

模板可在 Odoo 与 Meta 两端创建，以下分别说明两端的操作流程。

:::: important ::: title 重要 :::

模板在 Meta 审核通过前不可使用。详见 productivity/whatsapp/approval。 ::::

进入 WhatsApp 应用 → Templates 页面，点击 New。

在表单中填写 Name 与 Language，在 Account 下拉框选择对应的 WhatsApp Business 账户。

在 Applies to 中选择模板所关联的模型（可在开发者模式下通过字段提示获取模型名称），并确保 Phone Field 指向 Phone 或 Mobile 字段。

模板分为三个标签页：

  • Body：填写正文内容，可使用占位符 {{1}}、{{2}}... 表示动态变量。
  • Buttons：可添加 Visit Website、Call Number、Quick Reply 类型的按钮并配置相应文本或链接。
  • Variables：为正文中的占