v1.0.0 · OpenAPI 3.0.3 · especificação fornecida pela Telenova

Telenova Webphone API

Configure vínculos de usuários a ramais, ative o Webphone e incorpore-o à sua aplicação por script ou iframe. Esta API é independente da API de Extrato de Ligações e usa outra autenticação e outros servidores.

Aviso de segurança. Rotas de configuração, administração e bootstrap retornam ou usam segredos (API key do tenant, JWT, senha SIP) e devem ser chamadas apenas por um backend confiável. O iframe /embed hoje aceita qualquer origem e não valida o remetente de postMessage. Leia antes de implantar.

Servidores

Configuração, administração e bootstrap

https://{cliente}.telenova.com.br/fusionapi

Exemplo nesta documentação: https://clientex.telenova.com.br/fusionapi

Runtime

https://webphone.telenova.com.br

Somente /api/webphone e /embed.

Categorias

Bootstrap

Dados para iniciar o Webphone do usuário (inclui senha SIP).

GET/webphone/user-info

Configuração

Vínculos usuário ↔ ramal do tenant. Somente backend confiável.

Administração

Ativação e chave de integração, com JWT do painel.

Runtime

Script JavaScript e página para iframe, servidor próprio.

Quickstart

01 Obtenha a API key do tenant com um administrador (POST /webphone/integration-key, com JWT do painel) e guarde-a no servidor.

02 Vincule o usuário a um ramal a partir do seu backend.

cURL · servidor · valores fictícios

# 1) No seu BACKEND (nunca no navegador): crie ou substitua o vínculo
curl -X PUT "https://clientex.telenova.com.br/fusionapi/webphone/configs/usuario-123" \
  -H "Authorization: Bearer SUA_TENANT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"extension": "1001", "active": true, "uiConfig": {"showDialpad": true}}'

03 Carregue o Webphone na página do usuário. O registro SIP acontece após o carregamento.

HTML · trecho fictício (não executado neste portal)

<!-- 2) Na sua página: carregue o script Runtime (trecho FICTÍCIO).
     No modelo atual a autenticação é a API key do tenant, via Bearer
     ou ?token= na URL. Avalie os riscos em "Segurança e implantação". -->
<script src="https://webphone.telenova.com.br/api/webphone?userID=usuario-123&startAsButton=true&token=SUA_TENANT_API_KEY"></script>

Ver referência completa