跳到主要内容

配置

安装和激活 WhatsApp Cloud API Chat & Marketing 模块后，您需要配置 Perfex CRM 与 Meta WhatsApp Cloud API 之间的连接。这包括设置 Meta 应用、生成 API 凭据、配置 webhook 和调整模块设置。

Meta 应用配置​

WhatsApp Cloud API 通过 Meta（Facebook）应用访问。如果您尚未创建，请按照以下步骤操作。

步骤 1 — 创建 Facebook Developers 账户​

  1. 前往 developers.facebook.com。
  2. 使用您的 Facebook 账户登录。
  3. 如果提示，请注册为开发者，接受条款并验证您的账户。

步骤 2 — 创建 Meta 应用​

  1. 在 Facebook Developers 仪表板中，点击 Create App。
  2. 选择 Business 作为应用类型（如果您的账户类型不支持 Business，则选择 Other）。
  3. 输入 App Name（例如 "Perfex CRM WhatsApp"）和您的 联系邮箱。
  4. 选择您的 Business Account（如需要则创建一个）。
  5. 点击 Create App。

步骤 3 — 将 WhatsApp 添加到您的应用​

  1. 在新应用的仪表板中，找到产品列表中的 WhatsApp 并点击 Set Up。
  2. 按照引导设置链接 WhatsApp Business Account。
  3. 系统自动提供用于开发的 测试电话号码。您可以稍后添加自己的已验证商业电话号码。
信息

测试电话号码允许您向最多 5 个预注册号码发送消息。对于生产使用，请在 WhatsApp Business Account 设置中添加并验证您自己的商业电话号码。

步骤 4 — 生成永久访问令牌​

默认的临时令牌在 24 小时后过期。对于生产环境，请生成永久 System User 令牌：

  1. 前往 business.facebook.com 并导航到 Business Settings > System Users。
  2. 创建一个新的 System User（或使用现有的），并赋予 Admin 访问权限。
  3. 点击 Generate New Token，选择您的 WhatsApp 应用，并授予以下权限：
    • whatsapp_business_messaging
    • whatsapp_business_management
  4. 复制生成的令牌——这是您的 永久访问令牌。
注意

永久令牌仅显示一次。请安全存储。如果丢失，您需要生成新的令牌并更新模块设置。

Webhook 配置​

Webhook 允许 WhatsApp 实时通知您的 Perfex CRM 实例有关传入消息、送达回执和状态更新。

设置 Webhook​

  1. 在 Facebook Developers 仪表板中，前往您应用的 WhatsApp > Configuration 页面。
  2. 在 Webhook 下，点击 Edit。
  3. 输入模块提供的 Callback URL（在 Perfex CRM 中的 WhatsApp Module > Settings 中找到）。通常格式如下： 
    https://your-perfex-domain.com/whatsapp_cloud_api/webhook
  4. 输入模块设置中显示的 Verify Token。
  5. 点击 Verify and Save。
  6. 订阅以下 webhook 字段：
    • messages
    • message_template_status_update
提示

您的 Perfex CRM 安装必须通过 HTTPS 提供服务，并具有有效的 SSL 证书。Meta 将拒绝使用 HTTP 或无效/自签名证书的 webhook URL。

模块设置​

完成 Meta App 设置后，在 Perfex CRM 中配置模块。

  1. 在 Perfex CRM 侧边栏中导航到 WhatsApp Cloud API 模块。
  2. 前往 Settings 并输入以下内容：
设置描述
Access Token上面生成的永久 System User 令牌
Phone Number ID在您的 Meta App 的 WhatsApp > Getting Started 页面中找到
WhatsApp Business Account ID在您的 Meta App 的 WhatsApp 设置中找到
Webhook Verify Token您自定义的字符串——必须与您在 Meta webhook 设置中输入的一致
App ID您的 Meta App 的 ID（在应用仪表板中找到）
  1. 点击 Save Settings。
  2. 使用 Test Connection 按钮验证模块是否能与 WhatsApp Cloud API 通信。

嵌入配置​

对于高级设置，模块支持在外部页面或客户门户中嵌入 WhatsApp 聊天小部件。导航到 WhatsApp Module > Settings > Embed 以生成嵌入代码片段并自定义小部件外观（颜色、位置、欢迎消息）。

商业验证​

要解锁完整的消息容量和所有模板类别的访问权限，请完成 Meta 商业验证：

  1. 前往 business.facebook.com > Business Settings > Security Center。
  2. 点击 Start Verification 并按照引导流程操作。
  3. 按照 Meta 的要求提交您的商业文件。
  4. 验证通常需要 2-5 个工作日。
信息

未完成商业验证时，您的消息限制为每 24 小时滚动窗口内 250 个唯一收件人。验证后，限制会根据消息质量和数量逐步增加。

下一步​

  • 使用指南 — 了解如何使用聊天界面、运行营销活动、配置机器人和管理模板
  • WhatsApp 日志 — 查看所有自动化交互的完整记录