Módulos do Marketo

Em um cenário do Adobe Workfront Fusion, é possível automatizar fluxos de trabalho que usam Marketo, bem como conectá-lo a vários aplicativos e serviços de terceiros.

Para obter um vídeo de introdução ao conector do Marketo, consulte:

Para obter instruções sobre como criar um cenário, consulte os artigos em Criar cenários: índice do artigo.

Para obter informações sobre módulos, consulte os artigos em Módulos: índice do artigo.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso da funcionalidade neste artigo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront

Qualquer pacote de fluxo de trabalho do Adobe Workfront e qualquer pacote do Adobe Workfront Automation and Integration

Workfront Ultimate

Os pacotes Workfront Prime e Select, com uma compra adicional do Workfront Fusion.

Licenças do Adobe Workfront

Padrão

Trabalho ou maior

Licença do Adobe Workfront Fusion

Baseado em operação: nenhum requisito de licença do Workfront Fusion

Baseado em conector (legado): Workfront Fusion for Work Automation and Integration

Produto Se sua organização tiver um pacote Workfront Select ou Prime, ele não inclui o Workfront Automation and Integration. É necessário comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações contidas nesta tabela, consulte Requisitos de acesso na documentação.

Para obter informações sobre licenças do Adobe Workfront Fusion, consulte Licenças do Adobe Workfront Fusion.

Pré-requisitos

Para usar módulos Marketo, você deve ter uma conta do Marketo.

Informações da API do Marketo

O conector do Marketo usa o seguinte:

Versão da API
v1
Tag da API
v1.14.19

Conectar o Marketo ao Workfront Fusion connect-marketo-to-workfront-fusion

Você pode criar uma conexão com sua conta do Marketo diretamente de dentro de qualquer módulo do Marketo.

  1. Em qualquer módulo do Marketo, clique em Adicionar ao lado do campo Conexão.

  2. Preencha os seguintes campos:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection name Insira um nome para a nova conexão.
    Environment Selecione se estão se conectando a um ambiente de produção ou não produção.
    Type Selecione se você está se conectando a uma conta de serviço ou a uma conta pessoal.
    Account / Munchkin ID Insira sua conta do Marketo ou a ID do Munchkin do Marketo. Esta é a parte exclusiva do URL de base ou do ponto de acesso atribuído à sua conta, que você usa para acessar o Marketo por meio da API REST correspondente. Para obter instruções sobre como localizar isso, consulte [Base URL](https://developers.marketo.com/rest-api/base-url/) na documentação do Marketo.
    Client ID Insira sua ID de cliente do Marketo. Para obter instruções sobre como localizar isso, consulte [Authentication](https://developers.marketo.com/rest-api/authentication/) na documentação do Marketo.
    Client Secret Insira o Segredo do cliente do Marketo. Para obter instruções sobre como localizar esses itens, consulte [Authentication](https://developers.marketo.com/rest-api/authentication/) na documentação do Marketo.
  3. Clique em Continuar para criar a conexão e voltar para o módulo.

Módulos do Marketo e seus campos

Ao configurar os módulos do Marketo, o Workfront Fusion exibe os campos listados a seguir. Junto com eles, outros campos do Marketo podem ser exibidos, dependendo de fatores como seu nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.

Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro.

Botão de alternância Mapear

Acionadores

Monitorar eventos (instantâneos)

Este módulo de acionador inicia um cenário quando um registro é criado ou atualizado.

Webhook

Insira o webhook que você deseja que o módulo use.

Para obter mais informações sobre webhooks, consulte Webhooks.

Limit
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.

Monitorar registros

Este módulo de acionador inicia um cenário quando um registro é criado ou atualizado.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
Record Type

Selecione o tipo de registro que deseja criar.

  • Activity

    Selecione o tipo de atividade que você deseja monitorar.

    O módulo monitora somente novas atividades.

  • Lead

    No campo Tipo de evento, selecione se deseja monitorar novos registros, registros atualizados, ambos ou atualizações em campos específicos. Se você optar por monitorar atualizações em campos específicos, selecione o campo que deseja que o módulo monitore.

  • Program

    No campo Tipo de evento, selecione se deseja monitorar novos registros, registros atualizados ou ambos.

Outputs
Selecione os campos que deseja incluir no pacote de saída deste módulo.
Limit
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.

Ações

Adicionar leads a uma lista

Este módulo de ação adiciona um ou mais leads a uma lista usando a ID do lead. Você pode adicionar até 300 leads por vez.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
List ID
Insira ou mapeie a ID da lista em que você deseja adicionar leads.
Lead IDs

Para cada lead que você deseja adicionar à lista, clique em Add e, em seguida, insira ou mapeie a ID do lead que deseja adicionar. Você pode adicionar até 300 leads para o módulo que deseja adicionar à lista.

Clique no botão de alternância Mapear para mapear uma coleção existente de leads que deseja adicionar à lista.

Clonar um programa

Este módulo de ação faz uma cópia de um programa usando a ID do programa.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
Existing Program ID
Insira ou mapeie a ID do programa que você deseja copiar.
New Program Name
Insira ou mapeie um nome para o novo programa
Folder ID
Insira ou mapeie a ID da pasta em que deseja que o novo programa esteja localizado.

Criar um registro

Este módulo de ação cria um novo registro no Marketo

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
Record Type

Selecione o tipo de registro que deseja criar.

  • Company

  • Folder

  • Lead

  • Program

Select fields to map
Se você estiver criando uma Empresa ou um Lead, selecione os campos para os quais deseja definir valores quando o novo registro for criado e, em seguida, insira valores para esses campos.
Program Type
Se você estiver criando um Programa, selecione o tipo de programa que deseja criar.
Program Channel
Se estiver criando um Programa, selecione o canal no qual deseja criá-lo.
Folder/Program Name
Se você estiver criando uma Pasta ou um Programa, insira ou mapeie um nome para o novo registro.
Description
Se você estiver criando uma Pasta ou um Programa, insira ou mapeie uma descrição para o novo registro.
Parent Folder ID
Se você estiver criando uma pasta ou um programa, insira ou mapeie a ID da pasta pai na qual deseja criar o novo registro.
Costs
Se você estiver criando um programa, adicione os custos.
Tags
Se estiver criando um Programa, adicione tags

Chamada de API personalizada

Este módulo de ação permite fazer uma chamada autenticada personalizada para a API do Marketo. Dessa forma, você pode criar uma automação de fluxo de dados que não pode ser realizada pelos outros módulos do Marketo.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
URL
Insira um caminho relativo a https://{your-base-url}.mktorest.com/.
Method
Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP.
Headers

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.

Por exemplo, {"Content-type":"application/json"}

O Workfront Fusion adiciona os cabeçalhos de autorização para você.

Query String

Adicione a consulta para a chamada de API na forma de um objeto JSON padrão.

Por exemplo: {"name":"something-urgent"}

Fields
Para cada campo que você deseja adicionar à chamada de API, clique em Adicionar item e insira a chave e o valor do campo.

Baixar um arquivo

Este módulo de ação baixa um arquivo usando sua ID.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
File ID
Insira ou mapeie a ID do arquivo que deseja baixar.

Ler um registro

Este módulo de ação lê as informações sobre um registro usando sua ID.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
Record Type

Selecione o tipo de registro que deseja criar.

  • Campaign

  • Company

  • Lead

  • List

  • Program

Outputs
Selecione as informações que deseja incluir no pacote de saída deste módulo. Os campos estão disponíveis com base no Record Type selecionado.
<Object> ID
Insira ou mapeie a ID do objeto sobre o qual deseja recuperar informações.

Remover leads de uma lista

Este módulo de ação remove um ou mais leads de uma lista usando a ID do lead. Você pode restaurar até 300 leads por vez.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
List ID
Insira ou mapeie a ID da lista em que deseja remover leads.
Lead IDs

Para cada lead que você deseja remover da lista, clique em Add item e, em seguida, insira ou mapeie a ID do lead que deseja remover. Você pode adicionar até 300 leads do módulo para remover da lista.

Clique no botão Mapear para mapear uma coleção de leads que deseja remover da lista.

Agendar uma campanha

Este módulo de ação agenda uma campanha para uma determinada data.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
Campaign ID
Insira ou mapeie a ID da campanha que você deseja agendar.
Schedule for Date
Selecione a data em que deseja que a campanha seja executada. Se esse campo ficar em branco, a campanha será executada cinco minutos após o início do cenário.

Atualizar um registro

Este módulo de ação atualiza um registro usando sua ID.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
Record Type

Selecione o tipo de registro que deseja criar.

  • Company

  • Lead

  • Program

Company/Lead/Program ID
Insira ou mapeie a ID do registro que deseja atualizar.
Select fields to map
Se você estiver atualizando uma empresa ou um lead, selecione os campos que deseja atualizar e insira os valores.
Program Name
Se você estiver atualizando um programa, insira ou mapeie um novo nome para o programa.
Description
Se você estiver atualizando um programa, insira ou mapeie uma nova descrição para o programa.
Start Date
Se você estiver atualizando um programa, insira ou mapeie uma nova data inicial para o programa.
End Date
Se você estiver atualizando um programa, insira ou mapeie uma nova data final para ele.
Costs
Se você estiver atualizando um programa, adicione os custos.
Tags
Se você estiver atualizando um programa, adicione tags

Fazer upload de um arquivo

Este módulo de ação faz upload de um novo arquivo para o Marketo.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
Source file
Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.
Folder ID
Insira ou mapeie a ID da pasta na qual deseja que o novo arquivo esteja localizado.
Description
Insira uma descrição para o arquivo enviado.

Pesquisas

Listar registros

Este módulo de ação recupera todos os registros de um tipo específico.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
Record Type

Selecione o tipo de registro que deseja listar.

  • Read all campaigns

  • Read all programs

  • Read all leads

Field
Se você selecionou para recuperar leads, selecione se deseja recuperá-los de uma lista ou de um programa.
Outputs
Selecione as informações que deseja incluir no pacote de saída deste módulo. Os campos estão disponíveis com base no Record Type selecionado.
Limit
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.

Pesquisar registros

Este módulo de pesquisa recupera uma lista de registros que correspondem a critérios de pesquisa específicos.

Connection
Para obter instruções sobre como conectar sua conta do Marketo ao Workfront Fusion, consulte Conectar Marketo ao Workfront Fusion neste artigo.
Record type

Selecione o tipo de ambiente que deseja pesquisar.

  • Campaigns

  • Leads

  • Programs

Field
Selecione o campo pelo qual deseja pesquisar.
Value / values
Insira o valor do campo que você deseja pesquisar. Se o campo permitir a pesquisa de vários valores, para cada valor que você deseja pesquisar, clique em Add item e insira o valor.
Output
Selecione as informações que deseja incluir no pacote de saída deste módulo.
Limit
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3