Pular para o conteúdo principal

Minotaur × Zoom Phone — Guia de Integração

App: Integração Minotaur Zoom Phone
Publicado por: Minotaur Sales
Compatível com: app.minotaursales.io

Visão geral​

A integração do Minotaur com o Zoom Phone incorpora o Zoom Phone diretamente dentro do CRM do Minotaur, permitindo que as equipes de vendas:

  • Liguem com um clique para o número de telefone de qualquer contato sem sair do navegador.
  • Acessem o widget do Zoom Phone no app para fazer e receber ligações.
  • Visualizem o histórico de chamadas — tanto em toda a conta quanto por contato — obtido em tempo real do Zoom Phone.

Toda a comunicação ocorre através do widget de telefone incorporável seguro do Zoom. O Minotaur não grava nem armazena o áudio das chamadas; os registros de chamadas são obtidos em modo somente leitura da API do Zoom Phone.

Pré-requisitos​

RequisitoDetalhes
Licença do Zoom PhoneSua conta do Zoom deve ter um plano ativo de Zoom Phone. A integração não funciona com uma licença apenas para Zoom Meetings.
Configuração de administrador do ZoomUm administrador do Zoom deve habilitar o Zoom Phone e o Embeddable Phone no Portal de Administração do Zoom → Configurações da conta → Telefone.
Cliente desktop do ZoomO Zoom desktop app v5.9.0 ou superior deve estar instalado e em execução. O widget do navegador roteia o áudio pelo cliente desktop.
Conta do MinotaurVocê deve estar autenticado em app.minotaursales.io e ter acesso a Configurações.

Adicionar o app (Instalar e Conectar)​

  1. Abra o Zoom Marketplace e encontre o app Minotaur. Clique em Instalar. Um administrador do Zoom pode precisar aprovar a instalação para sua organização.
  2. Faça login em app.minotaursales.io.
  3. Navegue até Configurações → Conexões → Zoom.
  4. Clique em Conectar.
  5. Uma nova aba do navegador se abre com a página de autorização OAuth do Zoom. Faça login na sua conta do Zoom e revise as permissões solicitadas:
    • user:read — ler seu perfil de usuário do Zoom.
    • phone:read:list_users:admin — ler informações de usuários do Zoom Phone.
    • phone:read:list_call_logs — ler o histórico de chamadas do Zoom Phone.
  6. Clique em Permitir.
  7. A aba se fecha e você é redirecionado para o Minotaur. A página de conexão mostra Conectado com o nome e e-mail da sua conta do Zoom.

Usar o app​

Ligar com clique a partir de Contatos​

  1. Abra qualquer registro de contato ou a lista de Contatos.
  2. Localize um campo de número de telefone (ex.: Celular). Números com o Zoom conectado exibem um ícone de telefone e "Ligar" ao passar o mouse.
  3. Clique no número. O widget do Zoom Phone se abre no lado direito da tela e disca automaticamente o número.

Botão flutuante de telefone​

Um ícone de telefone na barra de navegação superior abre o widget do Zoom Phone a qualquer momento sem um número pré-preenchido.

O botão flutuante e a ação de ligar com clique ficam ocultos quando a integração do Zoom está desconectada ou o serviço está em pausa.

Histórico de chamadas — Toda a conta​

  1. Vá para Configurações → Registros de integração → Zoom.
  2. A tabela mostra todos os registros de chamadas do Zoom Phone da sua conta.
  3. Os registros são obtidos em tempo real do Zoom Phone; nenhum dado é armazenado no Minotaur.

Histórico de chamadas — Por contato​

  1. Abra um registro de contato.
  2. Clique na aba Chamadas.
  3. O Minotaur busca todas as chamadas do Zoom Phone que envolveram o número de celular do contato.

Pausar / Retomar o serviço​

  1. Vá para Configurações → Conexões → Zoom.
  2. Ative Pausar serviço. O widget e as ações de ligar com clique ficam ocultos durante a pausa.
  3. Ative novamente para Retomar.

Remover o app​

Remover do Minotaur​

  1. Vá para Configurações → Conexões → Zoom.
  2. Clique em Desconectar.
  3. O Minotaur revoga imediatamente os tokens OAuth armazenados e remove a integração.

Remover do Zoom Marketplace​

  1. Faça login no Zoom Marketplace → Gerenciar → Apps instalados.
  2. Encontre o Minotaur e clique em Remover.
  3. O Zoom envia um evento de desautorização ao Minotaur, que exclui todos os tokens OAuth armazenados. Nenhum outro dado pessoal é retido.

Solução de problemas / Perguntas frequentes​

O banner "Serviço em pausa" aparece​

A integração está conectada, mas em pausa. Vá para Configurações → Conexões → Zoom e ative Retomar serviço.

Me desconectei ou meu token foi revogado — como reconecto?​

Vá para Configurações → Conexões → Zoom e clique em Conectar novamente. Complete o fluxo OAuth do Zoom.

O histórico de chamadas não carrega​

  1. Confirme que sua conta do Zoom tem uma licença ativa do Zoom Phone.
  2. Confirme que as permissões necessárias foram aprovadas durante o fluxo OAuth.
  3. Desconecte e reconecte.

O widget do Zoom Phone abre, mas não há áudio​

  • Verifique se o Zoom desktop client v5.9.0+ está instalado e em execução.
  • Conceda ao navegador permissão de microfone quando solicitado.

Os números de telefone na lista de Contatos não são clicáveis​

  • Verifique que a integração está Conectada em Configurações → Conexões → Zoom.
  • Certifique-se de que o contato tem um valor no campo Celular.

Dados e Privacidade​

Tipo de dadoComo é usado
Tokens OAuth do ZoomArmazenados com segurança no banco de dados do Minotaur, com escopo para o seu usuário.
Perfil de usuário do Zoom (nome, e-mail)Exibido no cartão de status da conexão. Não é compartilhado externamente.
Histórico de chamadasObtido em tempo real da API do Zoom Phone. Não é armazenado no banco de dados do Minotaur.
Áudio de chamadasNunca acessado ou armazenado pelo Minotaur.

Suporte​

Para obter ajuda com esta integração, entre em contato com o suporte do Minotaur: