Criando ou editando um terminal para o Marketo

Os terminais fornecem as informações de configuração que o Studio e o Integration Appliance usam para se conectar à plataforma do Marketo. O conector Marketo suporta somente o mecanismo de autenticação OAuth, para autorizar usuários a executar operações. O conector Marketo suporta apenas a conexão HTTPS.

Selecionando ou editando um terminal Marketo

  1. Na área de janela Criar terminal ou Editar terminal, configure o terminal Marketo conforme descrito na tabela a seguir.
    Nota: Mudar as propriedades de configuração de um terminal afeta todas as orquestrações que usam esse terminal no projeto. As edições são globais, não locais.
  2. Clique em Conexão de teste para confirmar que os detalhes da conexão são válidos e que você é capaz de se conectar ao Marketo com sucesso.
  3. Clique em OK.
Tabela 1. Propriedades da Conexão
Nome do Campo Descrição
Nome do Host Nome do host para a instância do Marketo (nuvem)
Versão da API Versão da API para a instância do Marketo. Valor padrão: v1
ID do Cliente ID do cliente do OAuth para acessar a instância do Marketo
Segredo do Cliente Segredo do cliente do OAuth para acessar a instância do Marketo

Os parâmetros a seguir são necessários na tela de conexão de teste do terminal para fazer conexão via Proxy:

Nome do Campo Descrição
Nome do host Nome do host da Rede proxy
Porta Número da porta da Rede proxy
Nome do Usuário Nome do usuário para acessar serviço via rede proxy
Senha Senha para acessar serviço via rede proxy
Nota: Na seção Mapear entrada de cada atividade, campos relevantes do painel de terminal estão disponíveis para substituição no tempo de execução. O usuário pode fornecer dados para vários grupos de parâmetros, como Detalhes do proxy, Detalhes de conexão ou Detalhes de autenticação a serem substituídos. Não é permitido substituir o fornecimento apenas de dados de campo parciais em um grupo selecionado.

Objetos suportados pelo conector Marketo

Os objetos a seguir são suportados pelo conector Marketo e pela API disponível para o objeto suportado:

Tabela 2. Operações CRUD
Objetos do Marketo Criar Atualizar Fazer upsert Exclusão Recuperar Todos Retrieve Procura
Líder Sim Sim Sim Sim Sim Sim
Listar Sim Sim Sim
Campanha Sim Sim Sim
Oportunidade Sim Sim Sim Sim Sim
Empresa Sim Sim Sim Sim Sim
Representante de venda Sim Sim Sim Sim Sim
Objeto personalizado Sim Sim Sim Sim Sim
Funções de oportunidade Sim Sim Sim Sim Sim
Atividade Principal Sim
Líderes excluídos Sim
Mudanças de líder Sim
Tipos de atividade Sim
Pasta: Sim Sim Sim Sim Sim Sim
Conteúdo da pasta Sim
Modelo de E-mail Sim Sim Sim Sim Sim Sim
Conteúdo do modelo de e-mail Sim Sim
E-mail Sim Sim Sim Sim Sim Sim
Conteúdo do E-mail Sim Sim
Conteúdo dinâmico do e-mail Sim Sim
Fragmento Sim Sim Sim Sim Sim
Conteúdo do fragmento Sim Sim
Conteúdo dinâmico do fragmento Sim Sim
Arquivo Sim Sim Sim Sim
Segmentação Sim
Segmento Sim

Operações atômicas:

  • Para líderes
    • Mesclar líderes
    • Obter token de paginação
  • Para listas
    • Remover líderes da Lista
    • Incluir líderes na lista
    • Membro da Lista
  • APIs em massa para o líder
    • Importar líderes
    • Obter status de Importar líder
    • Obter arquivo de falha de importação
    • Obter arquivo de aviso de importação
  • Para campanha
    • Planejar campanha
    • Solicitar campanha
  • Para e-mail
    • Atualizar conteúdo do e-mail na seção editável
    • Enviar E-mail de Amostra
  • Para e-mail, modelo de e-mail e fragmento
    • Aprovar objetos
    • Não aprovar objetos
    • Descartar objetos de rascunho
    • Clonar objetos

Suporte a objetos customizados:

O Marketo suporta objetos customizados. O usuário pode definir o objeto customizado somente usando a UI (interface com o usuário) do Marketo. Depois que o objeto customizado é definido, o usuário pode usar o conector para Criar, Atualizar, Fazer upsert, Excluir e Procurar registros de objetos customizados.

Uma vez que o conector usa entrada/saída baseada em XML, somente objetos customizados cujos nomes atenderem aos critérios a seguir serão suportados:
  • Iniciar com alfabeto
  • Conter somente caracteres alfanuméricos
  • Somente caracteres especiais _ (Sublinhado)
Nota: Objetos customizados que não atenderem aos critérios acima não serão listados na lista de objetos para atividades.

Suporte aos campos customizados

O Marketo suporta campos customizados apenas para o objeto Líder e objetos customizados.

Para as atividades Criar e Atualizar, Mapear entradas do objeto líder terá nós adicionais para campos customizados para que o usuário possa fornecer valores para eles.

Para a atividade Recuperar, RetrieveAll e Procurar, o objeto de resposta terá dados de campos customizados, se existirem.

Por exemplo, Mapear entrada/saída do objeto Líder:

 company
 billingStreet
 billingCity
 . .
 customField1
 customField2