在现代商业环境中，企业通常运行多个不同的软件系统，这些系统服务于不同的目的。这些系统可能包括销售管理软件、会计系统、营销工具或定制开发的内部应用程序。每个系统都包含宝贵的数据，并在业务运营中发挥着至关重要的作用。

最大的挑战并非数据匮乏，而是这些数据分散在多个平台上。员工不得不频繁切换系统，多次手动输入相同的信息，并且无法全面了解客户情况。这不仅浪费时间，还会增加出错风险，错失商机。

GTG CRM 的集成中心和 API 旨在从根本上解决这个问题。该解决方案无需企业替换现有系统，而是搭建一座连接这些系统的桥梁。数据可以在平台间自由流动，流程实现自动化，更重要的是，人工智能代理可以参与处理，从而提高运营效率。

本文档将为企业提供详细的分步说明，以成功实施集成，从创建应用程序和配置访问权限，到使用 API 读取和写入数据，设置 webhook 以接收自动化事件，最后与 AI 代理结合，创建全自动智能处理工作流程。

主要功能概述

集成中心和 API 提供了一套全面的工具，使企业能够通过标准的 RESTful API 协议将 GTG CRM 与任何应用程序连接起来。API 令牌管理系统采用精细的基于范围的授权机制，确保了高度安全性，并允许对每个集成应用程序的访问权限进行精确控制。

AI代理集成是一项关键的差异化优势，它使企业能够利用人工智能自动处理数据并执行复杂任务，而无需进行编程。企业可以管理多个角色各异的AI代理，每个代理都针对特定用途进行训练。

GTG CRM 与外部系统之间双向数据同步的功能确保企业始终拥有一致的客户信息视图。全面的 API 文档（包括 curl 命令示例）使开发人员能够轻松进行集成和调试。企业可以实时查询联系人列表、任务、交易记录并更新信息。

Webhook 端点允许从外部系统自动检索数据，无需持续轮询。结合自动化和 AI 代理，企业可以构建全自动的事件处理工作流程。生态系统中集成的网站构建器支持直接从 GTG CRM 创建网站，并提供完整的 SEO 功能和自动生成的站点地图。

分步用户指南

步骤 1：创建集成应用程序

集成的第一步是在 GTG CRM 中创建一个新应用程序。访问“集成与 API”菜单，然后点击“创建新应用程序”按钮。为应用程序指定一个便于后续管理的名称，例如“销售系统集成”或“移动应用程序”。输入名称后，点击“创建”完成操作。

步骤 2：配置访问权限

基于范围的权限允许对应用程序可以对 CRM 数据执行的操作进行精确控制。创建应用程序后，选择新创建的应用程序，然后访问“访问权限”或“范围”选项卡。在这里，您将看到可以授予的权限列表。

如果应用程序只需要读取联系人信息，请选择“contacts.read”权限范围。如果需要创建和更新联系人，请添加“contacts.write”权限范围。要允许应用程序读取系统中 AI 代理的信息，请授予“agents.read”权限。如果希望应用程序能够请求 AI 代理执行任务，请授予“agents.execute”权限。选择必要的权限后，单击“保存”以更新配置。

步骤 3：创建 API 令牌

令牌是一种身份验证密钥，允许外部应用程序安全地调用 GTG CRM 的 API。在应用程序详情页面中，找到“API 令牌”部分，然后单击“生成令牌”。令牌仅显示一次，格式以“gtg_”开头，请立即复制并将其保存在安全的地方。此令牌需要在每个 API 请求的 Authorization 标头中使用。

重要提示：如果在创建令牌后向应用程序添加新的权限，旧令牌不会自动拥有这些新权限。您需要创建一个新令牌才能获得完整的已配置访问权限。

步骤 4：检查 API 连接

获取令牌后，下一步是验证集成是否正常工作。最简单的方法是在终端中使用 curl 命令。以下示例演示了如何从 GTG CRM 检索联系人列表。

 curl -X GET https://api.gtgcrm.com/v1/integration/contacts \ -H "Authorization: Bearer YOUR_API_TOKEN"如果连接成功且令牌具有足够的权限，您将收到一个 JSON 响应，其中包含联系人列表以及 ID、姓名、电子邮件、电话号码和其他数据字段等完整信息。 curl -X GET https://api.gtgcrm.com/v1/integration/contacts \ -H "Authorization: Bearer YOUR_API_TOKEN"

 { "data": [ { "id": "contact_123", "name": "Nguyễn Văn A", "email": "nguyenvana@example.com", "phone": "0901234567" } ] }步骤 5：与您的系统集成{ "data": [ { "id": "contact_123", "name": "Nguyễn Văn A", "email": "nguyenvana@example.com", "phone": "0901234567" } ] } 

测试成功后，您可以将 API 集成到您的实际应用程序中。以下示例使用 Node.js，Node.js 是最流行的后端开发语言之一。此代码片段演示了如何在 GTG CRM 中检索联系人列表并创建新联系人。

 const axios = require('axios'); const API_URL = 'https://api.gtgcrm.com/v1/integration'; const API_TOKEN = 'your_api_token_here'; async function getContacts() { const response = await axios.get(`${API_URL}/contacts`, { headers: { 'Authorization': `Bearer ${API_TOKEN}` } }); return response.data; } async function createContact(contactData) { const response = await axios.post(`${API_URL}/contacts`, contactData, { headers: { 'Authorization': `Bearer ${API_TOKEN}`, 'Content-Type': 'application/json' } }); return response.data; }同样，您可以使用任何其他编程语言，例如 Python、PHP、Java 或 C# 进行集成。一般原则是始终在 Authorization 标头中发送令牌，格式为“Bearer YOUR_TOKEN”，并且对 POST 或 PUT 请求使用“application/json”内容类型。 const axios = require('axios'); const API_URL = 'https://api.gtgcrm.com/v1/integration'; const API_TOKEN = 'your_api_token_here'; async function getContacts() { const response = await axios.get(`${API_URL}/contacts`, { headers: { 'Authorization': `Bearer ${API_TOKEN}` } }); return response.data; } async function createContact(contactData) { const response = await axios.post(`${API_URL}/contacts`, contactData, { headers: { 'Authorization': `Bearer ${API_TOKEN}`, 'Content-Type': 'application/json' } }); return response.data; }

步骤 6：在实际过程中应用 AI 代理。

为了更清晰地了解集成中心的价值，不妨考虑一个真实的业务场景。当新客户在公司销售网站上完成注册后，无需员工手动在客户关系管理系统 (CRM) 中创建客户资料并发送欢迎邮件，整个流程都可以实现自动化。

流程如下：首先，客户在销售网站上填写注册表单。网站后台立即调用GTG CRM API，创建一个包含完整客户信息（例如姓名、电子邮件、电话号码和客户来源）的新联系人。

 curl -X POST https://api.gtgcrm.com/v1/integration/contacts \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Trần Thị B", "email": "tranthib@example.com", "phone": "0987654321", "source": "Website" }'一旦在GTG CRM中创建联系人，AI代理就会自动将其识别为来自网站的新客户。代理会分析客户信息，发送个性化的欢迎邮件，而非通用模板。同时，代理还会为销售人员创建后续任务，要求他们在24小时内致电客户进行咨询。 curl -X POST https://api.gtgcrm.com/v1/integration/contacts \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Trần Thị B", "email": "tranthib@example.com", "phone": "0987654321", "source": "Website" }'

这种自动化流程的优势显而易见。客户注册后立即收到欢迎邮件，给人留下专业印象，并增强信任感。无需人工干预，节省时间并最大限度地减少错误。邮件内容根据客户信息进行个性化定制，而非通用内容。销售人员会收到通知并有明确的跟进任务，确保不错过任何商机。所有这些因素共同作用，有助于提高潜在客户转化为实际客户的转化率。

步骤 7：设置 Webhook 以自动接收数据。

Webhook 是一种技术，它允许外部系统在事件发生时主动向 GTG CRM 发送数据，而无需持续轮询检查。要开始使用，请转到“集成和 API”页面，选择“Webhook”选项卡，然后单击“创建新 Webhook”并为 Webhook 指定一个有意义的名称。

创建完成后，系统将提供两项重要信息。Webhook URL 是外部系统通过 HTTP POST 请求发送数据的端点。签名密钥是一个用于验证请求是否确实来自授权系统而非伪造来源的密钥。

务必注意，签名密钥仅在创建 Webhook 时显示一次。请立即将其复制并保存到公司安全的密钥管理系统中。如果丢失此密钥，您将需要创建一个新的 Webhook。

要测试 Webhook 是否正常工作，请使用 curl 命令发送测试事件。该请求需要包含 Content-Type 标头（类型为 application/json）和 X-Webhook-Signature 标头（包含用于身份验证的签名密钥）。

 curl -X POST "YOUR_WEBHOOK_URL" \ -H "Content-Type: application/json" \ -H "X-Webhook-Signature: YOUR_SIGNING_SECRET" \ -d '{ "event": "order.completed", "eventId": "evt_123456", "data": { "orderId": "ORD-001", "customerName": "Nguyễn Văn A", "amount": 500000 } }'如果 webhook 工作正常，您将在已接收事件列表中看到此事件。 curl -X POST "YOUR_WEBHOOK_URL" \ -H "Content-Type: application/json" \ -H "X-Webhook-Signature: YOUR_SIGNING_SECRET" \ -d '{ "event": "order.completed", "eventId": "evt_123456", "data": { "orderId": "ORD-001", "customerName": "Nguyễn Văn A", "amount": 500000 } }' 

步骤 8：将 Webhook 与自动化和 AI 代理相结合

只有将 Webhook 与自动化流程和 AI 代理结合使用，才能充分发挥 Integration Hub 的真正威力。这使得企业能够构建智能流程，自动响应来自外部系统的事件，无需人工干预。

要设置流程，请访问 GTG CRM 中的“自动化”菜单，然后单击“创建新流程”。

最重要的部分是配置触发器，以便流程知道何时激活。选择“外部集成”模块、“Webhook”对象和“获取数据”操作。这意味着，每当 Webhook 收到来自外部系统的事件时，流程都会自动触发。

配置触发器后，将 AI 代理任务添加到工作流中。点击“添加任务”，选择“AI”模块，然后选择“AI 代理任务”。在这里，您可以编写指令，指导 AI 代理如何处理从 Webhook 接收到的数据。

AI代理的提示信息是企业展示其业务逻辑的地方。例如，您可以编写如下提示：“当订单完成时，创建一份文档记录，记录接收该事件的时间和订单信息。然后向客户发送感谢邮件，并通知销售团队。”

配置完成后，将进程状态更改为“激活”。从现在开始，每当外部系统向 webhook 发送事件时，AI 代理将自动按照指示执行任务。

事件提交后，您可以在流程执行历史记录中跟踪处理进度。AI 代理会记录处理结果，以便企业进行检查和审核。

本文件系应要求制作：

真实案例研究：MM3.vn 实现营销内容自动化。

MM3是一家运营网站mm3.vn的公司，它利用Integration Hub结合人工智能代理，实现了内容创作流程的完全自动化——从市场数据收集、AI图像生成、分析性写作、网站发布、社交媒体推广到自动化SEO。最终成果是：内容创作人员从2-3人减少到零，文章产量却不受限制。

📖 阅读关于 MM3.vn 的详细案例研究 →

使用集成中心的核心优势

节省时间是最直接、最显而易见的好处。系统间数据同步的自动化彻底消除了手动数据录入，这项工作既耗时又容易出错。员工可以将精力集中在更有价值的任务上，而不是重复性工作。

对于已投资软件系统的企业而言，充分利用现有基础设施是一项显著优势。企业无需更换所有现有技术，只需连接 GTG CRM 即可添加人工智能和自动化功能。这最大限度地降低了业务中断的风险，并保护了技术投资。

借助人工智能客服提升销售效率，这些客服人员能够提供全天候不间断的客户服务。每个销售机会都会被追踪并及时处理，确保不会因员工繁忙或工作时间超出正常工作范围而错失任何潜在客户。

灵活的可扩展性是 API 架构的一大优势。企业可以根据业务需求的变化轻松添加新功能或连接到其他系统。由于不受固定平台的限制，企业可以根据自身节奏进行调整和扩展。

通过具有范围和令牌的细粒度访问管理系统，确保安全控制。企业可以为每个集成应用程序授予精确的权限，从而确保敏感数据只能由授权系统访问。

双向 Webhook 将集成能力扩展到了传统 API 解决方案的极致。企业不仅可以根据需要主动调用 API，还可以自动实时接收来自外部系统的数据。

内容自动化是 GTG CRM 的一项独特功能。通过将 Webhook 与自动化和 AI 代理相结合，企业可以从原始数据中自动生成文章、图片和社交媒体帖子。这对于内容或营销领域的企业尤其有用。

通过集成网站地图和谷歌搜索控制台的网站构建器实现自动化 SEO，确保所有新内容都能被搜索引擎快速发现和索引，从而为您的企业带来自然流量。

实施过程中需要考虑的重要因素。

令牌安全至关重要。API 令牌用于访问关键业务数据，绝不应与外部人员共享或写入源代码。令牌应存储在环境变量或专用密钥管理系统中。如果怀疑令牌已被泄露，应立即撤销该令牌并创建新令牌。

更改权限时刷新令牌是必须牢记的规则。每次向应用程序添加新的作用域时，当前令牌不会自动包含新权限。企业必须重新创建令牌，以确保新令牌包含所有已配置的权限。忘记此步骤通常会导致难以调试的“权限被拒绝”错误。

使用签名密钥保护 Webhook 与保护令牌类似。此密钥仅在创建 Webhook 时显示一次，因此必须立即存储。发送事件的外部系统需要在请求头中包含此密钥，以便 GTG CRM 可以验证请求的有效性。

速率限制是一种防止系统过载的机制。API 在特定时间段内对请求次数有限制。应用程序需要实现指数退避的重试逻辑，避免在短时间内调用 API 过多。如果超过速率限制，请求将被拒绝，并返回 HTTP 状态码 429。

在将数据发送到 API 之前进行验证有助于避免不必要的错误。在客户端调用 API 之前检查电子邮件格式、字符串长度和其他数据限制，可以节省 API 配额并改善用户体验。

监控和日志记录对于及早发现集成问题至关重要。跟踪日志和自动化执行历史记录，确保 Webhook 接收到正确的数据，AI 代理按预期处理，并且不会遗漏任何错误。GTG CRM 提供了一个监控仪表板，方便企业跟踪集成状态。

提示式人工智能代理需要编写得清晰明确。针对每种事件类型的处理指令越详细，人工智能的结果就越准确。例如，不要只写“处理事件”，而应该写成“当事件按订单完成时，创建一份记录时间和订单信息的文档，然后使用模板A向客户发送感谢邮件，最后为销售团队创建一个24小时截止的任务”。

总结

GTG CRM 的集成中心和 API 是一套全面的集成解决方案，可帮助企业将现有系统与前沿 AI 技术连接起来，而无需彻底改造其技术基础架构。通过详细的分步指南，从应用程序创建和权限配置到 Webhook 设置和与 AI 代理集成，企业可以构建智能自动化流程，并显著节省运营资源。

MM3案例研究清晰地展示了该解决方案的潜力，它不仅能够自动化简单的任务，还能构建从原始数据到发布内容以及自动化SEO的完整价值链。更重要的是，该解决方案无需深厚的编程知识或庞大的技术团队，只需对API有基本的了解，并能够用自然语言为AI代理编写指令即可。

凭借其精细的访问控制系统、多层安全防护和灵活的可扩展性，Integration Hub 适用于各种规模的企业，从初创公司到大型企业。企业可以从简单的集成入手，例如联系人列表同步，然后逐步扩展到更复杂的流程，例如内容自动化、自动化客户服务或支付处理和发票开具。

对于初创企业，我们建议采用循序渐进的方法，在每个阶段进行全面测试，并在正式部署前利用 GTG CRM 的免费试用版熟悉系统。首先进行简单的 Webhook 测试，了解其工作原理，然后随着经验的积累逐步升级到更复杂的任务。

GTG CRM 的支持团队随时准备提供详细的集成解决方案建议，这些方案均根据每个企业的具体需求和现有技术基础架构量身定制。在集成实施和优化过程中，如有任何疑问或需要帮助，请随时联系我们。