Configurar o spoke do Salesforce Marketing Cloud

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 6 min. de leitura

    • Integre a instância [ ServiceNow e Salesforce Marketing Cloud usando Salesforce Marketing Cloud credenciais para autenticar ServiceNow solicitações.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • Ative o spoke do Salesforce Marketing Cloud.
    • Salesforce Marketing Cloud função necessária: usuário administrador com privilégios para criar novos usuários e funções
    • Função necessária: administrador

    Procedimento

    1. Opcional: Como usar a autenticação básica para o spoke do Salesforce Marketing Cloud
    2. Opcional: Como usar o OAuth 2.0 para spoke do Salesforce Marketing Cloud

    Como usar a autenticação básica para o spoke do Salesforce Marketing Cloud

    Você pode usar a autenticação básica para validar a instância de solicitações da ServiceNow com o spoke do Salesforce Marketing Cloud.

    Criar um usuário para acessar a Salesforce Marketing Cloud SOAP API

    Crie um usuário com o qual você possa acessar a Salesforce Marketing Cloud SOAP API. A SOAP API permite que você recupere registros de suas extensões de dados Salesforce Marketing Cloud e obtenha informações sobre seus usuários Salesforce Marketing Cloud.

    Antes de Iniciar

    Função necessária: usuário administrador do Salesforce com privilégios para criar novos usuários e funções.

    Procedimento

    1. Em um navegador da Web, acesse sua instância Salesforce Marketing Cloud.
    2. Faça login usando suas credenciais de administrador.
    3. No cabeçalho da página da sua instância, clique no ícone do seu perfil e selecione Configuração.
      A página Configuração é aberta.
    4. Crie um usuário Salesforce Marketing Cloud.
      1. Navegar até Administração > Usuários > Usuários e clique em Criar.
        O formulário Novo usuário é aberto.
      2. Na seção de formulário Configurações gerais, preencha os campos.
        Tabela 1. Configurações gerais
        Campo Descrição
        Nome Nome do usuário.
        Endereço de e-mail de resposta Endereço de e-mail do qual você deseja enviar e responder a mensagens de e-mail. Salesforce Marketing Cloud também envia solicitações de senhas esquecidas para este endereço de e-mail.

        Depois de inserir um endereço de e-mail, clique em Verificar para verificar o endereço de e-mail.
        Adicionar ao menu suspenso Nome de origem Opção para enviar o endereço de e-mail de resposta por meio de um processo de verificação de domínio antes que o endereço de e-mail seja preenchido em um e-mail.
        Endereço de E-mail da Notificação Endereço de e-mail para o qual você deseja enviar Salesforce Marketing Cloud notificações.
        Nome de usuário Nome de usuário do usuário.
        Chave Externa Chave que identifica exclusivamente o usuário durante as chamadas de API.
        Fuso horário Fuso horário em que o usuário está localizado.
        Código de cultura Idioma usado na interface do usuário Salesforce Marketing Cloud para este usuário.
        Usuário da API Opção que indica se o usuário pode acessar as Salesforce Marketing Cloud APIs. Marque a caixa de seleção para habilitar esta opção.
        Senha Temporária Senha temporária com a qual o usuário pode fazer login pela primeira vez. O usuário é solicitado a mudar esta senha no primeiro login.
        Verificar senha Campo para verificar a senha temporária.
      3. Clique em Salvar.
    5. Crie uma função de usuário que permita que usuários atribuídos acessem a Salesforce Marketing Cloud SOAP API e também gerenciem usuários e extensões de dados.
      1. Navegar até Administração > Usuários > Funções e clique em Criar.
        O formulário Nova função é aberto.
      2. Na seção de formulário Propriedades, preencha os campos.
        Tabela 2. Propriedades
        Campo Descrição
        Nome Nome da função do usuário.
        Chave Externa Chave que identifica exclusivamente a função do usuário.
        Descrição Descrição da função do usuário.
      3. Na seção de formulário Permissões, expanda o E-mail > Assinantes > Extensão de data categoria de permissão e marque a caixa de seleção Permitir para as permissões de acesso Exibir e Gerenciar dados.
      4. Expandir o E-mail > Administrador > Acesso à API categoria de permissão e marque a caixa de seleção Permitir para a permissão de acesso da API WebService.
      5. Expandir o Administração > Usuários categoria de permissão e marque a caixa de seleção Permitir para as seguintes permissões de acesso:
        • Exibição
        • Atualizar
        • Desativar
        • Gerenciar unidades de negócios
      6. Clique em Salvar.
    6. Atribua a função do usuário ao usuário Salesforce Marketing Cloud.
      1. Navegar até Administração > Usuários > Usuários.
      2. Na lista de usuários disponíveis, marque a caixa de seleção do usuário que você criou na etapa 4.
      3. Clique em Gerenciar funções.
        O formulário Funções do usuário selecionado é aberto.
      4. Na seção de formulário Funções, clique em Editar funções.
      5. Quando a lista de funções disponíveis for exibida, marque a caixa de seleção da função do usuário que você criou na etapa 5.
      6. Clique em Salvar.

    Criar uma conexão e credencial para Salesforce Marketing Cloud

    Crie uma conexão e credencial para Salesforce Marketing Cloud para que você possa conectar sua instância ServiceNow com a API SOAP Salesforce Marketing Cloud.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Em sua instância ServiceNow, navegue até Conexões e Credenciais > Aliases de conexão e credencial.
    2. Na lista de aliases de conexão e credencial disponíveis, selecione SalesforceMarketingCloud.
    3. No formulário Aliases de conexão e credencial, clique no link relacionado Criar nova conexão e credencial.
      A caixa de diálogo Criar conexão e credencial é aberta.
    4. Na caixa de diálogo, preencha os campos.
      Tabela 3. Caixa de diálogo Criar conexão e credencial
      Campo Descrição
      Insira as Informações de Conexão
      Nome da conexão O nome da conexão.
      URL de conexão SOAP URL do endpoint SOAPConnection. Insira https://<subdomain>.soap.marketingcloudapis.com/Service.asmx, em que <subdomain> é o seu subdomínio Salesforce Marketing Cloud.
      Insira as Informações de Credencial
      Nome do perfil de nome de usuário Nome das suas credenciais.
      Nome de usuário Nome de usuário do usuário com o qual você pode acessar a Salesforce Marketing Cloud SOAP API. Insira o nome de usuário do usuário que você criou em Criar um usuário para acessar a Salesforce Marketing Cloud SOAP API.
      Senha Senha do usuário com o qual você pode acessar a Salesforce Marketing Cloud SOAP API. Insira a senha do usuário que você criou em Criar um usuário para acessar a Salesforce Marketing Cloud SOAP API.
    5. Clique em Criar.

    Como usar o OAuth 2.0 para spoke do Salesforce Marketing Cloud

    Você pode usar o OAuth 2.0 para validar a instância de solicitações da ServiceNow com o spoke do Salesforce Marketing Cloud.

    Criar credenciais OAuth 2.0 para o spoke do Salesforce Marketing Cloud

    Crie Salesforce Marketing Cloud credenciais OAuth 2.0 para usar o spoke do Salesforce Marketing Cloud.

    Antes de Iniciar

    Função necessária: administrador do Salesforce Marketing Cloud

    Procedimento

    1. Faça login no locatário Salesforce Marketing Cloud.
    2. Navegar até Página inicial de configuração > Ferramentas da plataforma > Apps > Pacotes instalados.
    3. Selecione Novo para criar um pacote.
    4. Selecione Adicionar componente.
    5. Selecione Integração de API para integrar Salesforce Marketing Cloud APIs à sua aplicação.
    6. Selecione Avançar.
    7. Selecione Servidor para servidor como o tipo de integração.
    8. Selecione Avançar.
    9. Selecione os escopos necessários para sua integração.
    10. Selecione Salvar.
      Sua ID de cliente e segredo do cliente são exibidos no resumo da configuração. Navegue até a seção Componentes em CONFIGURAÇÃO > PACOtes INSTALADOS > DETAILS para exibir o ID e o segredo do cliente. Copie os valores para usá-los mais tarde.

    Criar uma conexão e credencial para o spoke do Salesforce Marketing Cloud

    Crie uma conexão e credencial para autorização OAuth 2.0 do spoke do Salesforce Marketing Cloud.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Abra o registro SalesforceMarketingCloudSOAPConnection.
    3. Na guia Links relacionados, clique no link Criar nova conexão e credencial.
    4. No formulário Aliases de conexão e credencial, preencha os campos.
      Campo Descrição
      Nome da conexão Nome de identificação exclusiva da conexão. Por exemplo, Conexão SOAP SFMC.
      URL de conexão SOAP URL do endpoint da conexão SOAP. Insira https://<subdomain> .soap.marketingcloudapis.com/Service.asmx , em que é o seu subdomínio do Salesforce Marketing Cloud.
      ID do cliente OAuth ID de cliente criado para o spoke do Salesforce Marketing Cloud.
      Segredo do cliente OAuth Segredo do cliente criado para o spoke do Salesforce Marketing Cloud.
      URL de redirecionamento do OAuth URL de redirecionamento do OAuth. Deve estar no formato https://<instance-name.service-now.com> /oauth_redirect.do .
      Extensão de dados de contagens de contatos Nome da extensão de dados da qual você deseja recuperar dados do relatório de Contagens de Contatos.
    5. Selecione Criar e obter um Token do OAuth.