摘要
WATI Bitrix24 整合允许企业通过 Bitrix24 CRM 平台直接与客户在 WhatsApp 上进行无缝沟通。通过此整合，您可以：
使用 META 批准的模板发送 WhatsApp 营销活动。
在 Bitrix24 中回复客户查询。
将消息分配给可用代理。
自动创建潜在客户或联系人。
本指南解释了将 WATI 与 Bitrix24 进行整合的逐步过程。
说明
访问要求
您必须拥有活跃的 WATI Pro 或 Business Plan 订阅。
此整合仅针对 Pro+ 方案 客户提供。
为什么要进行 Bitrix24 整合？
关键益处
无缝 WhatsApp 消息传递：直接在 Bitrix24 中与客户交流。
自动化潜在客户和联系人创建：根据传入消息自动创建和更新联系人。
集中式沟通：所有 WhatsApp 互动均存储在 Bitrix24 CRM 中。
提高工作效率：使用 Bitrix24 开放渠道分配和管理对话。
Bitrix24 整合的关键功能
发送 WhatsApp 模板消息
使用 WATI 从 Bitrix24 发送 WhatsApp 批准的模板消息。
消息可以从工作流或营销活动中启动。
双向消息传递
直接从 Bitrix24 开放渠道接收和回复服务消息。
CRM 集成
传入消息将自动链接到 Bitrix24 CRM 中的相关潜在客户/联系人。
开放渠道集成
存储所有客户对话并将其分配给队列中的多个代理。
自动联系人创建
传入消息会触发自动创建潜在客户/联系人/交易。
通过将消息链接到现有联系人，避免重复项。
如何整合 WATI 与 Bitrix24
步骤 1：从 WATI 获取 API 凭证
登录您的 WATI 帐户。
导航至 更多 → API 文档。
复制 访问令牌 和 API 端点 URL。
步骤 2：在 Bitrix24 中创建入站 Webhook
在 Bitrix24 中，请转到 应用程序菜单 → 开发者资源 → 其他 → 入站 Webhook → 创建。
为以下内容分配权限：
CRM
消息服务
聊天和通知
从标有“Webhook 以调用 REST API”的字段复制 Webhook URL。
此 Webhook 将使 WATI 和 Bitrix24 之间的通信无缝进行。
步骤3：在 Bitrix24 Marketplace 中配置 WATI
安装 WATI 应用程序：
首先，从 Bitrix24 Marketplace 安装 WATI 应用程序。安装后，导航至应用程序设置。
输入 API 和 Webhook 详细信息：
将以下详细信息粘贴到其各自字段中：
WATI API 端点（来自步骤 1 的副本）
访问令牌（来自步骤 1 的副本）
Bitrix 入站 Webhook URL（来自步骤 2 的副本）
完成后，保存您的设置。
设置开放渠道配置
对于开放渠道配置，您需要在 Bitrix24 开发者资源中创建一个新应用程序。以下是步骤：
以管理员身份登录 Bitrix24
登录到 Bitrix24 应用程序，并以 管理员 身份登录。
从左侧菜单中，选择 开发者资源。
导航至常用用例
在 常用用例 选项卡下，向下滚动到页面底部。
点击 其他 选项。
设置本地应用程序配置
选择 本地应用程序 选项。
在应用程序配置页面中，输入以下详细信息：
处理程序路径：
https://apps.izaap.in/apps/wat/index2.php初始安装路径：
https://apps.izaap.in/apps/wat/install_open_channel.php菜单项文本（英文 - en）：
Wat Open Channel Application Configuration
分配以下权限：
外部即时通讯连接器（
imconnector）开放通道（
imopenlines）
单击页面底部的 保存。
复制客户端 ID 和 Secret Key
配置保存后，复制 应用程序客户端 ID 和 Secret Key。
单击同一页面上的 重新安装 以安装应用程序，确保看到成功消息。
将客户端 ID 和 Secret Key 粘贴到 WATI Marketplace 中
返回 WATI Marketplace 应用程序索引页面。
将复制的 客户端 ID 和 Secret Key 粘贴到其各自字段中。
访问和配置联系中心
前往联系中心页面
导航至联系中心页面：
https://<your-domain>/services/contact_center/。选择 Wati 归档公开通道 连接。
连接和配置 Wati 归档公开通道
从归档公开通道下拉菜单中，选择 Wati 归档公开通道 并单击 连接。
连接后，您可以使用此归档公开通道：
通过 Wati 收到客户消息。
直接在归档公开通道中回复消息。
使用归档公开通道中的 配置 选项根据需要调整设置。
在配置页面上，从来源下拉列表中选择 Wati 作为 CRM 源。
关键说明
替换
<your-domain>：确保将<your-domain>替换为您的实际 Bitrix24 域名。测试集成：在操作中，缺少翻译
步骤 4：将 WATI 模板与 Bitrix24 同步
打开 Bitrix24 Marketplace 中的 WATI 应用程序。
点击 同步模板，以更新 Bitrix24 中的 WATI 模板。
步骤 5：通过工作流发送模板消息
在 Bitrix24 CRM 中，进入 工作流 → 应用程序活动 → [Wati API] 发送模板消息。
输入以下内容：
客户的电话号码。
WATI 模板名称。
模板参数密钥和值。
点击 发送。
发送消息后，响应将在工作流的附加结果部分中提供。
关于 WATI 模板的重要说明：
在 WATI 模板中，参数变量用花括号
{}括起来。设置工作流时：在 模板参数密钥 字段中，输入模板参数变量。
要指定与 WATI 模板中出现顺序相同的对应值
如果未填写 模板参数密钥 和 值 字段，系统将自动使用 WATI 模板中定义的密钥和值。
工作流响应将包括消息状态、收件人的电话号码和 WATI 模板信息等细节。
步骤 6：发送 WhatsApp 广告活动
使用 Bitrix24 CRM 向客户发送批量 WhatsApp 广告活动非常简单。按照以下简单步骤设置并启动您的广告活动：
前往营销菜单
在 Bitrix24 CRM 中，导航至您的 营销 菜单。
从顶部菜单中，选择 广告活动。
选择广告活动类型
选择 SMS 广告活动 作为广告活动类型。
选择您希望在广告活动中使用的 WhatsApp 模板。
设置广告活动
指定 SMS 提供程序类型（选择 WATI 或您首选的提供程序）。
为您的广告活动创建一个 目标分段（例如，客户的特定组）。
输入模板名称
在消息文本框中，以以下格式输入模板名称：
[wati_template, wati_template2]您可以从 WATI 帐户的 广播 部分复制模板名称并粘贴在这里。
安排您的广告活动
保存广告活动详细信息。
选择发送广告活动的日期和时间。
跟踪交付状态
广告活动发送后，您可以在此页面上跟踪广告活动的交付状态 SMS 广告活动列表。
步骤 7：在 WATI 中配置 Webhook
Webhook 是跟踪传入客户消息并监控 WATI 中发送消息状态的强大方式。通过设置 Webhook，可以确保系统保持实时更新。让我们按照以下步骤进行 WATI 帐户中的 Webhook 配置。
配置 Webhook 的逐步指南
登录到您的 WATI 帐户：
首先，登录到您的 WATI 帐户。如果不想有，您需要先创建一个帐户。
导航至 Webhook 设置：
登录后，进入 更多 菜单，然后选择 Webhook，并单击 添加 Webhook。
输入 Webhook URL：
您需要输入以下WebhookURL,请确保将YOUR BITRIX24 DOMAIN替换为您的实际的Bitrix24服务地址入口域名
收到消息的网络钩子URL
https://apps.izaap.in/apps/wati/message_received_webhook_handler.php?DOMAIN=YOUR BITRIX24 DOMAIN
模板消息发送/失败 Webhook URL
https://apps.izaap.in/apps/wati/template_message_delivered_webhook_handler.php?DOMAIN-YOUR BITRIX24 DOMAIN
会话消息已发送 Webhook URL
https://apps.app.in/apps/wati/message_delivered_webhook_handler.php?DOMAIN=YOUR BITRIX24 DOMAIN
选择事件类型：
输入webhook网址后，选择下拉菜单中的适当事件类型。这样可以确保Webhook针对正确操作（例如，接收到消息、消息已发送等）触发。
启用 Webhook：
确保从下拉菜单中选中 已启用 选项以启用Webhook。
保存您的设置：
设置完成后，单击 保存以应用更改。
重要提示
取代您的 Bitrix24 網域：請務必將 Webhook URL 中的「您的 Bitrix24 網域」替換為您的實際 Bitrix24 入口網站 URL。這可確保 Webhook 正確連結到您的系統。
測試您的 Webhook：設定完成後，最好測試 Webhook，以確保其正常運作。
常見問題 (FAQ)
一般問題
1. 什麼是 WATI Bitrix24 整合？
→ WATI Bitrix24 整合允許企業在 Bitrix24 CRM 中直接發送和接收 WhatsApp 訊息，從而實現無縫的客戶溝通。
2. 誰可以使用此整合？
→ 此整合適用於 WATI Pro+ 方案的客戶。
3. 為什麼我要將 WATI 與 Bitrix24 整合？
→ 它有助於集中溝通、自動建立潛在客戶/聯絡人，並透過在 Bitrix24 中管理對話來提升工作流程效率。
設定與配置
4. 在將 WATI 與 Bitrix24 整合之前需要哪些先決條件？
您必須擁有有效的 WATI Pro 或 Business 方案訂閱。
需要具備相應權限的 Bitrix24 存取權。
5. 我在哪裡可以找到我的 WATI API 憑證？
→ 登錄您的 WATI 帳號，前往「更多」→「API Docs」，然後複製 Access Token 和 API Endpoint URL。
6. 我如何在 Bitrix24 中建立入站 webhook？
前往「應用程式選單」→「開發者資源」→「其他」→「入站 Webhook」→「建立」。
分配必要的權限。
複製 Webhook URL 以供 WATI 使用。
7. 建立入站 webhook 時應分配哪些權限？
→ 您需要授予以下權限：
CRM
Messaging Service
Chat and Notifications
8. 我如何在 Bitrix24 中安裝和配置 WATI 應用程式？
從 Bitrix24 Marketplace 安裝 WATI 應用程式。
在應用程式設定中輸入您的 API 和 webhook 詳細資訊。
儲存配置。
9. 我如何在 Bitrix24 中為 WATI 設定開放通道？
在 Bitrix24 開發者資源中建立本地應用程式。
輸入 handler 和安裝路徑。
分配外部訊息連接器和開放通道的權限。
儲存配置並重新安裝應用程式。
10. 我在哪裡輸入 Client ID 和 Secret Key？
→ 設定開放通道後，將複製的 Client ID 和 Secret Key 貼到 WATI Marketplace 應用程式設定中。
WhatsApp 訊息與 CRM 整合
11. 我可以從 Bitrix24 發送 WhatsApp 訊息嗎？
→ 是的，您可以使用 WATI 核准的範本，透過工作流程或行銷活動發送 WhatsApp 訊息。
12. 在 Bitrix24 中如何處理收到的 WhatsApp 訊息？
→ 訊息會自動連結到相關的潛在客戶/聯絡人，並儲存在 Bitrix24 開放通道中。
13. 新的 WhatsApp 訊息會自動建立聯絡人嗎？
→ 是的，收到的訊息可以觸發自動建立潛在客戶/聯絡人，避免重複紀錄。
範本訊息與行銷活動
14. 我如何將 WATI 範本與 Bitrix24 同步？
→ 在 Bitrix24 Marketplace 中開啟 WATI 應用程式，然後點擊「同步範本」。
15. 我如何透過工作流程發送範本訊息？
在 Bitrix24 CRM 中，前往「工作流程」→「應用程式活動」→ [Wati API] Send Template Message。
輸入客戶的電話號碼和 WATI 範本詳細資訊。
點擊「發送」。
16. 我應如何在工作流程中格式化範本參數？
使用大括號 {} 來表示變數。
按照 WATI 範本中出現的順序輸入參數。
如果留空，將使用預設的範本鍵和值。
17. 我可以從 Bitrix24 發送大批量 WhatsApp 行銷活動嗎？
→ 是的，您可以透過 Bitrix24 CRM 的「行銷」選單發送活動。
18. 我如何在 Bitrix24 中設定 WhatsApp 行銷活動？
前往「行銷」→「活動」。
選擇「SMS 行銷活動」作為類型。
選擇 WATI 作為供應商並輸入範本名稱。
排程並啟動您的活動。
19. 我如何追蹤 WhatsApp 行銷活動的傳送情況？
→ 傳送狀態可在「SMS 行銷活動清單」頁面中查看。
Webhooks 與自動化
20. 什麼是 webhooks，為什麼我要使用它們？
→ Webhooks 可啟用即時更新，用於收到的訊息和訊息傳送狀態。
21. 我如何在 WATI 中配置 webhooks？
登入 WATI。
前往「更多」→「Webhooks」→「新增 Webhook」。
輸入收到訊息、已發送和傳送狀態的 webhook URL。
選擇事件類型並啟用 webhook。
22. 我如何測試我的 webhooks 是否正常運作？
→ 設定完成後，發送一則測試訊息，並驗證資料是否正確接收到 Bitrix24。