API 和集成

将您的电话系统与业务工具连接起来

现代 PBX 不应该孤立运行。MaxiPBX 公开了已为租户和主管理员提供的完整 API,连接 CRM,与 Microsoft Teams 集成,并通过安全的、按租户隔离的 ARI 网关开启高级 CTI 使用方式。

01

文档完善且可使用的 PBX API

集成商获得清晰的 OpenAPI / Swagger 文档、标准身份验证和严格的范围分离。

  • 提供 OpenAPI / Swagger 文档,让您快速理解接口路由
  • 采用标准 Authorization: Bearer 身份验证方式以支持现代集成
  • 租户 API 可用于管理自有范围,无法访问其他客户
  • 主控 API 可用于全局管理和完整范围集成
  • 公开路由、受保护路由和酒店/PMS 访问得到妥善分离
02

CRM、客户档案和点击呼叫

MaxiPBX 将电话呼叫与客户背景信息关联:识别来电者、打开 CRM 档案和自动记录。

  • 支持 HubSpot、Salesforce、Zoho、Odoo、ConnectWise、Vtiger 和 Jetpack CRM 连接
  • 来电时搜索联系人:姓名、公司和«在 CRM 中打开»按钮
  • 在租户的 CRM 中自动记录来电、去电和未接来电
  • 支持 Chrome、Edge 和 Firefox 的点击呼叫浏览器扩展
03

Microsoft Teams、SSO 和身份验证

支持 Microsoft 365 和 Google Workspace 环境,无需强制使用专有身份验证模型。

  • 将 Teams 在线状态同步到桌面电话机
  • MaxiPBX 软电话可集成到 Microsoft Teams 中
  • 支持 Microsoft Entra ID、Google Workspace、Okta 或通用 IdP 的 SAML SSO
  • 按租户配置,必要时获得管理员同意
04

安全 ARI 和高级 CTI 项目

对于低层级电话集成,MaxiPBX 可以通过受控网关公开 Asterisk REST Interface。

  • 根据集成需求提供全局或按租户的 ARI 访问
  • 专用凭证、加密密码和强制性 IP 白名单
  • 在 443 端口通过 HTTPS 公开,支持 REST 和 WebSocket 事件
  • 租户访问仅可查看其租户的呼叫
05

Webhooks 和酒店/PMS 集成

客房模块专为与业务工具交互而设计:入住、退房、唤醒服务、状态、税费和事件。

  • 用于入住/退房、住客、语言、电话配置和唤醒服务的 REST API
  • 用于上报状态、勿扰、呼叫、税费和紧急情况的 Webhooks
  • 为 OPERA / FIAS 和 PMS 连接器预先设计的架构
  • 密钥和密码受到保护,记录后不会再次显示

常见问题

客户能否在自己的租户中使用 API?

可以。访问权限模型明确区分租户权限和主控权限:租户管理员可以自动化自己的范围,看不到其他客户。全局访问权限仅保留给总体管理员。

能否将 MaxiPBX 连接到自托管的 CRM?

可以。标准连接器涵盖多个已知 CRM,引擎也支持更多特定项目的 URL 模式、API 密钥和集成方式。

ARI 访问是否存在安全风险?

在未创建任何配置时,ARI 访问处于禁用状态。使用时,访问通过 HTTPS 进行,采用专用凭证、强制性 IP 限制和非全局访问时的租户隔离保护。

您有需要连接的 CRM、PMS 或 CTI 集成吗?

我们会分析您的情况、所需的权限和适当的开放级别,然后再公开任何 API。