Telegram CRM

Telegram CRM API - 自动化您的 Telegram 工作流

Entergram 的公开 REST API。将 Telegram 聊天和联系人同步到您的数据仓库，根据外部事件触发广播，以编程方式创建工单，并构建内部工具--所有操作均通过工作区级别、可审计的 API 密钥完成。

概览

概览: Telegram CRM API

Entergram 的 REST API 为您提供对整个 Telegram CRM 工作区的编程访问能力。将聊天和联系人同步到 BigQuery、Postgres、HubSpot 或 Salesforce。当 Stripe 支付失败或交易达成时，触发 Telegram 广播。根据监控告警创建工单。构建您的团队真正需要的内部仪表板。每次 API 调用均为工作区级别、可审计记录，并受平台统一的最小权限范围模型约束。密钥支持轮换、IP 限制，并可一键吊销。如需 AI 智能体集成，请参阅配套的 Telegram MCP 服务器页面--它通过 Model Context Protocol 暴露相同的数据接口，让 Claude、ChatGPT 和其他 AI 智能体能够直接与您的 Telegram 工作区交互。

您完整的 Telegram CRM，代码触手可及

您在 Entergram 仪表板里做的一切，代码也能做到。它就是一个简洁的 REST API--工作区级别密钥、JSON、标准 HTTP 动词--任何能发起请求的语言都能列出并搜索 Telegram 聊天、读取消息记录、管理联系人和自定义字段、开立并更新工单、触发广播。权限只需设置一次：同一套权限范围同时覆盖 API、MCP 服务器和 Make. com 集成。

阅读 API 文档

你的 Telegram 账号

你的技术栈

欧洲销售 @lumen_sales_eu
美国销售 @lumen_sales_us
客服 @lumen_support
合作伙伴 @lumen_partners

Entergram

HubSpot
Zendesk
Slack
Notion
Make.com
你的 API

将 Telegram 同步到您的数据仓库
按计划从 Entergram 拉取聊天、联系人和自定义字段值。将其导入 BigQuery、Postgres、HubSpot 或 Salesforce，让业务其他部门能够将 Telegram 数据与其他所有渠道的数据进行关联分析。只需一个夜间定时任务和几次 API 调用即可实现。
根据外部事件触发 Telegram 广播
当 Stripe 出现支付失败、CRM 中交易达成、监控告警触发时--向 Entergram 发送 POST 请求，即可向正确标签细分的用户群发送使用正确模板的 Telegram 广播。无需离开现有技术栈，即可实现事件驱动的消息通知。
以编程方式创建工单
表单、监控工具、支持邮件管道--任何发生结构化事件的地方--都可以通过 POST 请求创建工单，并将其与正确的 Telegram 聊天关联，设置正确的优先级和 SLA。打通 Telegram 与您团队使用的其他所有渠道之间的闭环。
内部工具与仪表板
构建您团队真正需要的领导力仪表板--按阶段划分的管道、每位代表的响应时间、工单吞吐量--由 Entergram 的 API 提供数据支撑。工作区级别意味着它只能访问您自己的数据。可与 Retool、Appsmith 或自定义 React 前端配合使用。

规格

Telegram CRM API 详解

规格

了解更多

根据外部触发器自动标记聊天客户在您的产品中达到里程碑 → API 调用添加 VIP 标签并提升阶段列。下次打开 Telegram 聊天时，CRM 上下文已经就位。适用于任何 Webhook 或事件系统。
API 密钥安全与生命周期管理密钥为工作区级别，在存储时进行单向哈希处理，仅在创建时显示一次。可配置 TTL（默认 90 天，可设置更短时间）、可选的 IP 白名单（CIDR 范围），并可从开发者标签页立即吊销任何密钥。每次调用均记录审计日志，包含密钥前缀、IP 和用户代理。
权限范围模型workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write。相同的权限范围适用于 API、MCP 服务器和 Make.com 集成。请选择您的集成所需的最小权限--最小权限原则可在密钥泄露时降低影响范围。
Make.com 集成（低代码）不想编写代码？Make.com 集成使用相同的权限范围模型。它的动作包括更新标签、更新联系人信息和把会话标记为已读，你可以用可视化场景把这些动作接到数百个应用上，例如 Stripe 支付 → CRM 标签更新，或表单提交 → 联系人信息更新。
配套产品：Telegram MCP 服务器如果您希望 AI 智能体（Claude、ChatGPT、Cursor）与您的 Telegram 工作区交互，请查看 Telegram MCP 服务器--它通过 Model Context Protocol 暴露相同的 API 接口，让 AI 智能体无需您编写任何 API 客户端代码即可自动发现并调用工具。

功能	详情
套餐要求	专业版（及专业版工作区席位）
协议	REST（JSON over HTTPS）
端点	chats · messages · contacts · custom_fields · tickets · broadcasts · workspace · members · accounts
身份验证	工作区级别 API 密钥（Bearer 令牌）
默认密钥 TTL	90 天（可配置更短）
IP 白名单	可选 CIDR 范围
吊销	立即生效
审计	每次调用记录密钥前缀、IP、用户代理
速率限制	按密钥、按端点--返回 429 并附带 Retry-After 响应头

常见问题

使用 Telegram CRM API 可以做什么？

列出并搜索 Telegram 聊天、读取消息记录、管理联系人和自定义字段、创建和更新带优先级和负责人的工单、向标签细分用户触发广播、添加和删除标签，以及更新自定义字段值。每个端点均为工作区级别且可审计记录。

有哪些可用的权限范围？

workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write。请选择您的集成所需的最小权限--最小权限原则可在密钥泄露时降低影响范围。相同的权限范围适用于 API、MCP 服务器和 Make.com 集成。

具体案例--真实团队构建了什么？

一支交易团队每小时将所有 Telegram 聊天同步到 BigQuery，供分析师与链上数据进行关联分析。一支 SaaS 支持团队使用定时任务拉取前一天未解决的工单，并推送到 Slack 摘要中。一支增长团队在每次 Stripe 升级事件发生时，通过 Webhook 触发 Telegram 广播。一支运营团队使用 Entergram API 构建了 Retool 仪表板，显示每位代表的响应时间、工单吞吐量和管道阶段分布。

如何创建和管理 API 密钥？

前往 Entergram 工作区的开发者标签页。点击「创建密钥」，选择所需权限范围，可选择性设置更短的 TTL 和 IP 白名单，然后复制密钥。原始密钥仅显示一次--请妥善保存。密钥在存储时进行单向哈希处理。可从同一标签页立即吊销任何密钥。

如何轮换泄露的密钥？

开发者标签页 → 通过前缀找到该密钥 → 吊销（立即生效）。然后使用相同的权限范围和 IP 白名单创建新密钥，将其部署到您的集成中，并检查旧密钥的最后使用信息以确认不再有流量。

API 能否访问其他工作区的数据？

不能。每次 API 调用的范围仅限于签发该密钥的工作区。工作区 A 的密钥根本无法读取工作区 B 的数据--权限范围在每次查询时于服务端强制执行。

可能遇到哪些 HTTP 错误？

401 = 密钥已过期、已吊销，或与工作区不匹配。403 = 密钥缺少所需权限范围，或请求来自 IP 白名单之外的地址。429 = 已达到速率限制；请等待并按照 Retry-After 响应头的指示重试。

API 与 MCP 服务器有何区别？

两者以相同的权限范围访问相同的工作区数据。API 面向您的代码--定时任务、Webhook、内部工具、数据同步管道。MCP 服务器面向 AI 智能体--Claude、ChatGPT、Cursor--它们通过 Model Context Protocol 自动发现并调用工具。当代码是消费者时使用 API；当 AI 是消费者时使用 MCP 服务器。