# Criar o app do Entra

A documentação abaixo explica como criar um app com EntraID para fazer o login via SAML com o Portal Voice da Convert.

# Criar App no Painel do Entra

Acesse o painel do entra:

<https://entra.microsoft.com/>

Clique em “App Registrations” e após “New registration”:

 ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/7afba0e4-20f3-42be-87cd-11b427ca64bd/3ee94ac2-c137-4d5d-83c5-bceb1841ea19/attachments.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=39ef91045dc948e22a050c0d6f21f181ea7dc060f2f9ccf86149be64d4cdb6d0&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =1180x418")

Preencha as seguintes informações:

* Name: Nome da aplicação
* Supported account types: Apenas login da organização
* Redirect URI
  * Selecione Web e coloque o endereço do Convert /porta/oauth, como exemplo abaixo:
  * <https://v3template.convert.app.br/portal/oauth/>

Clique em Register

# Armazenar Informações de Client e Tenant

Você será direcionado para uma página como abaixo: ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/7afba0e4-20f3-42be-87cd-11b427ca64bd/721983cd-e95d-4a9f-9156-8f1e5c3aa275/attachments.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=a41abc5cf1af772edcc5ebf281f7e88b81f4649556f86d6cd1c95388efa9bcf9&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =979x776")


Armazene as seguintes informações que serão necessárias no Portal do Voice:

* **__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")

  

# Gerar e Armazenar Secret

O secret da aplicação deve ser gerado a partir de “Certificates & secrets” > “New client secret”:

 ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/7afba0e4-20f3-42be-87cd-11b427ca64bd/98a4db06-162a-499f-9e86-e40826202abe/attachments.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=bbd446290588a72edbd6370d9ab8e649f6c1ccec8e27df685a0f45965847a2f1&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =1336x539")

Armazene o **__Value__**.


:::warning
**Atenção:** este valor só irá aparecer durante a criação e não pode ser acessado depois.

:::

# Checklist

Para terminar, junte toda a informação coletada e passe para a Convert Company e verifique se a callback está configurada:

- [ ] Estou com valor do **__“Id do Cliente”__**
- [ ] Estou com valor do **__“Id do Tenant”__**
- [ ] Estou com valor do **__“Secret”__**
- [ ] A URL de callback está direcionando para **__“https://MEU_CONVERT/portal/oauth/”__**

Munidos dessas informações, passe para a Convert a informação para configuração.

# PS: Telefone

Caso você queira que o ramal venha do Entra, a configuração deve ser executada no campo business phone de cada usuário:

 ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/7afba0e4-20f3-42be-87cd-11b427ca64bd/477912cf-21e8-4116-97f5-dd3723adc437/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=0cd444bd9086946272a6a495ba4e79e51f31d027a5fc1b43e9b1767e8daa0ca8&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =599x440")

---

**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)