Como integrar Salesforce e Outlook com o Make

O Make pode coordenar registros do Salesforce com contatos, e-mails ou eventos do Microsoft 365. Antes de montar o cenário, escolha uma direção e um objeto bem definidos. Um primeiro fluxo limitado, como Salesforce para Outlook, é mais fácil de testar e reduz o risco de atualizações em ciclo.

O exemplo abaixo observa contatos alterados no Salesforce, verifica se já existe uma correspondência e cria ou atualiza o item relacionado no Outlook. Uma ramificação opcional pode criar um evento de calendário quando o registro de origem tiver os dados necessários.

Definir o escopo

Documente estas decisões antes de criar módulos:

quais objetos do Salesforce iniciarão o fluxo;

quais contatos, pastas ou calendários do Microsoft 365 serão usados;

qual sistema é a origem de cada campo;

qual ID relaciona os registros nos dois sistemas;

como o cenário trata campos vazios, exclusões e alterações simultâneas;

quem revisa falhas e conflitos.

Confirme também as permissões das contas conectadas. Conceda acesso somente aos objetos, caixas de correio e calendários necessários. Os módulos e escopos disponíveis dependem da configuração do Salesforce, do Microsoft 365 e das políticas da organização.

Estrutura do cenário

Um fluxo Salesforce para Outlook pode seguir esta ordem:

observar contatos novos ou modificados no Salesforce;

consultar um armazenamento de dados pelo ID do Salesforce;

separar criação e atualização com um roteador;

gravar o contato no Outlook;

opcionalmente criar ou atualizar um evento;

persistir o ID retornado pelo Outlook;

registrar erros e encaminhar exceções.

O armazenamento de dados funciona como uma tabela de correspondência. Ele não substitui a validação no sistema de destino, mas ajuda a reconhecer registros que o próprio cenário já processou.

1. Criar as conexões

Adicione ao cenário um módulo do Salesforce que observe o objeto selecionado. Crie a conexão e confira se ela aponta para o ambiente correto.

Depois, adicione um módulo do Microsoft 365 compatível com o recurso desejado, como contatos ou calendário. Durante a autorização, escolha a conta e o ambiente esperados. Se o administrador precisar aprovar escopos, conclua essa etapa antes de testar o fluxo.

Não grave tokens, senhas ou segredos em campos de texto. Use as conexões gerenciadas pelo Make e siga as regras internas de acesso da sua organização.

2. Configurar o gatilho do Salesforce

Configure o gatilho para observar apenas os registros relevantes. Se o critério for a data de modificação, aplique filtros adicionais para evitar que mudanças produzidas pelo próprio cenário iniciem uma nova execução.

Use Run once com um contato controlado. Inspecione a saída e confirme:

o ID do registro;

a data da última modificação;

os campos de nome, e-mail e telefone;

os dados necessários para qualquer evento;

os valores vazios e os tipos retornados.

3. Criar a deduplicação

Crie um armazenamento de dados com o ID do Salesforce como chave. Guarde, no mínimo, o ID correspondente do Outlook e um marcador da última versão processada.

Antes de escrever no Outlook, procure a chave:

sem correspondência, siga para a criação;

com correspondência válida, siga para a atualização usando o ID salvo;

com dados inconsistentes, interrompa a escrita e envie o caso para revisão.

Depois de uma criação bem-sucedida, salve o ID retornado pelo Outlook. Atualize o marcador somente após confirmar que a ação de destino terminou sem erro.

4. Mapear contatos

No módulo de contatos do Microsoft 365, associe apenas os campos aprovados. Revise nomes, endereços de e-mail, telefones, empresa e outros valores necessários.

Defina de forma explícita o que acontece quando a origem envia um campo vazio. Em muitos processos, preservar o valor existente é mais seguro do que apagá-lo automaticamente. Caso o e-mail seja usado como correspondência, trate ausências, endereços compartilhados e mudanças de endereço como exceções.

5. Criar eventos de calendário

Adicione uma rota de calendário somente quando o registro contiver início, fim, assunto e participantes válidos. Converta datas e horários para o fuso correto e verifique como eventos de dia inteiro são representados.

Guarde o ID do evento de destino para que uma execução posterior possa atualizar o evento em vez de criar outro. Antes de convidar participantes, confirme que o cenário está autorizado a enviar convites e que o ambiente de teste não usa contatos reais.

6. Gravar a referência no Salesforce

Se o modelo de dados permitir, grave no Salesforce o ID do contato ou do evento criado no Outlook. Essa referência facilita auditoria e atualização.

Faça essa escrita somente com um campo aprovado e com uma conexão autorizada. Adicione um filtro para impedir que a atualização de referência reinicie o fluxo sem necessidade.

7. Tratar erros

Adicione um manipulador de erros aos módulos que gravam no Outlook, no armazenamento de dados e no Salesforce. Registre o ID de origem, a etapa, a mensagem da API e o estado da correspondência.

Não repita automaticamente uma criação quando não souber se a tentativa anterior foi concluída. Primeiro procure o ID de destino ou confirme o resultado da execução; assim, uma nova tentativa não gera duplicidade.

Testar e diagnosticar

Execute testes controlados para:

criar um contato;

atualizar o mesmo contato;

processar um registro sem e-mail;

receber o mesmo evento mais de uma vez;

mapear um horário em outro fuso;

lidar com permissão insuficiente;

interromper uma escrita quando a correspondência estiver ambígua.

Se ocorrer uma falha, revise primeiro a entrada do módulo:

reautorize conexões expiradas ou revogadas;

confira a chave usada para deduplicação;

revise fuso, formato e duração dos eventos;

verifique permissões e políticas do Microsoft 365;

trate limitações ou indisponibilidade temporária conforme a resposta da API.

Sincronização em duas direções

Para trazer mudanças do Outlook de volta ao Salesforce, crie um cenário complementar. Use IDs persistidos, um marcador da origem da alteração ou outro mecanismo de correlação para impedir que os dois cenários atualizem um ao outro indefinidamente.

Comece com um tipo de registro e amplie apenas depois de verificar os logs e os casos de conflito. E-mails, anexos e eventos podem ter regras de privacidade e retenção diferentes; valide essas regras antes de incluí-los.

Para revisar a arquitetura original e os módulos atualmente disponíveis, consulte o guia oficial de integração entre Salesforce e Outlook.