Documentação Experience Platform Guia dos conectores de origem

Criar uma conexão de origem Salesforce Service Cloud usando a API Flow Service

Última atualização: 13 de julho de 2026

Tópicos:
Sources

Criado para:

{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Uma conexão base representa a conexão autenticada entre uma origem e o Adobe Experience Platform.

Leia este tutorial para saber como criar uma conexão base para Salesforce Service Cloud usando a Flow Service API.

Introdução

Este manual necessita de uma compreensão funcional dos seguintes componentes da Adobe Experience Platform:

Fontes: o Experience Platform permite a assimilação de dados de várias fontes, ao mesmo tempo em que fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços do Experience Platform.
Sandboxes: a Experience Platform fornece sandboxes virtuais que particionam uma única instância do Experience Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.

As seções a seguir fornecem informações adicionais que você precisará saber para se conectar com êxito ao Salesforce Service Cloud usando a API Flow Service.

Coletar credenciais necessárias

Leia o guia de autenticação para obter mais informações sobre como recuperar suas credenciais.

Uso de APIs do Experience Platform

Para obter informações sobre como fazer chamadas para APIs do Experience Platform com êxito, consulte o manual sobre introdução às APIs do Experience Platform.

Criar uma conexão básica

Uma conexão base retém informações entre sua origem e a Experience Platform, incluindo as credenciais de autenticação da origem, o estado atual da conexão e a ID de conexão base exclusiva. A ID de conexão básica permite explorar e navegar pelos arquivos de dentro da origem e identificar os itens específicos que deseja assimilar, incluindo informações sobre os tipos de dados e formatos.

Para criar uma ID de conexão base, faça uma solicitação POST para o ponto de extremidade /connections ao fornecer suas credenciais de autenticação Salesforce Service Cloud como parte dos parâmetros de solicitação.

Formato da API

POST /connections

Solicitação

A solicitação a seguir cria uma conexão base para Salesforce Service Cloud usando a Credencial do Cliente OAuth 2:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Salesforce Service Cloud account for ACME data (OAuth2)",
      "description": "Salesforce Service Cloud account for ACME data (OAuth2)",
      "auth": {
          "specName": "OAuth2 Client Credential",
          "params":
            "environmentUrl": "https://acme-enterprise-3126.my.salesforce.com",
            "clientId": "xxxx",
            "clientSecret": "xxxx",
            "apiVersion": "60.0"
        }
      },
      "connectionSpec": {
          "id": "cb66ab34-8619-49cb-96d1-39b37ede86ea",
          "version": "1.0"
      }
  }'

Propriedade

Descrição

auth.params.environmentUrl

A URL da instância Salesforce Service Cloud.

auth.params.clientId

A ID do cliente associada à sua conta do Salesforce Service Cloud.

auth.params.clientSecret

O segredo do cliente associado à sua conta do Salesforce Service Cloud.

auth.params.apiVersion

A versão da API REST da instância Salesforce Service Cloud que você está usando.

connectionSpec.id

A ID da especificação de conexão Salesforce Service Cloud: cb66ab34-8619-49cb-96d1-39b37ede86ea.

Resposta

Uma resposta bem-sucedida retorna a conexão básica recém-criada, juntamente com a ID exclusiva.

{
    "id": "4267c2ab-2104-474f-a7c2-ab2104d74f86",
    "etag": "\"0200f1c5-0000-0200-0000-5e4352bf0000\""
}

Próximas etapas

Seguindo este tutorial, você criou uma conexão de base Salesforce Service Cloud usando a API Flow Service. Você pode usar essa ID de conexão básica nos seguintes tutoriais:

recommendation-more-help

experience-platform-help-sources