Marketo

Saiba mais sobre o conector Marketo Engage Rest API e como usá-lo na Digibee Integration Platform.

O conector Marketo Engage Rest API integra-se à plataforma de automação de marketing Marketo, 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

Dê uma olhada nos parâmetros de configuração do conector. Parâmetros suportados por expressões Double Braces estão marcados com (DB).

Aba General

Parâmetro	Descrição	Valor padrão	Tipo de dado
Account	A conta usada pelo conector. Tipo suportado: OAuth Provider.	N/A	Account
Fail On Error	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 "success".	False	Booleano

Aba API

Parâmetro	Descrição	Valor padrão	Tipo d dado
APIs (DB)	As APIs disponíveis para este conector.	N/A	String
Path	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, consulte a documentação do Marketo.	N/A	String
Method	O método HTTP usado para a solicitação.	N/A	String

Aba Settings

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

Aba Documentation

Parâmetro	Descrição	Valor padrão	Tipo de dado
Documentation	Campo opcional para descrever a configuração do conector e quaisquer regras de negócio relevantes.	N/A	String

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 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:

{
  "status": 200,
  "statusMessage": "200",
  "body": {
    "requestId": "c85#199298cf93d",
    "result": [
      {
        "id": 63538,
        "firstName": "John",
        "lastName": "Smith",
        "email": "[email protected]",
        "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"
  }
}