# Marketo

O conector **Marketo** integra-se à [plataforma de automação de marketing Marketo](https://developer.adobe.com/marketo-apis/api/mapi/), permitindo que você gerencie leads, campanhas e dados de atividades em seus pipelines. Você pode criar ou atualizar leads, adicioná-los a campanhas ou listas e obter registros de atividades para auxiliar no gerenciamento automatizado de leads, execução de campanhas e geração de relatórios.

## **Parâmetros**

Configure o conector usando os parâmetros abaixo. Os campos que suportam [expressões Double Braces](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/double-braces) são marcados na coluna Suporta DB.

{% tabs fullWidth="true" %}
{% tab title="General" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo</th><th>Suporta DB</th><th>Padrão</th></tr></thead><tbody><tr><td><strong>Alias</strong></td><td>Nome (alias) para a saída deste conector, permitindo que você faça referência a ele posteriormente no fluxo usando expressões <a href="../../double-braces">Double Braces</a>.</td><td>String</td><td>❌</td><td>marketo-1</td></tr><tr><td><strong>Account</strong></td><td>A <a href="https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/platform-administration/settings/accounts">conta</a> usada pelo conector. Tipo suportado: <strong>OAuth Provider</strong>.</td><td>Account</td><td>❌</td><td></td></tr><tr><td><strong>Enhanced Marketo authentication retry</strong></td><td>Se ativado, o conector solicita um novo token de acesso, acionando uma nova tentativa para respostas HTTP 401 e erros específicos do Marketo 601 ou 602 (incluindo casos em que um HTTP 200 é retornado com <code>success: false</code>)</td><td>Boolean</td><td>❌</td><td>False</td></tr><tr><td><strong>Fail On Error</strong></td><td>Se a opção for ativada, a execução do pipeline com erro será interrompida. Caso contrário, a execução do pipeline continua, mas o resultado mostrará um valor falso para a propriedade <code>"success"</code>.</td><td>Booleano</td><td>❌</td><td></td></tr></tbody></table>

{% endtab %}

{% tab title="API" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo </th><th>Suporta DB</th><th>Padrão</th></tr></thead><tbody><tr><td><strong>BaseURL</strong></td><td>As APIs disponíveis para este conector.</td><td>String</td><td>✅</td><td>N/A</td></tr><tr><td><strong>Path</strong></td><td>O endpoint específico do Mailgun a ser acessado. O caminho selecionado pode determinar opções adicionais de configuração, como parâmetros de consulta. Para detalhes sobre cada endpoint, <a href="https://developer.adobe.com/marketo-apis/api/mapi/">consulte a documentação do Marketo</a>.</td><td>String</td><td>❌</td><td>N/A</td></tr><tr><td><strong>Method</strong></td><td>O método HTTP usado para a solicitação.</td><td>String</td><td>❌</td><td>N/A</td></tr></tbody></table>

{% endtab %}

{% tab title="Settings" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo</th><th>Suporta DB</th><th>Padrão</th></tr></thead><tbody><tr><td><strong>Connect Timeout (ms)</strong></td><td>Tempo máximo permitido para estabelecer uma conexão, em milissegundos.</td><td>Integer</td><td>❌</td><td>30000</td></tr><tr><td><strong>Read Timeout (ms)</strong></td><td>Tempo máximo permitido para ler dados, em milissegundos.</td><td>Integer</td><td>❌</td><td>30000</td></tr><tr><td><strong>Stop on Client Error</strong></td><td>Quando ativado, interrompe a execução do pipeline se ocorrer um erro HTTP 4xx.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Stop on Server Error</strong></td><td>Quando ativado, interrompe a execução do pipeline se ocorrer um erro HTTP 5xx.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Override Response Charset</strong></td><td>Quando ativado, substitui o charset retornado pelo endpoint especificado na propriedade Response Charset. Caso contrário, o charset do cabeçalho Content-Type é usado.</td><td>Boolean</td><td>❌</td><td>True</td></tr><tr><td><strong>Response Charset</strong></td><td>Define o charset a ser utilizado quando <strong>Override Response Charset</strong> estiver ativado. Padrão: UTF-8.</td><td>String</td><td>❌</td><td>UTF-8</td></tr><tr><td><strong>Advanced Settings</strong></td><td>Configurações avançadas.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Raw Mode</strong></td><td>Se ativada, a opção recebe ou passa um payload que não é JSON.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Raw Mode As Base64</strong></td><td>Quando ativada, a opção mostra o retorno como base64.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Save As Local File</strong></td><td>Quando ativada, a opção salva o retorno como um arquivo no diretório local do pipeline.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Response File Name</strong></td><td>Nome do arquivo ou caminho completo do arquivo (por exemplo, <code>tmp/processed/file.txt</code>). Este parâmetro suporta Double Braces, mas a referência a informações de conta não é permitida.</td><td>String</td><td>✅</td><td>N/A</td></tr><tr><td><strong>Allow Insecure Endpoints</strong></td><td>Quando ativada, a opção permite que chamadas a endpoints HTTPS não seguros sejam realizadas.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Enable Retries</strong></td><td>Quando ativada, a opção permite que sejam feitas novas tentativas.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Number Of Retries</strong></td><td>Número máximo de tentativas antes de desistir da chamada.</td><td>Inteiro</td><td>❌</td><td>0</td></tr><tr><td><strong>Time To Wait Between Retries</strong></td><td>Tempo máximo entre tentativas (em milissegundos).</td><td>Inteiro</td><td>❌</td><td>0</td></tr><tr><td><strong>Compress Body With GZIP</strong></td><td>Quando ativada, a opção permite que o body seja comprimido com GZIP.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Force HTTP 1.1</strong></td><td>Quando ativada, a opção força a solicitação a ser executada utilizando HTTP 1.1.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Disable Connection Pooling</strong></td><td>Quando ativada, a opção não mantém as conexões em um pool. O seu uso é recomendado para endpoints que apresentam problemas de compatibilidade quando conexões são reutilizadas.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Invalidate SSL Sessions on Every Call</strong></td><td>Quando ativada, a opção invalida sessões SSL em todas as chamadas.</td><td>Booleano</td><td>❌</td><td>False</td></tr></tbody></table>
{% endtab %}

{% tab title="Documentation" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo </th><th>Suporta DB</th><th>Padrão</th></tr></thead><tbody><tr><td><strong>Documentation</strong></td><td>Campo opcional para descrever a configuração do conector e quaisquer regras de negócio relevantes.</td><td>String</td><td>❌</td><td>N/A</td></tr></tbody></table>

{% endtab %}
{% endtabs %}

## Gerenciamento de APIs de Ativos (Asset API)

O conector Marketo suporta o gerenciamento de ativos ao expor os serviços da API de Ativos do Marketo, especificamente Pastas (Folders) e Programas (Programs). Esses recursos são essenciais para organizar, criar e gerenciar estruturas de marketing diretamente pela plataforma.

### Pastas (Folders)

Utilizadas para gerenciar a estrutura de diretórios dentro do Marketo.

<table data-full-width="true"><thead><tr><th>Tipo de operação</th><th>Ações suportadas</th></tr></thead><tbody><tr><td>Read (GET)</td><td><ul><li>Get Folder by ID</li><li>Get Folder by Name</li><li>Get Folder Content</li><li>Browse Folders</li></ul></td></tr><tr><td>Write (POST)</td><td><ul><li>Create Folder</li><li>Update Folder</li><li>Delete Folder</li></ul></td></tr></tbody></table>

### Programas (Programs)

Programas são iniciativas de marketing específicas (como webinars ou campanhas de e-mail).

<table data-full-width="true"><thead><tr><th>Tipo de operação</th><th>Ações suportadas</th></tr></thead><tbody><tr><td>Read (GET)</td><td><ul><li>Get Program by ID/Name</li><li>List by Tag</li><li>Get Smart List by Program ID</li><li>Browse Programs.</li></ul></td></tr><tr><td>Write (POST)</td><td><ul><li>Create</li><li>Update</li><li>Clone</li><li>Delete</li><li>Approve</li><li>Unapprove</li></ul></td></tr></tbody></table>

## **Exemplos de uso**

### **Filtrar leads**

Use o conector para filtrar um ou mais leads que correspondam a um tipo de filtro específico, como e-mail.

* **Account**: [Conta do tipo OAuth provider](https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/platform-administration/settings/accounts#tipos-de-contas) configurada com credenciais do Marketo.
* **APIs**: `https://066-ACM-164.mktorest.com`
* **Path**: `/rest/v1/leads.json`
* **Method**: `GET`
* **Query {filterType}:** `id`
* **Query {filterValues}**: `63538`

**Exemplo de resposta:**&#x20;

```json
{
  "status": 200,
  "statusMessage": "200",
  "body": {
    "requestId": "c85#199298cf93d",
    "result": [
      {
        "id": 63538,
        "firstName": "John",
        "lastName": "Smith",
        "email": "johnsmith.teste6@example.com",
        "updatedAt": "2025-09-08T13:38:47Z",
        "createdAt": "2025-09-06T01:42:01Z"
      }
    ],
    "success": true
  },
  "headers": {
    "Connection": "keep-alive",
    "Content-Length": "228",
    "Content-Type": "application/json;charset=UTF-8",
    "Date": "Mon, 08 Sep 2025 13:38:48 GMT",
    "Server": "nginx"
  }
}

```
