# Configurar Entra

Primeiramente, [crie o app no EntraID](/doc/criar-app-entraid-YOCfYYmLkN) 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


:::warning
**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.


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

:::

Abaixo estão os campos disponíveis:

 ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/7afba0e4-20f3-42be-87cd-11b427ca64bd/575faff6-a6ac-48b2-9763-48da4d8778a8/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=cecc978ac51bc738c9f379a5310115d55030a68fdad533105dbaa3c58136cf44&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

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)
  * ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/7afba0e4-20f3-42be-87cd-11b427ca64bd/d1d622be-ef66-462e-9aca-b83ce8fba90a/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=236235bc897d165827594da4c72e2dbcfc61dea9e26437ab21e602add68115ed&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)
* Id do Tenant
  * Id do tenant (dono da aplicação) (os dados foram omitidos por questão de sec)
  * ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/7afba0e4-20f3-42be-87cd-11b427ca64bd/f392c762-98f8-4762-a5f5-7021ba001360/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=f49298508f8e61f9faaba70c631cb493fe3e354c8c7b40eed978a733719755fb&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =556x331")
* Segredo da Aplicação
  * Deve ser gerado a partir de “Clients and Secrets”
  * ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/7afba0e4-20f3-42be-87cd-11b427ca64bd/ff19136a-c64c-4543-978b-1c1fd6e313cc/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=b4ad17d2245470fe54e39ff0307b3934e440fcc9adc319288348f42eaf67aed6&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =770x311")
* 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.

---

**Documents**

- [Manuais de produtos](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/manuais-de-produtos-9Zwzl1ufq8)
- [Treinamentos em vídeo](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/treinamentos-em-video-RtQVBvFmgW)
- [Versões de produtos](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/versoes-de-produtos-TH4Y8GFXxO)