Consulte os conetores suportados para a solução Application Integration.

Acionador do Salesforce

O acionador do Salesforce permite-lhe ouvir eventos de captura de dados de alterações (CDC) ou plataforma de mensagens empresariais. Com este acionador, pode iniciar a integração com base em qualquer um dos eventos de CDC (criar, atualizar, eliminar ou recuperar) ou nos eventos da plataforma na sua instância do Salesforce.

Para mais informações, consulte os seguintes tutoriais:

• Para usar a integração de aplicações para automatizar o fluxo do processo empresarial de encaminhamento e atribuição de um registo de cliente do Salesforce, consulte o tutorial Automatize as atribuições de encaminhamento de registos do Salesforce.
• Para usar a integração de aplicações para automatizar um fluxo de gestão de encomendas entre uma aplicação de gestão das relações com clientes (CRM) e uma aplicação de planeamento de recursos empresariais (ERP), consulte o tutorial Automatize a oportunidade do Salesforce para a encomenda do BigQuery.
• Para usar o acionador do Salesforce para invocar uma integração na integração de aplicações para um evento de captura de dados de alterações (CDC) do Salesforce, consulte o tutorial Invocar uma integração para um evento de captura de dados de alterações (CDC) do Salesforce.

Antes de começar

Esta secção descreve os passos necessários para ligar e configurar uma instância do Salesforce para usar a captura de dados de alterações (CDC) ou os eventos da plataforma para transmitir alterações à sua integração de aplicações de forma pub/sub. Os passos seguintes têm de ser concluídos antes de configurar qualquer tarefa ou acionador relacionado com o Salesforce na integração de aplicações:

• Configure um utilizador de integração
• Configure um conjunto de autorizações
• Configure um token de segurança
• Crie uma app associada

Nota: para concluir estes passos, é necessário ter acesso de administração do sistema à sua instância do Salesforce. Se não tiver acesso de administrador, partilhe estas instruções com o administrador do Salesforce.

Este tutorial fornece instruções detalhadas, mas recomendamos que tenha alguma compreensão das opções de configuração do Salesforce. O Salesforce fornece documentação para programadores detalhada para ajudar a começar.

Configure um utilizador de integração

Nota: se já tiver um utilizador de integração e souber a palavra-passe, pode avançar para o passo seguinte. Se precisar de repor a palavra-passe, consulte o passo 6 abaixo.

Configure um utilizador de integração com os seguintes passos:

1. Inicie sessão na sua instância do Salesforce com as suas credenciais do sysadmin.
2. Clique no ícone de roda dentada e, de seguida, selecione Configuração, conforme mostrado na imagem abaixo:
3. Clique em Utilizadores > Utilizadores no menu Administração.
4. No painel Utilizadores, selecione o botão Novo utilizador.
5. Na caixa de diálogo Edição do utilizador, preencha os seguintes detalhes:
   1. Nome próprio: nome próprio do utilizador da integração.
   2. Apelido: apelido do utilizador da integração.
   3. Endereço de email: email do utilizador da integração. Idealmente, deve ser um email de grupo.
   4. Nome de utilizador: nome de utilizador em conformidade com as convenções de nomenclatura ao nível da organização.

      Se estiver a criar um novo utilizador de integração, use o seguinte formato: EMAIL.SALESFORCE_ORG_NAME.SANDBOX_NAME

      Se tiver um utilizador de integração existente, confirme que o nome de utilizador está introduzido aqui.

   5. Função: selecione no menu pendente de opções.
   6. Licença de utilizador: introduza Salesforce ou, se estiver a usar uma organização de avaliação, introduza Salesforce Platform.
   7. Perfil: selecione o perfil de autorizações para utilizadores de integração no menu pendente.

      Recomendamos que atribua um perfil sem autorizações para proteger o acesso do utilizador da integração ao Salesforce contra a utilização não autorizada.

   8. Clique em Guardar.
6. Para atualizar a palavra-passe do novo utilizador de integração, siga estes passos:
   1. Clique no botão Repor palavras-passe no painel Utilizadores. É enviado um email de reposição de palavra-passe para o endereço de email associado ao utilizador.
      Nota: confirme que tem acesso à conta de email associada ao utilizador de integração antes de acionar o fluxo de reposição da palavra-passe. Além disso, se tiver o SSO ativado para este utilizador, não pode repor a palavra-passe. Para ativar a opção de reposição, aceda a Perfil > Autorizações do sistema e desmarque a opção Início de sessão com SSO ativado.
   2. Siga o fluxo de reposição da palavra-passe a partir da conta de email. Tome nota da nova palavra-passe, uma vez que vai precisar dela num passo posterior.

Configure um conjunto de autorizações

Se já tiver acesso a um conjunto de autorizações adequado para um utilizador de integração, pode ignorar este passo e avançar para Configurar um token de segurança. Caso contrário, siga estes passos para configurar um conjunto de autorizações para o utilizador de integração e o objeto do Salesforce.

Para configurar um conjunto de autorizações para o utilizador de integração:

1. No menu Configuração, clique em Utilizadores > Conjuntos de autorizações.
2. No painel Conjuntos de autorizações, clique no botão Novo.
3. Na caixa de diálogo Conjuntos de autorizações, introduza os seguintes detalhes:
   • Etiqueta: introduza um nome para o conjunto de autorizações.
   • Licença: selecione Salesforce no menu pendente Licença.
   • Clique em Guardar.
4. Na lista de opções de definições do Sistema, desloque a página para baixo e selecione Autorizações do sistema
5. Na página Autorizações do sistema, clique no botão Editar.
6. Desloque a página para baixo na lista de autorizações disponíveis e selecione a caixa de verificação API ativada.

   A autorização Utilizador apenas da API também é necessária, mas não pode ser ativada até que o token de segurança necessário seja reposto. Esta autorização é adicionada num passo posterior.

7. (Opcional) Desloque a página e selecione Modificar todos os dados e Ver todos os dados, se aplicável. Estas autorizações não são obrigatórias, mas podem ser úteis se quiser conceder automaticamente ao utilizador da integração acesso a novos objetos. Recomendamos que ative estas autorizações apenas para testes numa sandbox.
8. Desloque a página para a parte superior da lista de autorizações e clique em Guardar.
9. Confirme as definições e clique em Guardar.

Para configurar o conjunto de autorizações para o objeto do Salesforce:

1. Clique em Vista geral do conjunto de autorizações para voltar à página de configuração principal do conjunto de autorizações.
2. Selecione Definições de objetos na secção Apps do painel Conjunto de autorizações.
3. Desloque a página para baixo e selecione os objetos do Salesforce que requerem um conjunto de autorizações. Este exemplo usa o objeto Opportunity.
   NOTA: o CDC só suporta um subconjunto de objetos padrão do Salesforce. Para saber mais, consulte: Alterar o suporte de objetos de eventos.
4. Clique no botão Editar na página de detalhes do objeto.
5. Selecione as caixas de verificação para os tipos de registos. Se souber que tipos de registos são necessários, selecione-os. Se não souber que tipos de registos são necessários, selecione-os todos.
6. Selecione as caixas de verificação das Autorizações de objetos a ativar. As opções Ler e Ver tudo são recomendadas.
7. Conceda acesso de leitura ou acesso de edição para cada campo de objeto selecionando a caixa de verificação correspondente.
   Nota: o acesso de escrita não é necessário para utilização com o CDC.
8. Desloque a página até à parte superior e clique em Guardar.

Configure um token de segurança

Se tiver criado um token de segurança para o utilizador de integração anteriormente e repuser a palavra-passe, é enviado automaticamente um email com um novo token de segurança. Pode usar o novo token e avançar para Criar uma app associada.

Caso contrário, siga estes passos para repor o token de segurança do utilizador de integração:

1. Inicie sessão no Salesforce como utilizador da integração, usando o nome de utilizador e a palavra-passe definidos num passo anterior.
2. No menu principal, clique na imagem do perfil e, de seguida, em Definições.
3. No menu Definições, selecione Repor o meu token de segurança para abrir o painel Repor token de segurança.
4. Clique no botão Repor token de segurança.
5. Verifique a conta de email associada ao utilizador da integração para ver se recebeu um email com o novo token de segurança. Tome nota do novo token de segurança, uma vez que vai precisar dele num passo posterior.
6. (Opcional) Ative a autorização Apenas utilizador da API em Autorizações do sistema para o seu conjunto de autorizações, conforme descrito em Configure um conjunto de autorizações acima.

Crie uma app associada

É necessária autorização de administração do sistema para configurar uma app associada. Se tiver sessão iniciada como utilizador de integração, certifique-se de que termina sessão e, em seguida, inicia sessão novamente como sysadmin.

Siga estes passos para configurar uma app associada:

1. Clique no ícone de roda dentada e, de seguida, selecione Configuração.
2. No menu Configuração, pesquise e selecione Gestor de apps, conforme mostrado na imagem abaixo:
3. Clique em Nova app associada.
4. No painel de configuração, faculte os seguintes detalhes:
   • Nome da app associada: introduza um nome para a sua app associada.
   • Nome da API: introduza o nome da API.
   • Email de contacto: introduza um email para a sua app associada, idealmente um alias de email de grupo.
   • API (ativar definições do OAuth): selecione Ativar definições do OAuth. Em seguida, defina o seguinte:
     1. URL de retorno de chamada: isto só é necessário se quiser que um serviço externo receba a resposta de autorização OAuth (por exemplo, códigos de autorização ou tokens) e execute a validação. Se optar por fornecer uma chamada de retorno, certifique-se de que inclui o prefixo http(s)://.
     2. Âmbitos do OAuth selecionados: selecione:
        • Aceda e faça a gestão dos seus dados (API)
        • Realizar pedidos em seu nome em qualquer altura (refresh_token, offline_access)
   Nota: se estiver a usar a autenticação OAuth, tem de instalar a app associada na sua conta do Salesforce depois de criar o acionador. Para ver detalhes, consulte o artigo Instale a app associada OAuth.
5. Clique em Guardar.
   Nota: a app associada recém-criada não funciona durante os 2 a 10 minutos iniciais após a criação.
6. Clique em Continuar. Tem de voltar a autorizar com um código de validação enviado para o seu endereço de email.
7. Após a validação bem-sucedida do código, é apresentado um segredo do consumidor e uma chave do consumidor na página seguinte. Tome nota destes valores, uma vez que vão ser usados quando configurar o módulo de autorização para a integração de aplicações.
8. Clique no botão Gerir.
9. Na página Detalhes da app associada, clique no botão Editar políticas.
10. Na secção Políticas OAuth, altere o valor no menu pendente Utilizadores permitidos para Os utilizadores aprovados pelo administrador estão pré-autorizados.
11. Clique em Guardar.
12. Desloque a página até à secção Perfis e Conjuntos de autorizações para selecionar o perfil ou o conjunto de autorizações que quer aplicar à app associada.
    Pode selecionar um perfil ou um conjunto de autorizações, ou uma combinação de ambos, o que permite que os utilizadores com o perfil ou o conjunto de autorizações correto acedam à app associada.
13. Selecione o perfil ou o conjunto de autorizações pretendido.
14. Clique em Guardar.

Passos pré-requisitos para usar eventos de CDC

Antes de configurar o acionador da integração de aplicações para usar eventos de CDC, certifique-se de que adiciona um objeto configurado ao CDC no Salesforce:

1. Inicie sessão no Salesforce como sysadmin.
2. Clique no ícone de roda dentada e, de seguida, em Configuração.
3. No painel de navegação do lado esquerdo, pesquise e selecione Captura de dados de alterações.
4. Na página de configuração da Captura de dados de alterações, localize o objeto do Salesforce que quer usar na coluna Entidades disponíveis e arraste-o para a coluna Entidades selecionadas.
   Nota: pode selecionar um máximo de 5 objetos por licença do Salesforce para o CDC. Contacte o seu representante do Salesforce para obter mais informações e opções de licenciamento.
5. Clique em Guardar.

Passos previamente necessários para usar eventos de plataforma

Antes de configurar o acionador de integração de aplicações para usar eventos da plataforma, conclua os seguintes passos no Salesforce:

• Crie um evento de plataforma
• Atualize as autorizações para o evento de plataforma

Crie um evento de plataforma

Para criar um evento de plataforma, siga estes passos:

1. Inicie sessão na sua instância do Salesforce com as suas credenciais do sysadmin.
2. Clique no ícone de roda dentada e, de seguida, selecione Configuração.
3. No painel de navegação, pesquise Plataforma e, de seguida, clique em Eventos de plataforma.

4. Na página Eventos de plataforma, clique em Novo evento de plataforma e defina as seguintes propriedades:

• Etiqueta
• Etiqueta no plural
• Nome do objeto(este campo é preenchido automaticamente)
• Publish Behavior Selecione um dos seguintes valores:
  • Publicar após confirmação: reverte o streaming de eventos se não for cumprida uma condição.
  • Publicar imediatamente: aciona instantaneamente o evento, sem aguardar qualquer validação.
  Para mais informações sobre o comportamento de publicação, consulte Eventos de plataforma e transações.
• Estado de implementação (opcional): selecione Implementado se o evento estiver pronto para implementação.

Clique em Guardar.

Crie campos personalizados. Para criar os campos personalizados, clique em Novo na secção Campos personalizados e relações e selecione o tipo de campo personalizado. Pode criar todos os campos personalizados necessários.

Depois de criar os campos personalizados, na página Eventos da plataforma, repare no valor do campo Nome da API. O nome do objeto termina com _e, o que significa que o objeto é um objeto de evento de plataforma. Para um objeto de CDC, o nome do objeto termina com _c.

Atualize as autorizações para o evento de plataforma

As autorizações definidas têm de ser atualizadas para permitir que o utilizador da integração aceda ao evento de plataforma recém-criado.

Para atualizar as autorizações, siga estes passos:

1. No menu Configuração, clique em Utilizadores > Conjuntos de autorizações.
2. Na página Conjuntos de autorizações, clique na autorização criada anteriormente.
3. Clique em Definições do objeto > Plural Label of the Platform Event.
4. Na secção Autorizações de objetos, ative as autorizações Ler e Criar.
5. Clique em Guardar.

Adicione um acionador do Salesforce

Para adicionar um acionador do Salesforce a uma integração nova ou existente, siga os passos abaixo:

1. Na Google Cloud consola, aceda à página Application Integration.

   Aceda à solução Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.

   Se estiver a criar uma nova integração:

   1. Introduza um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
   3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
      Nota: a opção para selecionar uma conta de serviço é apresentada apenas se tiver ativado a gestão da integração para a região selecionada.
   4. Clique em Criar. A integração recém-criada é aberta no editor de integração.

4. Na barra de navegação do editor de integração, clique em Tasks para ver a lista de tarefas e conetores disponíveis.
5. Selecione uma integração existente ou clique em Criar integração.
6. No editor de integração, clique em + Adicionar uma tarefa/acionador > Acionadores para ver os acionadores disponíveis
7. Clique e coloque o elemento Acionador do Salesforce no criador.

Configure o acionador do Salesforce

Para configurar o acionador do Salesforce, siga estes passos:

1. Clique em Acionador do Salesforce no editor de integração para ver o painel de configuração do acionador.
2. Selecione uma instância do Salesforce no menu pendente Configuração da instância do Salesforce.

   Se não tiver uma instância do Salesforce, crie uma nova. Para mais informações, consulte o artigo Crie uma nova instância do Salesforce.

3. Selecione um canal do Salesforce no menu pendente Configuração do canal do Salesforce.

   Se não tiver um canal do Salesforce, crie um novo. Para mais informações, consulte o artigo Crie um novo canal do Salesforce.

4. Se escolheu o tipo de evento como CDC, selecione qualquer uma das seguintes operações:
   • Create
   • Update
   • Delete
   • Undelete

   O acionador é executado apenas se ocorrer a operação específica ou a operação de lacuna.

   O acionador do Salesforce só pode ser configurado para uma operação. Se quiser executar o acionador para várias operações, crie um acionador do Salesforce para cada operação.

Crie uma nova instância do Salesforce

Para configurar uma nova instância do Salesforce, siga estes passos:

1. Nas propriedades editáveis do acionador, clique em Selecionar uma configuração de instância do Salesforce > + Adicionar nova configuração de instância do Salesforce.
2. Na caixa de diálogo Adicionar configuração da instância do Salesforce, defina as seguintes propriedades:
• Nome da ligação da instância do Salesforce: introduza um nome para a instância.

  Após a configuração, vai usar este nome para se referir à instância do Salesforce.

• Domínio do Salesforce: introduza uma autoridade de serviço para a instância. Pode encontrar o domínio na sua conta do Salesforce. Por exemplo, instance.my.salesforce.com. A imagem seguinte mostra o domínio do Salesforce:

  

• Perfil de autenticação: selecione um perfil de autenticação.

  Se não tiver um perfil de autenticação, crie um novo perfil do tipo de autenticação credenciais de palavra-passe do proprietário do recurso OAuth 2.0. Para obter informações sobre os campos, consulte o artigo Credenciais de palavra-passe do proprietário do recurso do OAuth 2.0. Para a instância do Salesforce, introduza os seguintes valores:

  • ID do cliente: introduza a chave do consumidor que anotou quando configurou uma app associada.
  • Segredo: introduza o segredo do consumidor que anotou quando configurou uma app associada.
  • Palavra-passe: introduza a palavra-passe do utilizador no formato USER_PASSWORDSECURITY_TOKEN. Substitua o seguinte:
    • USER_PASSWORD: a palavra-passe do utilizador do Salesforce.
    • SECURITY_TOKEN: o token de segurança que definiu para a sua integração.
    Por exemplo, se o seu USER_PASSWORD for test-password e o SECURITY_TOKEN for 737K27NCa3O6, a sua palavra-passe será test-password737K27NCa3O6.

A imagem seguinte mostra os campos necessários para criar um perfil de autenticação:



• ID da organização do Salesforce: introduza o ID da organização da instância do Salesforce. Pode obter o ID junto do administrador do Salesforce.
3. Clique em Adicionar.

Crie um novo canal do Salesforce

Para configurar um novo canal do Salesforce, siga estes passos:

1. Nas propriedades editáveis do acionador, clique em Selecionar uma configuração do canal do Salesforce > + Adicionar nova configuração do canal do Salesforce.
2. Na caixa de diálogo Adicionar configuração do canal do Salesforce, introduza o nome do objeto para a propriedade Nome do objeto do Salesforce.

   Para ver a lista de objetos do Salesforce, consulte o artigo Objetos padrão no Salesforce. Se não tiver a certeza do nome do objeto, contacte o administrador do Salesforce.

3. Clique em Adicionar.

Instale a app associada OAuth 2.0

Como parte de uma melhoria de segurança, o Salesforce requer agora que todas as apps associadas que usam a autenticação OAuth 2.0 sejam instaladas. Isto aplica-se a acionadores novos e existentes. Esta alteração significa que o seu acionador existente pode deixar de funcionar, a menos que a app associada esteja instalada no Salesforce. Navegue para a página Utilização do OAuth de apps associadas na sua conta do Salesforce e instale a app. Para mais informações, consulte o artigo Alteração das restrições de utilização de apps associadas.

Variáveis de saída

A resposta do acionador do Salesforce está disponível nas variáveis de saída.

As variáveis de saída de um evento CDC estão descritas na tabela seguinte:

Variável	Tipo de dados	Descrição
SalesforceTriggerCdcPayload	JSON	Detalhes do evento de alteração.
SalesforceTriggerEvent	JSON	Contém replayId do evento.
SalesforceTriggerSchema	String	Esquema de acionador.
SalesforceTriggerCdcSnapshot	JSON	Instantâneo do objeto após o evento de alteração. Este campo só está disponível para operações Update e Create.
SalesforceTriggerCdcRecordId	String	Contém o recordId do registo atualizado ou adicionado. O recordId é um identificador do objeto do Salesforce alterado.

As variáveis de saída de um evento Plataforma estão descritas na tabela seguinte:

Variável	Tipo de dados	Descrição
SalesforceTriggerPEPayload	JSON	Detalhes do evento de alteração.
SalesforceTriggerEvent	JSON	Contém replayId do evento.
SalesforceTriggerSchema	String	Esquema de acionador.

O parâmetro de saída para este acionador é a variável JSON CdcTriggerPayload. A variável JSON contém objetos de registo atualizados.

Práticas recomendadas

A utilização do acionador do Salesforce é recomendada nos casos em que quer usar notificações do Salesforce para acionar integrações sem escrever código personalizado para publicar eventos do Salesforce. Qualquer pequena alteração de campo no seu registo do Salesforce vai acionar um evento do CDC do Salesforce e, por conseguinte, acionar uma integração, o que pode resultar num ruído de integração significativo. Considere usar Filtros de eventos de alteração para filtrar apenas os eventos de CDC necessários que acionam a integração. A utilização de filtros de eventos de alteração pode ajudar a reduzir o ruído de integração e garantir a conformidade com as limitações da sua licença.

Da mesma forma, recomendamos que anule a publicação de qualquer integração que use este acionador quando a integração já não for necessária. Até ser anulada a publicação ou eliminada, a integração continua a ouvir eventos da plataforma e CDC do Salesforce.

Considerações

Antes de usar o acionador do Salesforce para executar a integração, considere o seguinte:

• O Salesforce envia um máximo de 100 mil eventos de CDC e de plataforma por dia. Se comprar mais capacidade de eventos de plataforma à Salesforce, pode publicar mais de 10 milhões de eventos por dia. Para mais informações, consulte o artigo Atribuição de eventos de plataforma. Contacte o administrador do Salesforce para compreender as restrições da sua licença antes de escolher eventos de CDC para o acionador de integração.
  Nota: várias integrações que usam o mesmo canal do Salesforce não duplicam o consumo da sua quota do Salesforce.
• Se estiver a planear carregamentos em massa para o Salesforce, considere pausar a CDC para reduzir o ruído da integração e garantir a conformidade com as limitações da sua licença.
• O tamanho máximo da mensagem de evento que o Salesforce pode publicar é de 1 MB. Para mais informações, consulte o artigo Altere as atribuições de captura de dados de alterações.
• A integração de aplicações não suporta eventos da CDC do Salesforce para as seguintes regiões:
  • asia-northeast1
  • asia-south1
  • australia-southeast1
  • europe-west2
  • europe-west3
  • europe-west6
  • northamerica-northeast1
  • southamerica-east1
  • us-east4
  • us-west2

Exclusões do SLA

O acionador do Salesforce depende do produto Salesforce. Como esta dependência é externa à Application Integration, os termos e as condições do contrato de nível de serviço (SLA) da Application Integration aplicam-se apenas quando o acionador do Salesforce inicia com êxito a execução de uma integração do active.

Preços

O acionador do Cloud Pub/Sub e o acionador do Salesforce não requerem a criação de um conetor. No entanto, se usar a tarefa Connectors para estabelecer ligação ao Pub/Sub ou ao Salesforce, a utilização do conetor é faturada. Para ver informações sobre preços, consulte a secção Preços da integração de aplicações.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

O que se segue?

• Saiba mais sobre todas as tarefas e acionadores.
• Saiba como testar e publicar uma integração.
• Saiba mais acerca do processamento de erros.
• Saiba mais sobre os registos de execução da integração.