01. Plataforma

02. Destinos

03. Conectores

55PBX

ActiveCampaign

Api4com

Apple App Store

ASAAS

AWS CloudWatch Metrics

Azure Table Storage

BigQuery (conector)

Bitrix24 CRM

Bling!

Blip (Take)

Brasil.io

ClickUp

Clockify

ContaAzul

Criteo

E-goi

EADBOX

Exact Sales

Facebook

Fatura Simples

Freshdesk

FTP

Google Ads (Adwords)

Google Analytics 4 (GA4)

Google Cloud Storage

Google Play Store

Google Search Console (Google Webmasters)

Google Sheets

Granatum

Hi Platform

Hotmart

HubSpot

Huggy

InfluxDB v1.x

Infusionsoft (Keap)

Instagram

Jira

Kondado

Linkedin

Loja Integrada

MailChimp

Mandrill

Meetime

Mercado Livre

Microsoft Advertising

Microsoft SQL Server (conector)

Microsoft SQL Server SSH (conector)

Mixpanel

Monday.com

MongoDB

Movidesk

MySQL (conector)

MySQL SSH (conector)

NectarCRM

Notion

Nuvemshop

Omie

Oracle (conector)

Pagar.me

Pinterest Ads

Pipedrive

Pipefy

PipeRun

Ploomes

PostgreSQL (conector)

Pushwoosh

RD Station

RDStation CRM

Recruiterbox

S3 (conector)

Salesforce

Salesforce Marketing Cloud

SenseData

Shopify

Stilingue

Superlógica

Sympla

Taboola

Tangerino

TikTok Ads

TikTok Orgânico

Tiny ERP

Toggl

Tray

Trello

Twilio

VNDA

VTEX

Wake Commerce (antigo Tray Corp by FBits)

Webhook

Wootric

X Ads

YouTube

Zeeng

Zendesk

Zendesk Chat

Índice de Conectores Kondado

04. API

05. Visualização

06. Central de Ajuda

Salesforce Marketing Cloud

Adicionando o conector

Requisitos

  • Conta ativa no Salesforce Marketing Cloud (antigo ExactTarget).
  • Acesso ao modulo de Installed Packages no SFMC.
  • Permissoes para criar um API Integration > Server-to-Server.

Instrucoes

  1. Acesse a pagina inicial de login do Marketing Cloud (https://mc.exacttarget.com), insira o seu username e clique em Next.
    1. SFMC passo 1
  2. Voce sera redirecionado para a pagina de login especifica da conta do usuario selecionado no passo (1). Copie a URL que sera gerada.
    1. SFMC passo 2
  3. Com a URL em maos, obtenha o subdominio da sua empresa buscando o valor antes de .login. No exemplo do passo (2), esse valor sera mcx1072k138f919oowzqewciw06, obtido de https://mcx1072k138f919oowzqewciw06.login.exacttarget.com.
  4. Guarde o subdominio obtido no passo (3), pois ele sera utilizado para criacao do conector na Kondado.
  5. Continue com o seu login e acesse a plataforma do Salesforce Marketing Cloud.
  6. Uma vez logado, localize o seu usuario a direita da barra superior, clique nele e depois em Setup.
    1. SFMC passo 6
  7. Na pagina de Setup, na barra lateral esquerda, acesse Apps > Installed Packages.
    1. SFMC passo 7
  8. Na pagina de Installed Packages, voce vera a lista de aplicacoes conectadas. Para criar a integracao da Kondado, clique no botao New localizado no topo a direita da listagem.
    1. SFMC passo 8
  9. Apos clicar em New, informe um Nome e uma Descricao (por exemplo, Nome: Kondado; Descricao: kondado.com.br) e clique em Save.
    1. SFMC passo 9
  10. Depois de criar o Installed Package, na aba DETAILS, localize a secao Components e clique no botao Add Component.
    1. SFMC passo 10
  11. No primeiro passo do popup, selecione a opcao API Integration e clique em Next.
    1. SFMC passo 11
  12. No proximo passo, selecione a opcao Server-to-Server e clique em Next.
    1. SFMC passo 12
  13. Em seguida, selecione as permissoes/propriedades da integracao com a Kondado. Marque a categoria Data > Data Extensions como Read e Write e as demais categorias relevantes apenas como Read. Depois de configurar as permissoes, clique em Save.
    1. SFMC passo 13
  14. Apos adicionar o Component, copie os valores de Client Id e Client Secret localizados na aba DETAILS > Components > API Integration.
    1. SFMC passo 14
  15. Na plataforma da Kondado, va para a pagina de Adicionar conectores e selecione o conector Salesforce Marketing Cloud.
  16. Preencha os valores da seguinte forma:
    • Subdominio: o valor obtido no passo (3).
    • Client ID e Client Secret: os valores obtidos no passo (14).
    1. SFMC passo 16

Depois de configurar o conector, clique em SALVAR para iniciar a integracao dos dados do Salesforce Marketing Cloud no seu Data Warehouse.

Integrações

Índice

Gráfico de relacionamento

Clique para ampliar

Data Extension

Tipo de replicacao: Incremental ou Integral (configuravel pelo usuario)

Parametros:

  • Data Extension: Selecione a data extension que deseja integrar

Esta integração pode ser integral ou incremental. Para que ela possa ser incremental, é necessário que: (i) haja uma coluna do tipo timestamp (ou Date para o SFMC) que marque quando o registro foi atualizado ou inserido que seja selecionada para ser enviada para a integração (caso hajam colunas timestamp, mas que não possuam esse comportamento, o ideal é deixar a integração como integral) ; (ii) os registros não sejam deletados da tabela (caso sejam, o ideal é deixar a integração como integral);. Satistifeitas ambas estas condições, você poderá marcar a integração como incremental no último passo ao criar a integração, selecionando também a coluna incremental. A atualização incremental irá sempre fazer a leitura de dados da data do savepoint menos 1 dia para trás

Dados retornados de uma data extension específica do Marketing Cloud.

Campo Tipo

_kdd_rowkey

text

[pt] Chave de replicação gerada para cada linha.

col_x

text

[pt] Valor genérico capturado da data extension (coluna X).

col_y

boolean

[pt] Indicador booleano retornado para a coluna Y da data extension.

col_z

timestamp

[pt] Marca temporal retornada para a coluna Z da data extension.

Emails

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Relacionamentos:

Definições de e-mails armazenados no Marketing Cloud, com metadados de conteúdo, pasta e status.

Campo Tipo

id

text

[pt] Identificador somente leitura do objeto. Alguns objetos usam o ObjectID como ID exclusivo no Marketing Cloud.

status

text

[pt] Define o status do objeto (status do endereço).

name

text

[pt] Nome do objeto ou da propriedade.

customerkey

text

[pt] Identificador exclusivo fornecido pelo usuário para o objeto dentro do tipo. Corresponde à chave externa atribuída ao objeto no Marketing Cloud.

emailtype

text

[pt] Define o tipo de e-mail preferido.

characterset

text

[pt] Informa a codificação usada na mensagem. Valores válidos listados na documentação.

preheader

text

[pt] Texto exibido como preheader da mensagem em dispositivos móveis.

partnerkey

text

[pt] Identificador exclusivo fornecido pelo parceiro para o objeto. Só fica disponível via API.

client__id

text

[pt] Define a conta proprietária e o contexto em que o objeto está.

modifieddate

timestamp

[pt] Indica a última modificação das informações do objeto.

hasdynamicsubjectline

boolean

[pt] Informa se o e-mail usa assunto dinâmico.

createddate

timestamp

[pt] Data e hora de criação do objeto (somente leitura).

contentcheckstatus

text

[pt] Informa se a validação de conteúdo do e-mail foi concluída.

folder

text

[pt] Informa os dados da pasta.

    Folders > > id

ishtmlpaste

boolean

[pt] Informa se o e-mail foi criado colando HTML.

objectid

text

[pt] Identificador textual controlado pelo sistema e somente leitura do objeto.

categoryid

text

[pt] Identificador da pasta que contém o e-mail.

isactive

boolean

[pt] Indica se o objeto está ativo.

subject

text

[pt] Contém informações da área de assunto da mensagem.

Events

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Relacionamentos:

Objeto principal

Eventos de tracking do Marketing Cloud (aberturas, cliques, bounces) por envio e assinante.

Campo Tipo

sendid

text

[pt] Contém o identificador de um envio específico.

    Sends > > id

subscriberkey

text

[pt] Identifica um assinante específico.

    Subscribers > > subscriberkey

eventtype

text

[pt] Tipo do evento de tracking.

eventdate

timestamp

[pt] Data em que o evento de tracking ocorreu.

url

text

[pt] URL envolvida no evento ou configuração.

partnerkey

text

[pt] Identificador exclusivo fornecido pelo parceiro para o objeto. Só fica disponível via API.

client__id

text

[pt] Define a conta proprietária e o contexto em que o objeto está.

correlationid

text

[pt] Correlaciona objetos entre múltiplas requisições.

objectid

text

[pt] Identificador textual controlado pelo sistema e somente leitura do objeto.

batchid

text

[pt] Relaciona o envio disparado a outros eventos (cliques, aberturas etc. que ocorram depois).

triggeredsenddefinitionobjectid

text

[pt] Identifica a definição de triggered send vinculada ao evento, permitindo associar eventos de tracking ao disparo específico.

marketingcloud_events__PartnerProperties

Metadados adicionais do parceiro associados a cada evento de tracking.

Campo Tipo

sendid

text

[pt] Identificador do envio associado ao evento.

subscriberkey

text

[pt] Chave do assinante envolvido no evento.

eventtype

text

[pt] Tipo do evento registrado (open, click, bounce etc.).

eventdate

timestamp

[pt] Data e hora em que o evento foi registrado (UTC).

partnerproperties__name

text

[pt] Nome do registro de metadados fornecido pelo cliente e armazenado pelo sistema.

partnerproperties__value

text

[pt] Valor do registro de metadados fornecido pelo cliente e armazenado pelo sistema.

Folders

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Estrutura de pastas do Marketing Cloud com metadados e permissões de hierarquia.

Campo Tipo

id

text

[pt] Identificador somente leitura do objeto. Alguns objetos usam o ObjectID como ID exclusivo no Marketing Cloud.

name

text

[pt] Nome do objeto ou da propriedade.

allowchildren

boolean

[pt] Indica se a pasta de dados pode ter subpastas.

partnerkey

text

[pt] Identificador exclusivo fornecido pelo parceiro para o objeto. Só fica disponível via API.

client__enterpriseid

text

[pt] Identificador exclusivo fornecido pelo parceiro para o objeto. Só fica disponível via API.

client__modifiedby

text

[pt] Identificador do usuário que realizou a última alteração.

client__id

text

[pt] Identificador da conta ou unidade de negócio proprietária do registro.

client__createdby

text

[pt] Identificador do usuário que criou o registro.

iseditable

boolean

[pt] Informa se a propriedade pode ser editada pelo usuário final no profile center.

contenttype

text

[pt] Define o tipo de conteúdo armazenado na pasta.

description

text

[pt] Descrição com informações adicionais sobre o objeto.

customerkey

text

[pt] Identificador exclusivo fornecido pelo usuário para o objeto dentro do tipo, correspondente à chave externa atribuída no Marketing Cloud.

parentfolder__partnerkey

text

[pt] Partner key da pasta pai.

parentfolder__contenttype

text

[pt] Tipo de conteúdo atribuído à pasta pai.

parentfolder__description

text

[pt] Descrição cadastrada para a pasta pai.

parentfolder__customerkey

text

[pt] Customer key (chave externa) da pasta pai.

parentfolder__name

text

[pt] Nome da pasta pai.

parentfolder__iseditable

boolean

[pt] Indica se a pasta pai pode ser editada.

parentfolder__objectid

text

[pt] ObjectID da pasta pai.

parentfolder__id

text

[pt] ID numérico da pasta pai.

parentfolder__isactive

boolean

[pt] Informa se a pasta pai está ativa.

parentfolder__allowchildren

boolean

[pt] Indica se a pasta pai aceita subpastas.

modifieddate

timestamp

[pt] Indica a última modificação das informações do objeto.

createddate

timestamp

[pt] Data e hora de criação do objeto (somente leitura).

objectid

text

[pt] Identificador textual controlado pelo sistema e somente leitura do objeto.

isactive

boolean

[pt] Indica se o objeto está ativo.

List Sends

Tipo de replicacao: Integral

Relacionamentos:

Métricas de envios de e-mail por lista, incluindo entregas, bounces e exclusões.

Campo Tipo

list__id

text

[pt] ID da lista associada ao objeto.

    Lists > > id

sendid

text

[pt] Contém o identificador de um envio específico.

forwardedemails

float

[pt] Número de e-mails encaminhados no envio.

existingunsubscribes

float

[pt] Informa se houve descadastros no envio anterior.

unsubscribes

float

[pt] Quantidade de descadastros vinculados ao envio.

uniqueopens

float

[pt] Quantidade de aberturas únicas geradas pelo triggered send.

uniqueclicks

float

[pt] Quantidade de cliques únicos na mensagem.

objectid

text

[pt] Identificador textual controlado pelo sistema e somente leitura do objeto.

duplicates

float

[pt] Quantidade de endereços de e-mail duplicados associados ao envio (ocorre apenas quando o envio abrange múltiplas listas).

list__listname

text

[pt] Nome da lista associada ao objeto.

list__objectid

text

[pt] ObjectID da lista associada ao objeto.

list__partnerkey

text

[pt] PartnerKey da lista associada ao objeto.

existingundeliverables

float

[pt] Informa se houve bounces no envio anterior.

otherbounces

float

[pt] Quantidade de bounces do tipo Other no envio.

partnerkey

text

[pt] Identificador exclusivo fornecido pelo parceiro para o objeto. Só fica disponível via API.

client__id

text

[pt] Define a conta proprietária e o contexto em que o objeto está.

previewurl

text

[pt] URL usada para pré-visualizar a mensagem do envio.

numberdelivered

float

[pt] Número de e-mails enviados que não sofreram bounce.

invalidaddresses

float

[pt] Quantidade de endereços inválidos associados ao envio.

softbounces

float

[pt] Quantidade de soft bounces associados ao envio.

numbersent

float

[pt] Total de e-mails efetivamente enviados no disparo (inclui mensagens que podem ter sofrido bounce).

missingaddresses

float

[pt] Quantidade de endereços ausentes identificados no envio.

hardbounces

float

[pt] Quantidade de hard bounces associados ao envio.

List Subscribers

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Relacionamentos:

Objeto principal

Assinantes vinculados às listas, com status e chaves de referência por lista.

Campo Tipo

id

text

[pt] Identificador somente leitura do objeto. Alguns objetos usam o ObjectID como ID exclusivo no Marketing Cloud.

status

text

[pt] Define o status do endereço do assinante. Valores válidos: Active, Bounced, Held, Unsubscribed, Deleted.

listid

text

[pt] Identificador da lista na qual o assinante está inscrito.

    Lists > > id

partnerkey

text

[pt] Identificador exclusivo fornecido pelo parceiro para o objeto. Só fica disponível via API.

client__id

text

[pt] Define a conta proprietária e o contexto em que o objeto está.

modifieddate

timestamp

[pt] Indica a última modificação das informações do objeto.

objectid

text

[pt] Identificador textual controlado pelo sistema e somente leitura do objeto.

createddate

timestamp

[pt] Data e hora de criação do objeto (somente leitura).

subscriberkey

text

[pt] Identifica um assinante específico.

    Subscribers > > subscriberkey

marketingcloud_listsubscribers__PartnerProperties

Metadados do parceiro associados aos registros de assinantes por lista.

Campo Tipo

id

text

[pt] Identificador do registro de propriedades do parceiro.

partnerproperties__name

text

[pt] Nome do registro de metadados fornecido pelo cliente e armazenado pelo sistema.

partnerproperties__value

text

[pt] Valor do registro de metadados fornecido pelo cliente e armazenado pelo sistema.

Lists

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Listas do Marketing Cloud com metadados, chaves externas e status de envio.

Campo Tipo

id

text

[pt] Identificador somente leitura do objeto. Alguns objetos usam o ObjectID como ID exclusivo no Marketing Cloud.

category

text

[pt] ID da pasta onde o item está localizado.

listclassification

text

[pt] Classificação da lista. Valores válidos: ExactTargetList, PublicationList, SuppressionList.

partnerkey

text

[pt] Identificador exclusivo fornecido pelo parceiro para o objeto. Só fica disponível via API.

client__id

text

[pt] Define a conta proprietária e o contexto em que o objeto está.

type

text

[pt] Tipo da lista (Public, Private, Salesforce, GlobalUnsubscribe ou Master) e o tipo de e-mail usado para os endereços (Text ou HTML).

listname

text

[pt] Nome da lista.

description

text

[pt] Descrição com informações adicionais sobre o objeto.

customerkey

text

[pt] Identificador exclusivo fornecido pelo usuário para o objeto dentro do tipo, correspondente à chave externa atribuída no Marketing Cloud.

modifieddate

timestamp

[pt] Indica a última modificação das informações do objeto.

createddate

timestamp

[pt] Data e hora de criação do objeto (somente leitura).

objectid

text

[pt] Identificador textual controlado pelo sistema e somente leitura do objeto.

Sends

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Relacionamentos:

Objeto principal

Resumo de desempenho dos envios (sends) com estatísticas agregadas de entrega, bounces e público.

Campo Tipo

id

text

[pt] Identificador somente leitura do objeto. Alguns objetos usam o ObjectID como ID exclusivo no Marketing Cloud.

status

text

[pt] Define o status do objeto (status do endereço).

unsubscribes

float

[pt] Quantidade de descadastros vinculados ao envio.

uniqueopens

float

[pt] Quantidade de aberturas únicas geradas pelo triggered send.

additional

text

[pt] ID do envio utilizado como identificador de campanha pelos clientes.

numbererrored

float

[pt] Quantidade de e-mails não enviados por erro na montagem da mensagem.

subject

text

[pt] Contém informações da área de assunto da mensagem.

fromname

text

[pt] Nome padrão exibido no campo From (obsoleto para definições de envio e triggered sends).

isalwayson

boolean

[pt] Informa se a solicitação pode ser executada durante modo de manutenção. true significa que o sistema processa o pedido mesmo nesse estado.

previewurl

text

[pt] URL usada para pré-visualizar a mensagem do envio.

partnerkey

text

[pt] Identificador exclusivo fornecido pelo parceiro para o objeto. Só fica disponível via API.

client__id

text

[pt] Define a conta proprietária e o contexto em que o objeto está.

numberdelivered

float

[pt] Número de e-mails enviados que não sofreram bounce.

invalidaddresses

float

[pt] Quantidade de endereços inválidos associados ao envio.

ismultipart

boolean

[pt] Indica se o e-mail é enviado com Multipart/MIME habilitado.

missingaddresses

float

[pt] Quantidade de endereços ausentes identificados no envio.

email__partnerkey

text

[pt] Identificador exclusivo fornecido pelo parceiro para o objeto. Só fica disponível via API.

email__id

text

[pt] Endereço de e-mail padrão do objeto, indicando se os dados do assinante podem ser usados nos envios.

    Emails > > id

email__objectid

text

[pt] ObjectID do e-mail associado ao envio.

forwardedemails

float

[pt] Número de e-mails encaminhados no envio.

existingunsubscribes

float

[pt] Informa se houve descadastros no envio anterior.

otherbounces

float

[pt] Quantidade de bounces do tipo Other no envio.

numbersent

float

[pt] Total de e-mails efetivamente enviados no disparo (inclui mensagens que podem ter sofrido bounce).

senddate

timestamp

[pt] Data em que o envio ocorreu (horário CST).

objectid

text

[pt] Identificador textual controlado pelo sistema e somente leitura do objeto.

duplicates

float

[pt] Quantidade de endereços de e-mail duplicados associados ao envio (ocorre apenas quando o envio abrange múltiplas listas).

uniqueclicks

float

[pt] Quantidade de cliques únicos na mensagem.

existingundeliverables

float

[pt] Informa se houve bounces no envio anterior.

hardbounces

float

[pt] Quantidade de hard bounces associados ao envio.

emailname

text

[pt] Nome da mensagem de e-mail associada ao envio.

modifieddate

timestamp

[pt] Indica a última modificação das informações do objeto.

createddate

timestamp

[pt] Data e hora de criação do objeto (somente leitura).

softbounces

float

[pt] Quantidade de soft bounces associados ao envio.

numbertargeted

float

[pt] Quantidade de destinatários possíveis para o envio, desconsiderando cancelados ou excluídos da lista/data extension.

fromaddress

text

[pt] Endereço From associado ao objeto (obsoleto para definições de envio e triggered sends).

numberexcluded

float

[pt] Quantidade de destinatários excluídos do envio por estarem held, unsubscribed, master unsubscribed ou global unsubscribed.

marketingcloud_sends__PartnerProperties

Metadados adicionais do parceiro armazenados para registros de envio.

Campo Tipo

id

text

[pt] Identificador do registro de propriedades do parceiro.

partnerproperties__name

text

[pt] Nome do registro de metadados fornecido pelo cliente e armazenado pelo sistema.

partnerproperties__value

text

[pt] Valor do registro de metadados fornecido pelo cliente e armazenado pelo sistema.

Subscribers

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

  • Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
  • Data inicial de leitura (Savepoint): A partir de qual data os dados serão lidos

Objeto principal

Assinantes do Marketing Cloud com identificação, status e preferências de entrega.

Campo Tipo

id

text

[pt] Identificador somente leitura do objeto. Alguns objetos usam o ObjectID como ID exclusivo no Marketing Cloud.

client__id

text

[pt] Define a conta proprietária e o contexto em que o objeto está.

partnerkey

text

[pt] Identificador exclusivo fornecido pelo parceiro para o objeto. Só fica disponível via API.

createddate

timestamp

[pt] Data e hora de criação do objeto.

objectid

text

[pt] Identificador textual controlado pelo sistema e somente leitura do objeto.

emailaddress

text

[pt] Contém o endereço de e-mail do assinante e indica que o campo da data extension armazena esse tipo de dado.

subscriberkey

text

[pt] Identifica um assinante específico.

status

text

[pt] Define o status do objeto (status do endereço).

emailtypepreference

text

[pt] Formato utilizado ao enviar e-mails ao assinante. Valores válidos: HTML ou Text.

marketingcloud_subscribers__attributes

Atributos personalizados vinculados a cada assinante do Marketing Cloud.

Campo Tipo

subscriber_id

text

[pt] Identificador do assinante ao qual o atributo pertence.

name

text

[pt] Lista os atributos associados ao objeto.

value

text

[pt] Valor do atributo associado ao objeto.

Notas

 

  • Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas