API e integrações

A sua telefonia ligada às suas ferramentas comerciais

Um PBX moderno não deve permanecer isolado. MaxiPBX expõe APIs documentadas já disponíveis para os tenants e para a administração master, conecta os CRMs, integra-se ao Microsoft Teams e abre os usos CTI avançados graças a um gateway ARI seguro e isolado por tenant.

01

API PBX documentada e explorável

Os integradores dispõem de uma documentação OpenAPI / Swagger clara, com autenticação padrão e separação rigorosa dos perímetros.

  • Documentação OpenAPI / Swagger disponível para compreender rapidamente as rotas
  • Autenticação padrão Authorization: Bearer para integrações modernas
  • API tenant disponível para gerir o seu próprio perímetro, sem acesso aos outros clientes
  • API master disponível para administração global e integrações com perímetro completo
  • Rotas públicas, rotas protegidas e acesso hotelaria/PMS devidamente separados
02

CRM, ficha de cliente e click-to-call

MaxiPBX aproxima a chamada telefónica do contexto do cliente: identificação do chamador, abertura da ficha CRM e registo automático.

  • Conexões HubSpot, Salesforce, Zoho, Odoo, ConnectWise, Vtiger e Jetpack CRM
  • Pesquisa do contacto em chamada recebida: nome, empresa e botão «Abrir no CRM»
  • Registo de chamadas recebidas, realizadas e perdidas no CRM do tenant
  • Extensão do navegador click-to-call para Chrome, Edge e Firefox
03

Microsoft Teams, SSO e identidade

Os ambientes Microsoft 365 e Google Workspace são suportados sem impor um modelo de autenticação proprietário.

  • Sincronização de presença do Teams para o telefone
  • Softphone MaxiPBX integrável no Microsoft Teams
  • SSO SAML com Microsoft Entra ID, Google Workspace, Okta ou IdP genérico
  • Configuração por tenant, com consentimento de administrador quando necessário
04

ARI seguro e projetos CTI avançados

Para integrações telefónicas de baixo nível, MaxiPBX pode expor o Asterisk REST Interface através de um gateway controlado.

  • Acesso ARI global ou por tenant consoante a necessidade de integração
  • Identificadores dedicados, palavras-passe encriptadas e lista branca de IP obrigatória
  • Exposição HTTPS na porta 443, REST e WebSocket de eventos
  • Um acesso tenant vê apenas as chamadas do seu tenant
05

Webhooks e integrações hotelaria / PMS

O módulo Quartos foi concebido para dialogar com as ferramentas comerciais: check-in, check-out, despertares, estados, tributação e eventos.

  • API REST para check-in/out, hóspede, idioma, perfil telefónico e despertares
  • Webhooks para reportar estados, DND, chamadas, tributação e emergências
  • Arquitetura preparada para OPERA / FIAS e conectores de PMS
  • Chaves e segredos protegidos, nunca redispostos após registo

Perguntas frequentes

A API é utilizável por um cliente no seu próprio tenant?

Sim. O modelo de acesso distingue claramente os direitos tenant e master: um administrador de tenant pode automatizar o seu perímetro, sem ver os outros clientes. Os acessos globais permanecem reservados aos administradores gerais.

É possível conectar MaxiPBX a um CRM auto-hospedado?

Sim. Os conectores padrão cobrem vários CRMs conhecidos, e o motor aceita também modelos de URL, chaves de API e integrações mais específicas conforme o projeto.

O acesso ARI é perigoso?

Está desativado enquanto nenhuma configuração for criada. Quando é utilizado, o acesso passa por HTTPS, com identificadores dedicados, restrição de IP obrigatória e isolamento por tenant quando o acesso não é global.

Tem um CRM, um PMS ou uma integração CTI para conectar?

Analisamos o seu caso, os direitos necessários e o nível de abertura apropriado antes de expor qualquer API.