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

Saiba como atualizar seu pacote do Calendly Salesforce da versão 1 para a versão 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 Calendly no Salesforce para baixar a versão 2 por padrão.

Melhorias na 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, acesse a 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 atualizado do Salesforce, 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 Criador de Processos. Agora você pode adicionar lógica condicional diretamente nos fluxos de trabalho do Calendly.

Manter personalizações feitas na versão 1

As alterações feitas na versão 1 do pacote padrão do Calendly não serão transferidas automaticamente para a versão 2. Antes de atualizar para uma nova 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 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 que você possa implementá-las novamente. Você deve reconstruí-las no seu ambiente sandbox v2 antes de adicioná-las à produção.

• Consulte Como atualizar para a versão 2 (com personalizações) para obter etapas sobre como fazer isso.
• Se você não tiver nenhuma personalização existente, prossiga para a seção Como atualizar para a versão 2 (sem personalizações).

Verifique se há personalizações feitas na versão 1

1. Faça login no Salesforce.

2. Para verificar se você personalizou algum fluxo, vá para Fluxos.

3. Para o fluxo CreateEvent, selecione Ver detalhes e versões. Compare sua versão com a versão padrão do pacote. Consulte a tabela abaixo para obter números de versão padrão. Se sua versão ativa não é o número da versão padrã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 atualizar para a versão 2 (com personalizações).

4. Para verificar se você personalizou algum processo, vá para o Criador de Processos. Para o processo OnCalendlyActionCreated, selecione a seta ao lado para expandir os detalhes. Se você tem uma versão ativa diferente da versão 3, isso significa que você personalizou o processo. Consulte a tabela abaixo para obter 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á criador de fluxos na v2, você adicionará essas personalizações diretamente aos fluxos da v2 ao concluir Como atualizar para a versão 2 (com personalizações).

Atualizar 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 atualização 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 desconectar. Observação: é melhor desconectar durante um 'horário de folga' para limitar quaisquer interrupções no Salesforce.

2. No Salesforce, desinstale o pacote v1.

   Pesquise por Pacotes Instalados e selecione Desinstalar ao lado do pacote do Calendly. Se você for solicitado a desativar quaisquer fluxos ou processos, faça isso.

   • Mais detalhes e práticas recomendadas do Salesforce sobre a desinstalação de um pacote.

   • Depois de desinstalar v1, seus fluxos, personalizações e processos atuais serão removidos.

3. No Calendly, selecione Integrar Agora. Digite suas credenciais do Salesforce e selecione Entrar.

4. Selecione permitir acesso.

5. Selecione Instalar o pacote do Calendly e selecione Instalar para todos os usuários.  Selecione Concluído.

6. Assim que o pacote estiver instalado, retorne ao Calendly e selecione Recarregar para concluir 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 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 atualização na sua página de integração do Salesforce)

• você tem acesso a um ambiente de teste e ambiente de produção do Salesforce

• você fez extensas personalizações no seu pacote do Salesforce, e manter uma conexão entre o Salesforce e 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 teste antes de desconectar sua instância de produção do Calendly.

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

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

1. No Calendly, vá para a página de integração do Salesforce. Selecione desconectar.

2. No Calendly, selecione Conectar ao Ambiente de Teste.

3. Digite suas credenciais do ambiente de teste e baixe o novo pacote do Calendly para o seu ambiente de teste.

4. Uma vez conectado, selecione recarregar a página. A página deve listar a versão 2.x.

Se você precisar de mais assistência para conectar seu ambiente de teste, consulte aqui as instruções.

Etapa 3 – No Calendly, agende reuniões de teste para enviar para o ambiente de teste

1. No Calendly, agende uma ou duas reuniões de teste. As reuniões agendadas criarão registros de referência no ambiente de teste. Você pode clonar esses registros para testar personalizações nos fluxos.

2. Para confirmar que os dados de eventos das suas reuniões de teste aparecem, crie uma guia para o objeto CalendlyActions no Salesforce. Visite a guia e veja 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 de reuniões ao vivo não sejam perdidos durante os testes no ambiente de teste.

1. No Calendly, selecione desconectar para desconectar sua instância de ambiente de teste.

2. Selecione Integrar agora e faça login com suas credenciais do Salesforce.

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

1. No Salesforce, vá para o seu ambiente de teste 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, tenha o ambiente de teste e a produção abertos em janelas separadas.

   Observação: se você personalizou o processo OnCalendlyAction para ser executado condicionalmente, precisará construir essa lógica condicional na parte inicial de seus fluxos.

Etapa 6 – No ambiente de teste, teste seus fluxos personalizados

1. Clone os registros existentes do CalendlyAction, invitee.created e invitee.canceled e modifique partes desses registros para acionar os fluxos para diferentes situações.

   • Por exemplo, você pode acionar o fluxo quando um convidado marcar um horário com um e-mail que é novo no Salesforce ou quando um convidado marcar um horário com um e-mail que já existe no Salesforce.

   • Use a guia do 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 Pacotes instalados e selecione Desinstalar ao lado do pacote do Calendly não gerenciado. Se você for solicitado a desativar quaisquer fluxos ou processos, faça isso.

Etapa 9 – No Salesforce, migre e ative fluxos personalizados

1. No Salesforce, migre os fluxos personalizados da sandbox para a produção usando conjuntos de alterações. Desative os fluxos de modelo incluídos no pacote.

2. Ative seus fluxos personalizados e automações na produção e mantenha os modelos desativados.

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

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