Configurar Entra

Primeiramente, crie o app no EntraID antes de realizar a configuração no Portal do Voice IP.

Você deve estar munido das seguintes informações:

  • Id do Cliente

  • Id do Tenant

  • Secret

  • A URL de callback deve estar configurada

IMPORTANTE: Caso o cliente tenha um instalação ativa, realizando login via AD ou até mesmo local, para manter os mesmos usuários é necessário atualizar os seus logins, deixando os login iguais ao e-mail, pois no entra é assim que funciona.

Configuração do Ambiente Convert

O ambiente do cliente vai vir por padrão sem a configuração do EntraID. É necessário acessar o módulo de configuração e preencher os campos de acordo.

Importante: Antes de mais nada, deve-se mudar a autenticação para AD

Abaixo estão os campos disponíveis:


Explicação de cada campo:

  • Id do Cliente

    • Id do cliente criado na aplicação da Microsoft, pode ser encontrado abaixo (os dados foram omitidos por questão de sec)


  • Id do Tenant

    • Id do tenant (dono da aplicação) (os dados foram omitidos por questão de sec)


  • Segredo da Aplicação

    • Deve ser gerado a partir de “Clients and Secrets”


  • E-mail para erros

    • E-mail para erros caso algo aconteça no login. Melhor não mexer.

  • State Padrão

    • Configuração do state padrão se não informado. Melhor não mexer.

  • Tempo para expiração (seg.)

    • Configuração de tempo de expiração do token do Assist para integração de touch, extensão e info. Por padrão 86400s (1 dia), podendo ser de até 604800 (1 semana).

  • Criar usuário Portal

    • Configuração que define em caso de um login bem sucedido, se o usuário não existir no Convert Portal, se ele deve ser criado ou não.

  • Criar usuário Assist

    • Configuração que define em caso de um login bem sucedido, se o usuário não existir no Convert Assist, se ele deve ser criado ou não.

  • Custom Hostname (opção secreta, só incluída via banco: OAUTH-custom_hostname)

    • Caso o cliente tenha um nome customizado diferente do nome real do servidor, ex: empresaA.convert.app.br é o nome do servidor e cliente usa telefonia.empresaA.com.br. Neste caso deve-se criar direto no banco o campo custom_hostname do grupo OAUTH com o valor para sobrescrever o nome padrão do servidor.