Skip to main content
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 global para administradores, pedindo-lhe que tome uma ação.

​
Como reautorizar uma integração

1. No seu Dashboard, aceda a Conta > 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.
3. 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.
4. 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.