连接集成

Pragma 使用三种设置方式。在 连接渠道 页面，每张集成卡片都会显示对应类型。

OAuth：直接连接

当 Pragma 已配置对应 Provider App，并且你可以在提供商处登录时，OAuth 是最简单的方式。

• Microsoft Teams：使用 Microsoft 连接，授权后选择 Team 和 Channel。
• Slack：使用 Slack 连接，在 Slack 弹窗中选择目标 Channel。Pragma 会自动保存 Incoming Webhook URL。
• HubSpot：使用 HubSpot 连接。如果当前部署还未启用 OAuth，可先使用 HubSpot Private App。

API Key：复制凭证

API-Key 类型需要先在提供商控制台生成 Token，然后在 工作区凭证 中保存。

• HubSpot Private App：HUBSPOT_ACCESS_TOKEN
• Pipedrive：PIPEDRIVE_API_TOKEN 和 PIPEDRIVE_COMPANY_DOMAIN
• Salesforce：SALESFORCE_ACCESS_TOKEN 和 SALESFORCE_INSTANCE_URL
• Trello：TRELLO_API_KEY、TRELLO_TOKEN、TRELLO_LIST_ID
• AI：OpenAI 或 Azure OpenAI 凭证

Callback：登记回调地址

WeCom、WeChat Official Account 和 WhatsApp 通过 Callback URL 接收入站消息。请从 Pragma 卡片复制 URL，并在提供商控制台中完全一致地填写。

• WeCom：/webhooks/wecom
• WeChat Official Account：/webhooks/wechat-oa
• WhatsApp Cloud API：/webhooks/whatsapp

如果连接失败，请打开连接页面上的帮助抽屉。里面包含产品视频、最佳实践文章和 AI 帮助助手。