# Guia de campo de integração do Zoom com o sistema telefônico Mitel
### Visão geral
Zoom e Mitel estão se unindo para melhorar o seu sistema VoIP. Com esta integração do sistema telefónico — ou PSI — você pode ter o melhor dos dois mundos: o poder de colaboração do Zoom Workplace e as capacidades de chamadas do seu sistema Mitel existente, tudo a partir das apps Zoom Workplace para computador e para dispositivo móvel.
Se você já usa o Zoom Workplace, está a pensar em começar a usar o Zoom Workplace, ou quer adicionar mais recursos do Zoom Workplace e tem uma configuração Mitel compatível, esta integração é uma excelente opção.
A ideia é a seguinte: o seu separador Zoom Phone torna-se um softphone SIP (session initiation protocol) que se liga diretamente à plataforma de chamadas da Mitel. Se estiver a ligar-se através da internet, ele usa o OpenScape Session Border Controller, ou SBC, da Mitel. Também usará o Mitel CloudLink para facilitar os inícios de sessão e gerir os utilizadores de forma mais fluida entre o Zoom e a Mitel.
Só para avisar, será necessário ter todos os componentes corretos do Zoom e da Mitel em funcionamento para que esta integração funcione corretamente.
#### Funcionalidades PSI do Zoom e da Mitel
Esta integração traz uma ampla gama de funcionalidades para a sua implementação Mitel atual. Eis apenas algumas das que pode aproveitar:
* Efetuar e receber chamadas
* Gerir várias chamadas ao mesmo tempo
* Colocar chamadas em espera ou iniciar uma conferência
* Transferir chamadas (fria ou assistida)
* Aceder ao correio de voz
* Ver o histórico e os registos de chamadas
* Configurar o reencaminhamento de chamadas
* Usar o modo Não incomodar
* Sincronizar contactos corporativos
* Transformar uma chamada telefónica numa reunião Zoom
* Ver o estado de presença entre as apps Zoom (limitado com telefones Mitel)
* Passar do Chat para uma chamada PSI
#### Requisitos de alto nível
As secções seguintes descrevem os requisitos de alto nível para esta integração.
**Especificidades do Zoom**
Para colocar tudo a funcionar no lado do Zoom, vai precisar de:
* Um proprietário da conta ou uma função de administrador para gerir utilizadores, a PSI e o Zoom Phone
* Uma licença suportada por utilizador, como por exemplo:
* Zoom Workplace Business/Business+
* Zoom Workplace Essentials/Enterprise/Enterprise+/Enterprise Premier
* Licenças Legacy Meeting (ENH/EAH)
* Qualquer plano com Zoom Phone Pro
* Zoom Phone configurado e ativo para a sua organização
* [**Atribuição Automática de Telefone**](#disable-the-automatic-phone-license-assignment-for-zoom-workplace) desativada para as licenças do Zoom Workplace
* Versão 6.3.6 ou superior da app Zoom Workplace
**Especificidades da Mitel**
No lado da Mitel, eis o que vai precisar:
**Compatibilidade de hardware PBX:**
* OpenScape Voice (OSV)
* OpenScape 4k (OS4k)
* Mitel CloudLink
* MiVoice Business (MiVB)
**Apps e plataformas suportadas:**
* App de administração da Mitel
* Plataforma OpenScape 4000 (para OS4k)
* Plataforma OpenScape Common Management (para OSV)
* Portal de gestão OpenScape SBC (para OSV e OS4k)
* OpenScape SBC (para registo externo com OSV/OS4k)
**Licenças:**
* Mitel ZoomPSI ou Hybrid
* Licença Teleworker
Há alguns aspetos importantes a saber antes de começar o processo de integração:
* A app Zoom Workplace usa as [portas e intervalos de IP padrão da firewall](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060548).
* Os IPs e portas de sinalização/mídia do telefone são determinados pela configuração da Mitel e podem diferir dos padrões. Contacte a Mitel ou o seu parceiro Mitel se precisar de informações adicionais.
* Tem de ter uma licença Teleworker tanto para as apps Zoom Workplace para computador como para dispositivo móvel — duas licenças por utilizador. Estas são essenciais para ligar de volta ao PBX da Mitel.
### Arquitetura
#### Arquitetura de integração padrão
Ligações principais:
* **Zoom Cloud para Mitel CloudLink**: API REST sobre TLS
* **Ligação do Zoom Workplace**: TLS para os centros de dados do Zoom
* **Dispositivo do utilizador para a Mitel**: sinalização/mídia telefónica via TLS
* **Mitel CloudLink para PBX**: protocolos proprietários
#### Configuração híbrida
As organizações executam simultaneamente o Zoom Phone e a integração Mitel. Os utilizadores com licenças Zoom Phone ligam-se ao SBC do Zoom Phone, enquanto os utilizadores com a integração Mitel se ligam ao SBC da Mitel. Com um trunk BYOP a ligá-los, os utilizadores podem marcar extensões entre diferentes sistemas.
#### Visão geral da arquitetura técnica
**Ligação ao Mitel CloudLink**
O CloudLink é uma plataforma baseada na cloud que faz a ponte entre o seu PBX local e as soluções cloud. O Zoom tira partido do CloudLink para acesso à API da cloud aos componentes do PBX da Mitel, criando uma interface única em vez de precisar de "falar" a linguagem exclusiva de cada PBX.
{% hint style="success" %}
**Exemplo**
Ao ativar o Não incomodar, o Zoom envia um comando de API para o CloudLink, que o interpreta para o PBX Mitel específico (OS4K vs. MiVoice Business tratam isto de forma diferente).
{% endhint %}
**Sincronização entre o Zoom Cloud e o CloudLink**
Você estabelece comunicação segura através de **Apps Zoom** a partir de ambos **Zoom** e **CloudLink**. Ao instalar estas apps, um administrador tem de iniciar sessão em ambos os sistemas para criar uma ligação OAuth segura.
Depois de ligado, o Zoom obtém os detalhes de início de sessão telefónico do utilizador através de TLS:
* "Nome de utilizador" SIP (normalmente o número de telefone)
* Credenciais SIP (apenas hash seguro)
* Endereços IP de registo (SBC e SBC de reserva, ou PBX interno)
**Processo de registo da app**
1. A cloud do Zoom envia as credenciais de início de sessão para a app Zoom Workplace do utilizador através de TLS
2. O Zoom Workplace ativa o separador Telefone
3. A app Zoom Workplace liga-se diretamente ao SBC ou PBX da Mitel via TLS (não é encaminhada pela cloud do Zoom)
**Fluxos** **adicionais**
* Funcionalidades: a app Zoom Workplace comunica diretamente com o Mitel CloudLink através da API REST sobre TLS para registos de chamadas, correios de voz e estado do Não incomodar
* Push móvel: o SBC da Mitel envia notificações push para a cloud do Zoom, que as encaminha para dispositivos móveis
* Adaptação à rede: os utilizadores remotos ligam-se através do CloudLink e do SBC da Mitel. Os computadores no local ligam-se diretamente ao PBX da Mitel. Os dispositivos móveis usam o caminho externo seguro.
### Configurar a integração
A integração entre o Zoom e a Mitel é simples, com o trabalho no lado do Zoom a demorar em média cerca de 45 minutos, sendo a maior parte do trabalho no lado da Mitel. Contacte a Mitel ou o seu parceiro Mitel para questões adicionais ou informações sobre o prazo.
Qualquer administrador que execute estes passos precisará da **Integração do sistema telefónico** permissão para concluir todos os passos.
#### Concluir a configuração inicial do Zoom Phone
Se for um novo cliente e ainda não tiver configurado o Zoom Phone, siga o nosso documento de suporte sobre [Como começar com o Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060257#h_5ae26a3a-290c-4a8d-b3b0-6384ed267b13). Caso contrário, avance para o passo seguinte.
#### Desativar a atribuição automática de licença telefónica para o Zoom Workplace
Para desativar a atribuição automática de licenças do Zoom Phone para todos os utilizadores da conta:
1. Inicie sessão no [portal web do Zoom](https://zoom.us/profile) como administrador.
2. No menu de navegação à esquerda, clique em **Gerenciamento da conta**e depois em **Configurações da conta**.
3. Clique na aba **Zoom Phone** .
4. Sob **Geral**, clique no **Ativar automaticamente os utilizadores do Zoom Phone** alternar para o desativar.
5. Se for apresentado um diálogo de verificação, clique em **Desativar** para verificar a alteração.
#### Adicionar utilizadores ao Zoom
Pode adicionar utilizadores individualmente, com um ficheiro CSV ou usando SSO (single sign-on), seguindo os passos do nosso documento de suporte sobre [Gerir utilizadores](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061789#h_8b193526-997c-4385-955b-ffddda0b0404). Se convidar um utilizador existente para aderir à sua conta Zoom, saiba mais sobre o processo de [adicionar utilizadores existentes a uma conta paga](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063202), como tratar de quaisquer saldos remanescentes e dados que serão transferidos para a sua conta.
#### Atribuir licenças aos utilizadores
Pode atribuir licenças de produtos Zoom individualmente ou em massa. Há mais informações sobre como [Atribuir licenças Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911) no artigo ligado.
#### Instalar a app da Mitel a partir do Zoom App Marketplace
Para ligar o Zoom ao Mitel CloudLink, siga os passos abaixo:
1. Inicie sessão no [portal web do Zoom](https://zoom.us/profile) como administrador.
2. No menu de navegação à esquerda, em **Avançado** clique em **App Marketplace**.
3. Use a caixa de pesquisa para encontrar a **App Mitel PSI** e selecione-a. Clique em **Adicionar**.
4. Clique em **Criar conector**.
5. Clique em **Conectar** para confirmar que pretende ligar o conector Mitel de terceiros à sua conta Zoom. Será aberta uma janela do navegador, redirecionando-o para o Mitel CloudLink.
6. Inicie sessão no Mitel CloudLink. A comunicação entre o Zoom e o CloudLink da Mitel está agora concluída.
{% hint style="info" %}
**Observação**
A Mitel também tem uma App Store para o CloudLink onde o Zoom pode ser adicionado para ser redirecionado para o Zoom para conclusão.
{% endhint %}
#### Configurar definições de integração telefónica
Para permitir que os utilizadores da app móvel Zoom Workplace efetuem chamadas através de um sistema local Mitel, siga os passos abaixo:
1. Inicie sessão no [portal web do Zoom](https://zoom.us/profile) como administrador.
2. No menu de navegação à esquerda, clique em **Gerenciamento da conta**e depois em **Integração do sistema telefónico**.
3. Clique na aba **Configurações** .
4. Para integrar as chamadas na app móvel Zoom Workplace, selecione a **Permitir usar o sistema telefónico integrado para fazer chamadas no cliente móvel do Zoom** .
5. Se aparecer um diálogo de verificação, clique em **Habilitar** ou **Desativar** para verificar a alteração.
{% hint style="info" %}
**Notas**
* Certifique-se de que esta definição está sempre ativada.
* Se esta opção estiver ativada e os utilizadores estiverem na lista da Integração do Sistema Telefónico, estes utilizadores podem usar um sistema local Mitel para efetuar uma chamada através da app móvel Zoom Workplace.
{% endhint %}
#### Adicionar utilizadores Zoom à PSI da Mitel
Pode optar por adicionar utilizadores manualmente ou em massa via CSV. Consulte os passos para [adicionar utilizadores Zoom à integração Mitel](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurdfim2r8) no nosso artigo de suporte ligado.
#### Verificar a integração Zoom-Mitel na app Zoom Workplace
Para verificar se a integração está configurada corretamente, inicie sessão na app Zoom Workplace (para computador ou móvel) e clique no separador **Telefone** . Certifique-se de que consegue ver a ID do chamador (extensão da Mitel) e de que não há mensagens de erro. Se houver erros, a Coluna de Estado fornece informações relevantes:
| Estado | Descrição |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Credenciais SIP pendentes** | A aguardar autorização do utilizador pelo CloudLink. |
| **Inativo** | A credencial SIP já foi sincronizada com o Zoom, mas o utilizador ainda não se registou na app Zoom Workplace. |
| **Registado** | A app Zoom Workplace registou-se com êxito no servidor SIP. |
| **Códigos de erro SIP (vários)** | Isto fornecerá códigos de erro SIP comuns e uma descrição geral para ajudar a resolver o problema de registo. |
#### Configurar a gestão de utilizadores da Mitel
Use as referências no nosso [Guia de configuração PSI Zoom-Mitel](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurmd8a34k) para obter alguma informação que o ajude a começar. Contacte a Mitel ou o seu parceiro Mitel para questões ou informações adicionais.
#### Considerações de segurança
O nosso [Guia de configuração PSI Zoom-Mitel](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurmd8a34k) guia tem algumas considerações de segurança para a sua organização. Contacte a Mitel ou o seu parceiro Mitel para questões ou informações adicionais.
#### Gerir contactos externos (contactos não Zoom)
Os proprietários da conta e os administradores podem criar um diretório partilhado de contactos externos. Há mais informações no nosso[ Guia de configuração PSI Zoom-Mitel](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0079172#mcetoc_1iiurmd8a34k) guia. Contacte a Mitel ou o seu parceiro Mitel para questões ou informações adicionais.
#### Traga o seu próprio PBX (BYOP)
O BYOP permite criar um trunk SIP entre o Zoom Phone e a Mitel para marcação baseada em extensões. Misture e combine — alguns escritórios usam o Zoom Phone enquanto outros usam a integração Mitel. Com um trunk BYOP, os utilizadores marcam extensões entre sistemas.
Esta configuração requer regras adicionais de firewall e usa Mutual TLS. Consulte o nosso Site de Suporte para conhecer os requisitos. Coescrevemos documentos de suporte com a Mitel para o OpenScape SBC e o MiVoice Border Gateway, disponíveis na nossa Página de hardware suportado do Zoom Phone.
#### Suporte para telefones de secretária Mitel no Zoom Phone
Os utilizadores do Zoom Phone podem usar telefones de secretária Mitel que se registam diretamente no Zoom Phone. Para uma lista de modelos suportados, consulte a [lista de hardware certificado](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060242).
### Perguntas frequentes
#### Podem ser necessárias atualizações de licença ou software, dependendo da configuração do seu sistema Mitel
Cada configuração Mitel é diferente, por isso o que precisa depende da sua configuração específica. O seu parceiro Mitel pode avaliar rapidamente o seu sistema e dizer-lhe se precisa de atualizações de licença (como licenças Teleworker) ou atualizações de software para tornar tudo compatível. Vale a pena uma verificação rápida, uma vez que os requisitos variam bastante entre implementações.
#### O Mitel CloudLink é necessário para que esta integração funcione
Sim, o CloudLink é fundamental. Ajuda a manter tudo sincronizado entre o Zoom e o seu sistema Mitel, como as informações do utilizador e as credenciais de início de sessão. Também simplifica a gestão dos utilizadores.
#### Sim, esta integração funciona em paralelo com implementações do Zoom Phone
Pode misturar e combinar — alguns escritórios podem usar o Zoom Phone sem integração, enquanto outros usam a integração Mitel. Com um trunk BYOC/BYOP a ligá-los, os utilizadores podem até marcar extensões entre sistemas diferentes. Use o que funciona melhor para cada localização.
#### Pode usar tanto um telefone de secretária Mitel como a app Zoom Workplace
A app Zoom Workplace funciona em conjunto com o seu telefone de secretária existente, e não em vez dele. Ambos podem tocar quando alguém liga para a sua extensão, para que possa atender o que for mais conveniente. O seu sistema Mitel trata o Zoom Phone como mais um telefone na sua secretária.
#### O Zoom liga-se à Mitel através do CloudLink
O CloudLink é a ponte que faz o Zoom e a Mitel comunicarem entre si. Lida com três coisas principais: verificar se os utilizadores são quem dizem ser, manter as informações dos utilizadores sincronizadas entre ambos os sistemas e transmitir de forma segura as credenciais de início de sessão de que o Zoom precisa para se ligar ao seu sistema Mitel. Sem o CloudLink a atuar como tradutor, estes dois sistemas não conseguiriam funcionar em conjunto — é isso que torna a integração possível.
#### Não pode enviar mensagens SMS através desta integração
O SMS não é suportado neste momento porque a app Zoom Workplace está essencialmente a funcionar como um softphone que se liga ao seu sistema Mitel apenas para chamadas de voz. O SMS usa uma tecnologia completamente diferente que o seu sistema Mitel trata separadamente. Pense assim: o Zoom está a utilizar as funcionalidades de chamadas do seu sistema Mitel, mas o SMS está noutra parte desse sistema que não é acessível através desta integração. Por agora, terá de continuar a usar as suas ferramentas atuais de SMS da Mitel, embora isso possa mudar em futuras atualizações.
#### A Ferramenta de Conectividade de Rede não funcionará com telefones Mitel
A Ferramenta de Conectividade de Rede do Zoom não consegue testar as ligações dos seus telefones Mitel porque foi concebida para verificar os próprios servidores do Zoom, e não o seu sistema Mitel. Quando utiliza esta integração, as suas chamadas passam pela rede da Mitel (seja diretamente para o seu PBX ou através dos servidores da Mitel), pelo que a ferramenta de teste do Zoom simplesmente não consegue ver ou testar esses caminhos. É como tentar usar a ferramenta de diagnóstico de um carro numa marca diferente — falam simplesmente línguas diferentes. A ferramenta continuará a funcionar bem para testar as suas ligações regulares de reuniões Zoom, no entanto.
#### Os utilizadores do Zoom não podem ver a presença de utilizadores que têm apenas telefones de secretária Mitel
Os seus telefones de secretária Mitel tradicionais não indicam ao Zoom se alguém está disponível ou numa chamada. A integração funciona muito bem para mostrar a presença entre utilizadores da app Zoom Workplace, mas esses telefones de secretária mais antigos funcionam no seu próprio universo e não conseguem partilhar o seu estado com o sistema do Zoom. Está no plano de desenvolvimento melhorar isto, mas, por enquanto, só verá a presença de pessoas que estejam realmente a usar a app Zoom Workplace.
#### Atualmente, não há funcionalidades de IA disponíveis com a integração Mitel PSI
As suas chamadas passam pelo sistema da Mitel, e não pela cloud do Zoom, onde reside a IA, por isso o Zoom AI Companion não consegue aceder às suas conversas. Isso significa que não haverá transcrição automática do correio de voz, resumos de chamadas ou outras funcionalidades de IA que teria com o Zoom Phone sem integração. As chamadas ignoram completamente o processamento de IA do Zoom. Futuras atualizações poderão mudar isto, mas, por agora, terá de usar quaisquer ferramentas de IA que o seu sistema Mitel oferecer.
#### Se algo não estiver a funcionar após a configuração, verifique as definições de integração telefónica no Zoom
Quando as chamadas não estiverem a funcionar, verifique o estado da sincronização no separador Utilizadores integrados nas definições de Integração do Sistema Telefónico no Portal de Administração. As falhas de sincronização geralmente significam que o CloudLink não está a transmitir as credenciais corretamente — é aí que vai querer verificar os registos do CloudLink para ver o que se passa.
#### Você é responsável pelos certificados do seu dispositivo
Como está a ligar-se ao seu próprio sistema Mitel (e não aos servidores do Zoom), precisa de instalar os certificados de segurança da sua empresa em todos os dispositivos que vão usar esta integração. Pense nos certificados como chaves digitais — o Zoom gere as suas próprias chaves para um Zoom Phone sem integração, mas, com esta integração, está a usar as suas próprias "chaves" para se ligar ao seu próprio sistema. A sua equipa de TI precisa de garantir que cada portátil, telemóvel e tablet tem os certificados corretos instalados; caso contrário, não será possível estabelecer ligações seguras ao seu sistema Mitel.
#### Ligar é fácil, seja no local ou na rede corporativa
O sistema adapta a forma como se liga dependendo de onde está. Se estiver a trabalhar a partir de casa ou de uma cafetaria, as suas apps móveis e para computador ligar-se-ão através do CloudLink e do Session Border Controller da Mitel para garantir a segurança. Mas se estiver no escritório, na rede da sua empresa, o seu computador pode ligar-se diretamente ao PBX da Mitel para chamadas mais rápidas e eficientes. Os dispositivos móveis usam sempre o caminho externo seguro para consistência e segurança, independentemente da localização.
#### Apenas os Proprietários da Conta ou Administradores podem adicionar a App Mitel PSI ao Zoom
Embora a app Mitel PSI não use privilégios de Proprietário ou Administrador após a instalação, requer esses privilégios para a configuração inicial. **Note que:** se o Proprietário ou Administrador que adicionou originalmente a app sair da conta, a integração deixará de funcionar. Para restaurar a funcionalidade, outro Administrador ou o novo Proprietário terá de reautorizar a app.
