Configurar multiambiente no Salesforce permite conectar várias instâncias Salesforce (como sandbox e produção) e testar com segurança workflows, conteúdo, orientações e procedimentos antes de entrar em produção.
Este guia orienta você a conectar ambientes, configurar canais, testar workflows e promover alterações para produção.
Principais benefícios
Teste alterações com segurança sem impactar seu ambiente ao vivo.
Execute workflows específicos do ambiente para melhor controle.
Valide integrações e roteamento antes da implantação.
Direcione conteúdo, orientações e procedimentos para ambientes específicos.
Passo 1: Conecte e configure outro ambiente
Vá para Connect > Connect to Salesforce no menu principal.
Clique em Connect em "Add organization".
Siga as instruções de configuração para conectar sua instância Salesforce.
Depois de conectado, será necessário configurar as permissões e Connect to the Salesforce Enhanced Chat API (se aplicável) para seu novo ambiente de teste. Tudo isso é feito na mesma página Connect, abaixo da lista de conexões Salesforce. Haverá um novo menu suspenso que permite alternar entre conexões durante a configuração.
Passo 2: Configure seus canais para multiambiente
Depois de conectar seu ambiente de teste, vá para a seção Deploy e escolha o canal que deseja testar. Dependendo do canal, pode haver configurações adicionais a fazer neste ponto.
Canal de casos Salesforce
Para casos Salesforce, você precisará escolher qual usuário atuará como Fin em seu ambiente de teste. Você verá um novo acordeão no canal de casos Salesforce que solicitará configurar os casos.
Ao clicar em Configure aqui, será solicitado que escolha um usuário Salesforce para o Fin responder. Você também pode configurar Fin por e-mail opcionalmente aqui. Se planeja usar um domínio de e-mail diferente para seu ambiente de teste, será necessário verificá-lo aqui.
Nota: Não esqueça de configurar seu roteamento no lado Salesforce para que novos casos sejam atribuídos ao usuário Fin.
Canal Enhanced Chat [optional]
Será necessário conectar a Salesforce Enhanced Chat API do seu novo ambiente Salesforce se quiser transferir para um agente humano. Esta configuração está na página Connect, então talvez você já tenha adicionado essa configuração, mas se não, terá uma etapa incompleta no canal Fin Messenger solicitando que adicione sua configuração.
Configure workflows
Você encontrará seus workflows existentes abaixo das listas de verificação Deploy para cada canal.
Workflow de casos Salesforce
Se usar transferência de casos Salesforce, precisará configurar para qual usuário ou fila o caso será transferido ao adicionar um novo ambiente. Inicialmente verá uma caixa vermelha ao redor da etapa de transferência não configurada. Clique nela e escolha um responsável por ambiente.
Workflow Fin Messenger
Depois de conectar à Salesforce Enhanced Chat API, nenhuma configuração adicional é necessária para o workflow Fin Messenger. Veja detalhes de como testar cada ambiente na próxima seção.
Sincronize dados para e do Salesforce
Sincronizar dados não muda quando você adiciona outra conexão. Você ainda verá um conjunto de atributos ao escolher da sua lista. Os atributos na lista vêm do seu ambiente de produção e, se um ambiente de produção não estiver conectado, os atributos serão puxados do seu ambiente padrão.
Importante: Os atributos devem existir em ambos os ambientes e coincidir em:
Tipo
Opções (para listas de seleção)
Passo 3: Atualize workflows para múltiplos ambientes
A principal forma de testar seu novo ambiente é via workflows. Você tem duas opções para testar com workflows.
Opção 1: Direcionar um workflow
Abra um workflow.
Clique no primeiro bloco.
Escolha para qual(is) ambiente(s) o workflow se aplica.
Selecione Concluído e ative seu workflow.
Opção 2: Adicionar ramificação
Se não quiser criar um novo workflow, pode adicionar ramificação dentro de um workflow existente:
Abra seu workflow.
Adicione uma etapa Branches .
Adicione uma condição usando Environment e selecione o ambiente desejado.
Defina a lógica para cada ambiente.
Dica: Duplique workflows usando o menu de três pontos > Duplicate para criar rapidamente versões específicas para cada ambiente.
Passo 4: Teste sua configuração
Depois de atualizar seus workflows, você pode testar as alterações em seus ambientes não produtivos.
Teste casos Salesforce
Vá para Deploy > Salesforce cases.
Clique em Live test no topo da página.
Ative seu ambiente de teste.
Uma vez ativado:
Casos atribuídos ao usuário Fin serão tratados pelo Fin.
As conversas aparecerão em Analyze > Conversations.
Teste Fin Messenger
Vá para Deploy > Fin Messenger.
Clique em Live test no topo da página.
Selecione seu ambiente no menu suspenso.
Digite uma URL onde o messenger está instalado.
Clique em Launch test.
O sistema adiciona automaticamente:
IntercomLiveTest=true
messenger_environment=abc123
IntercomLiveTest=true — isso indica ao messenger para iniciar mesmo que não esteja ativado para que você possa testá-lo
messenger_environment=abc123 — isso indica ao messenger qual ambiente você está testando. Mesmo que tenha apontado para seu site de produção, isso trocará o ambiente do messenger para o ambiente definido na URL. Você também pode adicionar isso às configurações do messenger se tiver um messenger em um site de teste interno para não precisar sempre lembrar de incluir o ambiente na URL para definir o modo de teste.
Nota: Se não especificar o atributo messenger_environment nem na URL nem nas messenger_settings, o ambiente padrão será usado. Para definir um ambiente padrão, vá para a página Connect, clique em Manage abaixo do ambiente e ative o toggle Default environment.
Passo 5: Teste conteúdo, orientações e procedimentos
Para testar conteúdo, orientações ou procedimentos específicos do ambiente:
Crie um público
Vá para Settings > Audiences.
Clique em New.
Adicione uma regra:
Selecione Environment.
Escolha seu ambiente alvo.
Salve o público.
Aplique o público
Conteúdo: Selecione um conteúdo e defina o público na barra lateral "Detalhes".
Orientação: Selecione o público no menu suspenso após adicionar sua orientação.
Tarefas e procedimentos: Aplique o público no primeiro nó.
Passo 6: Promova alterações para produção
Quando estiver pronto para entrar em produção:
Conteúdo, orientações, procedimentos: Remova o direcionamento de público ou altere para um público usado em produção.
Workflows com ramificação: Remova a ramificação e a lógica antiga redundante, ou atualize os ramos para apontar para seu ambiente de produção.
Novos workflows: Altere o direcionamento do ambiente no primeiro bloco ou reordene os workflows na página Deploy.
Nota:
Workflows são executados na ordem em que aparecem na página deploy, então se o primeiro workflow corresponder ao ambiente atual, ele será selecionado para rodar quando uma nova conversa ou caso chegar. Atualmente há uma restrição que impede mover o primeiro workflow para baixo, que será removida em breve.
A coluna "Environments" na página Deploy mostrará qual ambiente o workflow está direcionando atualmente.
Glossário
Ambiente
Um ambiente é qualquer instância Salesforce conectada ao seu workspace Intercom. Eles podem ser usados para direcionar workflows, procedimentos, conteúdo ou orientações. O ambiente também é aplicado a qualquer conversa exibida em Analyze > Conversations na barra lateral direita.
Ambiente padrão
Este é o ambiente usado pelo Fin Messenger quando nenhum ambiente específico é passado para o messenger. O ambiente padrão pode ser configurado na página Connect clicando no ambiente e ativando o toggle Default environment.
Ambiente do Messenger
Esta é uma string que pode ser passada via URL ou configurada no objeto de configurações do messenger (como messenger_environment). Isso mapeia diretamente para um ambiente Salesforce conectado. Você pode obter a string do ambiente do messenger clicando em um ambiente específico na página Connect e copiando o valor na parte inferior da folha aberta, ou indo para Deploy > Fin Messenger e clicando em Live test e inserindo sua URL para o ambiente que deseja testar.
Ambiente de produção
Este será sempre o ambiente com o qual seus clientes ao vivo interagem. Um ambiente de produção é necessário para que um canal entre em produção. Você conecta explicitamente seu ambiente de produção na página Connect. Não é necessário conectar a produção inicialmente, você pode conectar um ambiente de teste primeiro.