Saltar para o conteúdo principal
Neste artigo vai saber o que é o fluxo de reautorização e porque existe, quando e como reautorizar a sua integração e o que acontece quando a autorização expira.
Nível de utilizador: Admin
A CloudTalk inclui agora uma ação dedicada Reautorizar integração em todas as páginas de definições de integração. Isto permite aos administradores atualizar ou substituir credenciais sem desativar a integração nem desencadear uma resincronização completa de entidades. Anteriormente, a única forma de reautorizar uma integração de CRM era desativá-la e voltar a ativá-la. Esse processo trazia o risco de dados duplicados, perda temporária de dados e carga de sincronização desnecessária. Com o novo fluxo de reautorização, estes riscos são eliminados.

Porque pode precisar de reautorizar

A reautorização é necessária em várias situações comuns:
  • O utilizador que configurou originalmente a integração foi removido do seu CRM ou da sua conta CloudTalk
  • Os âmbitos de permissão OAuth da sua integração precisam de ser alargados (por exemplo, acesso a listas ou campanhas do CRM)
  • Um pacote de integração de CRM foi atualizado e as novas funcionalidades exigem credenciais atualizadas
  • Alterações regionais de centro de dados exigem novas credenciais
Sem esta funcionalidade, qualquer um dos cenários acima obrigaria a recriar a integração de raiz, gerando pedidos de suporte e colocando os seus dados em risco.

O que acontece quando a autorização expira

Quando as credenciais de uma integração deixam de ser válidas, o comportamento depende do tipo de alteração:
  • Nova funcionalidade ou atualização de pacote que exige reautorização: as funcionalidades existentes continuam a funcionar, mas as novas ficam indisponíveis até a reautorização estar concluída.
  • Utilizador que autorizou originalmente removido do CRM: toda a integração pode ficar bloqueada até as credenciais serem atualizadas.
Em ambos os casos, a CloudTalk mostra uma notificação através de um banner na página de definições da integração, de um indicador de estado na lista de integrações ou de um alerta no topo da página inicial do Dashboard, pedindo-lhe que tome uma ação.

O alerta no Dashboard

Enquanto uma integração precisar de reautorização, os administradores veem uma barra de alerta no topo da página inicial do Dashboard, por baixo da mensagem de boas-vindas. Os agentes, supervisores e analistas não a veem.
  • Para uma integração, a barra identifica-a: «Your Salesforce integration credentials need updating. Some features may not work as expected.» A ligação à direita abre a página de definições dessa integração.
  • Para várias integrações, uma única barra resume-as: «3 integrations need re-authorization. Salesforce, HubSpot and 1 more may have limited functionality.» A ligação abre a lista de integrações.
  • Se houver outros alertas ativos ao mesmo tempo, o Dashboard mostra primeiro o mais grave.
  • Clique em X para dispensar a barra. Dispensá-la não altera nada na integração: continua a precisar de reautorização e o seu estado na lista de integrações mantém-se até concluir o processo.

Como reautorizar uma integração

  1. No seu Dashboard, aceda a Definições > Integrações e clique na integração que precisa de reautorizar.
  2. No painel de definições, verá o botão Reautorizar integração. Clique nele para começar.
  1. Surge uma caixa de diálogo a explicar o que vai acontecer durante a reautorização. Antes de continuar, confirme que:
  • A sua integração mantém-se ativa durante todo o processo
  • Nenhum fluxo de trabalho ou dado existente será interrompido
  • Não será desencadeada automaticamente uma resincronização completa
Opcionalmente, pode assinalar a caixa Desencadear uma resincronização completa de entidades após a reautorização se quiser intencionalmente que todas as entidades sejam reimportadas. Isto não é necessário para que a reautorização funcione e pode demorar vários minutos.
  1. Consoante o tipo da sua integração:
  • Integrações baseadas em OAuth: será redirecionado para a página de início de sessão do seu CRM para concluir um fluxo OAuth padrão. Poderá ser-lhe pedido que conceda âmbitos de permissão alargados, se necessário.
  • Integrações baseadas em token de API: ser-lhe-á pedido que introduza diretamente um novo token de API. O token é validado imediatamente após o envio.
Assim que estiver concluído, regressa à página de definições da integração e as suas credenciais ficam ativas.
Importante: a reautorização não repõe a sua integração nem reimporta os seus dados, a menos que opte explicitamente por uma resincronização completa. O seu Histórico de chamadas, os mapeamentos de contactos e as configurações de fluxo de trabalho são preservados.

Perguntas frequentes

  • A minha integração deixa de funcionar enquanto reautorizo? Não. A integração mantém-se ativa durante todo o processo de reautorização. Os agentes podem continuar a fazer e a receber chamadas sem interrupção.
  • Tenho de voltar a configurar as minhas definições de sincronização depois de reautorizar? Não. A sua configuração de sincronização existente, os mapeamentos de campos e as definições do fluxo de trabalho são preservados. Apenas as credenciais de autenticação são atualizadas.
  • E se desencadear acidentalmente uma resincronização completa? Se assinalou a opção «Desencadear uma resincronização completa de entidades», todas as entidades serão reimportadas do seu CRM. Isto pode resultar em registos duplicados se os contactos já existirem na CloudTalk. Não assinale esta opção a não ser que precise especificamente de uma importação nova de todos os dados do CRM.
  • E se a reautorização falhar? Se o fluxo OAuth ou a validação do token falhar, a integração mantém-se no estado atual e verá uma mensagem de erro. Verifique se a conta de CRM com a qual está a iniciar sessão tem as permissões necessárias e tente novamente. Se o problema persistir, contacte o Suporte da CloudTalk.

Precisa de ajuda ou tem alguma questão? Contacte-nos através do nosso portal de Suporte — estamos aqui para si.