Como fazer upgrade do seu pacote Calendly Salesforce para a versão 2

Saiba como fazer upgrade do seu pacote Calendly Salesforce da versão 1 para a 2, preservando quaisquer personalizações que você possa ter.

Se você estiver baixando o pacote do Salesforce pela primeira vez, pode pular este artigo e seguir as etapas em Como instalar o pacote do Calendly no Salesforce para baixar a versão 2 por padrão.

Melhorias da versão 2

Pacote gerenciado

A versão 1 (v1) não é gerenciada, mas a versão 2 (v2) é gerenciada. Com pacotes gerenciados, você pode atualizar sem precisar desinstalar e reinstalar.

Se você não tiver certeza de qual versão está usando, acesse sua página de integração do Salesforce para confirmar.

Mais dados no Salesforce

A versão 2 (v2) captura mais informações sobre seus eventos do Calendly. Com um pacote do Salesforce atualizado, você pode ver:

• local da reunião
• reuniões remarcadas
• todas as 10 perguntas e respostas personalizadas
• status de não comparecimento

Processo removido

A versão 2 (v2) não inclui o processo OnCalendlyActionCreated, portanto você não precisará do Process Builder. Agora você pode adicionar lógica condicional diretamente nos fluxos do Calendly.

Mantendo personalizações feitas na versão 1

Alterações que você fez na versão 1 do pacote padrão do Calendly não serão transferidas automaticamente para a versão 2. Antes de fazer upgrade de versão, verifique se há fluxos e processos personalizados na sua instância do Salesforce.

• Você pode ver se tem alguma personalização seguindo as etapas em Como verificar as personalizações que você fez no Salesforce.

Se você tiver quaisquer personalizações existentes, faça uma lista ou tire capturas de tela dessas personalizações antes de desinstalar, para que você possa implementá-las novamente. Você vai querer reconstruí-las no seu ambiente de sandbox v2 antes de adicioná-las em produção.

• Consulte Como fazer upgrade para a versão 2 (com personalizações) para ver as etapas de como fazer isso.
• Se você não tiver personalizações existentes, prossiga para a seção Como fazer upgrade para a versão 2 (sem personalizações).

Verifique as personalizações feitas na versão 1

1. Inicie sessão no Salesforce.
2. Para verificar se você personalizou algum fluxo, vá para Flows.
3. Para o fluxo CreateEvent , selecione View Details and Versions. Compare sua versão existente com a versão padrão do pacote. Consulte a tabela abaixo para os números de versão padrão. Se sua versão ativa for um número que não é o número de versão padrão, então você personalizou seus fluxos.
   Observação: Se você tiver fluxos personalizados, visualize-os em produção e tire capturas de tela. Você adicionará essas personalizações ao concluir Como fazer upgrade para a versão 2 (com personalizações).
4. Para verificar se você personalizou algum processo, vá para o Process Builder. Para o processo OnCalendlyActionCreated, selecione a seta ao lado dele para expandir os detalhes. Se você tiver uma versão ativa diferente da versão 3, isso significa que você personalizou o processo. Consulte a tabela abaixo para os números de versão padrão.
   Observação: Se você tiver um processo personalizado, visualize os detalhes do processo ativo em produção para entender a lógica condicional que é acionada quando um fluxo é executado. Tire uma captura de tela de quaisquer personalizações. Como não há process builder no v2, você adicionará essas personalizações diretamente aos fluxos v2 ao concluir Como fazer upgrade para a versão 2 (com personalizações).

Antes de desinstalar o pacote v1

Antes de prosseguir com qualquer um dos caminhos de upgrade, revise o que acontece quando você desinstala o pacote v1:

• Quando você desinstala o pacote Calendly Salesforce v1, todos os registros CalendlyAction são excluídos permanentemente.
• Registros padrão do Salesforce criados a partir dessas ações (como Eventos, Leads e Contatos) não são afetados e permanecerão na sua Conta do Salesforce.
• A maioria dos usuários não precisa manter registros CalendlyAction. No entanto, se você depende deles para relatórios, exporte esses dados antes de desinstalar o pacote.
• Você pode exportar dados usando uma ferramenta como o Salesforce Data Loader.

Fazer upgrade para a versão 2 (sem personalizações)

Siga estas etapas se…

• você já usa a versão 1 do pacote do Salesforce
• você tem acesso à versão 2 (você verá um banner de upgrade na sua página de integração do Salesforce)
• e você não fez personalizações no seu pacote do Salesforce

1. Na sua página de integração do Salesforce, selecione disconnect. Observação: é melhor desconectar durante um “horário de baixa” para limitar quaisquer interrupções no Salesforce.
2. No Salesforce, desinstale o pacote v1.
   Pesquise por Installed Packages e selecione Uninstall ao lado do pacote do Calendly. Se for solicitado que você deactivate quaisquer fluxos ou processos, faça isso.
• Mais detalhes e boas práticas do Salesforce sobre como desinstalar um pacote.
• Depois que você desinstalar o v1, seus fluxos atuais, personalizações e processos serão removidos.
3. No Calendly, selecione Integrate Now. Insira suas credenciais do Salesforce e selecione Log In.
4. Selecione allow acesso.
5. Selecione Install the Calendly package e selecione Install for All Users. Selecione done.
6. Depois que o pacote for instalado, volte ao Calendly e selecione refresh para concluir a conexão entre Calendly e Salesforce.
   
7. Sua página de integração do Salesforce deve listar a versão 2.x.

Fazer upgrade para a versão 2 (com personalizações)

Siga estas etapas se…

• você já usa a versão 1 do pacote do Salesforce
• você tem acesso à versão 2 (você verá um banner de upgrade na sua página de integração do Salesforce)
• você tem acesso a um ambiente de sandbox e de produção do Salesforce
• você fez personalizações extensas no seu pacote do Salesforce, e manter uma conexão do Salesforce com o Calendly enquanto personaliza a versão 2 é crucial

Etapa 1 – Configurar seu ambiente de sandbox do Salesforce

Para minimizar o tempo de inatividade durante o processo de migração, configure seu ambiente de sandbox antes de desconectar sua instância de produção do Calendly.

1. No Salesforce, crie um novo ambiente de sandbox ou use um existente que não tenha um pacote do Calendly instalado. Se você estiver usando um sandbox existente, atualize seu sandbox com os dados mais recentes de produção antes de prosseguir.

Etapa 2 – No Calendly, desconecte sua Conta do Salesforce e conecte seu ambiente de sandbox

1. No Calendly, vá para a página de integração do Salesforce. Selecione disconnect.
2. No Calendly, selecione Connect to Sandbox.
3. Insira suas credenciais do sandbox e baixe o novo pacote do Calendly para o seu ambiente de sandbox.
4. Depois de conectado, selecione refresh page. A página deve listar a versão 2.x.

Se você precisar de mais ajuda para conectar seu ambiente de sandbox, veja aqui as instruções.

Etapa 3 – No Calendly, agende reuniões de teste para enviar ao sandbox

1. No Calendly, agende uma ou duas reuniões de teste. As reuniões agendadas criarão registros de referência no sandbox. Você pode clonar esses registros para testar personalizações dos fluxos.
2. Para confirmar que os dados do evento das suas reuniões de teste aparecem, crie uma guia para o objeto CalendlyActions no Salesforce. Visite a guia e view all records para confirmar que os dados da reunião estão sendo enviados corretamente.

Etapa 4 – No Calendly, reconecte seu ambiente de produção ao pacote v1

Reconecte seu ambiente de produção ao Calendly, para que os dados de reuniões ao vivo não sejam perdidos enquanto você testa no sandbox.

1. No Calendly, selecione disconnect para desconectar sua instância de sandbox.
2. Selecione Integrate now e inicie sessão com suas credenciais do Salesforce.

Etapa 5 – No sandbox, faça cópias dos fluxos do Calendly e adicione suas personalizações

1. No Salesforce, vá para o seu ambiente de sandbox e faça uma cópia dos modelos no pacote gerenciado, CreateEventTemplate e CancelEventTemplate. Faça suas personalizações antes de ativar os fluxos personalizados e desativar os fluxos de modelo. Para facilitar esse processo, mantenha o sandbox e a produção abertos em janelas separadas.
   Observação: Se você personalizou o OnCalendlyAction process para executar condicionalmente, você precisará incorporar essa lógica condicional na parte inicial dos seus fluxos.

Etapa 6 – No sandbox, teste seus fluxos personalizados

1. Clone registros CalendlyAction existentes, invitee.created e invitee.canceled, e modifique partes desses registros para acionar os fluxos em diferentes situações.
• Por exemplo, você pode acionar o fluxo quando um convidado agenda com um e-mail que é novo no Salesforce ou quando um convidado agenda com um e-mail que já existe no Salesforce.
• Use a guia CalendlyActions que você criou na Etapa 3.2 para monitorar os dados da reunião.

Etapa 7 – No Salesforce, desinstale o pacote não gerenciado do Calendly

No Salesforce, vá para o seu ambiente de produção e desinstale o pacote não gerenciado do Calendly.

1. Pesquise por Installed Packages e selecione Uninstall ao lado do pacote não gerenciado do Calendly. Se for solicitado que você deactivate quaisquer fluxos ou processos, faça isso.

• Mais detalhes e boas práticas do Salesforce sobre como desinstalar um pacote.
• Depois que você desinstalar o v1, seus fluxos atuais, personalizações e processos serão removidos.
• Certifique-se de que o Uninstall Status esteja listado como Uninstall Complete antes de prosseguir.

Etapa 8 – No Calendly, conecte seu ambiente de produção ao pacote v2

1. No Calendly, selecione Integrate Now para instalar o novo pacote gerenciado. Insira suas credenciais do Salesforce e selecione Log In.
2. Selecione allow acesso.
3. Selecione Install the Calendly package e selecione Install for All Users. Selecione done.
4. Depois que o pacote for instalado, volte ao Calendly e selecione refresh para concluir a conexão entre Calendly e Salesforce.
   
5. A página deve listar a versão 2.x.

Etapa 9 – No Salesforce, migrar e ativar fluxos personalizados

1. No Salesforce, migre os fluxos personalizados do sandbox para produção usando change sets. Desative os fluxos de modelo incluídos no pacote.
2. Ative seus fluxos e automações personalizados em produção e mantenha os modelos desativados.

Etapa 10 – Agende uma reunião de teste no Calendly

Verifique se seus fluxos estão funcionando conforme desejado em produção agendando uma reunião de teste.

Perguntas frequentes