Como atualizar seu pacote Calendly Salesforce da versão 1 para a versão 2

Saiba como atualizar seu pacote Calendly para 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 ignorar este artigo e seguir os passos 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 tem certeza de qual versão está usando, visite 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 visualizar:

• local da reunião
• reuniões reagendadas
• todas as 10 perguntas personalizadas e respostas
• 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.

Manter personalizações feitas na versão 1

As 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 atualizar, verifique se há fluxos e processos personalizados em sua instância do Salesforce.

• Você pode ver se possui customizações seguindo os passos em Como verificar as personalizações que você fez no Salesforce.

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

• Veja Como atualizar para a versão 2 (com personalizações) para os passos sobre como fazer isso.
• Se você não tiver personalizações existentes, prossiga para a seção Como atualizar para a versão 2 (sem personalizações).

Verifique personalizações feitas na versão 1

1. Inicie sessão no Salesforce.
2. Para verificar se você personalizou algum fluxo, vá para Fluxos.
3. Para o fluxo CreateEvent, selecione Visualizar Detalhes e versões. Compare sua versão atual com a versão padrão do pacote. Veja 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.
   Nota: Se você tiver fluxos personalizados, visualize-os em produção e faça capturas de tela. Você adicionará essas personalizações ao concluir Como atualizar 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. Veja a tabela abaixo para os números de versão padrão.
   Nota: 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. Faça uma captura de tela de quaisquer personalizações. Como não há Process Builder na v2, você adicionará essas personalizações diretamente aos fluxos da v2 ao concluir Como atualizar para a versão 2 (com personalizações).

Antes de desinstalar o pacote v1

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

• Quando você desinstalar o pacote Calendly para Salesforce v1, todos os registros CalendlyAction serão excluídos permanentemente.
• Registros padrão do Salesforce criados a partir dessas ações (como Events, Leads e Contacts) não são afetados e permanecerão em sua conta do Salesforce.
• A maioria dos usuários não precisa reter os 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 Salesforce Data Loader.

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

Siga estes passos se…

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

1. Na sua página de integração do Salesforce, selecione desconectar. Observação: é melhor desconectar durante um horário de menor movimento para limitar quaisquer interrupções no Salesforce.
2. No Salesforce, desinstale o pacote v1.
   Procure por Pacotes instalados, e selecione Desinstalar ao lado do pacote Calendly. Se for solicitado que você desativar quaisquer fluxos ou processos, faça-o.
• Mais detalhes e melhores práticas do Salesforce sobre desinstalar um pacote.
• Depois de desinstalar a v1, seus fluxos, personalizações e processos atuais serão removidos.
3. No Calendly, selecione Integrar agora. Insira suas credenciais do Salesforce e selecione Iniciar sessão.
4. Selecione permitir o acesso.
5. Selecione Instalar o pacote Calendly, e Instalar para todos os usuários. Selecione concluído.
6. Depois que o pacote for instalado, volte ao Calendly e selecione atualizar para completar a conexão entre o Calendly e o Salesforce.
   
7. Sua página de integração do Salesforce deve listar a versão 2.x.

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

Siga estes passos se…

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

Etapa 1 – Configure seu ambiente sandbox do Salesforce

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

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

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

1. No Calendly, vá para a página de integração do Salesforce. Selecione desconectar.
2. No Calendly, selecione Conectar ao sandbox.
3. Insira suas credenciais do sandbox e baixe o novo pacote do Calendly para o seu ambiente sandbox.
4. Uma vez conectado, selecione atualizar página. A página deve listar a versão 2.x.

Se você precisar de mais assistência para conectar seu ambiente sandbox, veja aqui para 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 nos fluxos.
2. Para confirmar que os dados do evento das suas reuniões de teste aparecem, crie uma aba para o objeto CalendlyActions no Salesforce. Visite a aba e visualizar todos os registros 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 das reuniões ao vivo não sejam perdidos enquanto testa no sandbox.

1. No Calendly, selecione desconectar para desconectar sua instância sandbox.
2. Selecione Integrar agora 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 seu ambiente 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 modelo. Para facilitar esse processo, mantenha o sandbox e a produção abertos em janelas separadas.
   Nota: Se você personalizou o processo OnCalendlyAction para ser executado condicionalmente, será necessário incorporar essa lógica condicional na parte inicial dos seus fluxos.

Etapa 6 – No sandbox, teste seus fluxos personalizados

1. Clone os registros existentes CalendlyAction, 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 agendar com um e-mail novo no Salesforce, ou quando um convidado agendar com um e-mail que já existe no Salesforce.
• Use a aba CalendlyActions que você criou na Etapa 3.2 para monitorar os dados da reunião.

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

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

1. Procure por Pacotes instalados, e selecione Desinstalar ao lado do pacote Calendly não gerenciado. Se for solicitado que você desativar quaisquer fluxos ou processos, faça-o.

• Mais detalhes e melhores práticas do Salesforce sobre desinstalar um pacote.
• Depois de desinstalar a v1, seus fluxos, personalizações e processos atuais serão removidos.
• Certifique-se de que o Status de desinstalação esteja listado como Desinstalação concluída antes de prosseguir.

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

1. No Calendly, selecione Integrar agora para instalar o novo pacote gerenciado. Insira suas credenciais do Salesforce e selecione Iniciar sessão.
2. Selecione permitir o acesso.
3. Selecione Instalar o pacote Calendly, e Instalar para todos os usuários. Selecione concluído.
4. Depois que o pacote for instalado, volte ao Calendly e selecione atualizar para completar a conexão entre o Calendly e o Salesforce.
   
5. A página deve listar a versão 2.x.

Etapa 9 – No Salesforce, migre e ative os fluxos personalizados

1. No Salesforce, migre os fluxos personalizados do sandbox para a produção usando change sets. Desative os fluxos modelo incluídos no pacote.
2. Ative seus fluxos personalizados e automações na 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 na produção agendando uma reunião de teste.