Migração para a API REST

Última atualização: 5 de maio de 2025

Criado para:

  • Administrador

A API do SOAP Marketo Engage será removida após 31 de outubro de 2025. Todas as integrações existentes que usam a API SOAP devem ser removidas ou migradas para a API REST Marketo Engage até esta data para evitar interrupções no serviço.

Migração

A API do SOAP oferece suporte a uma variedade limitada de casos de uso em comparação ao REST API. Ao determinar quais endpoints mapear seus casos de uso, você deve seguir as Práticas recomendadas de integração do Marketo

Arquiteturas de Referência estão disponíveis para casos de uso de Sincronização de CRM e Exportação de Data Warehouse.

Autenticação

Documentação de Autenticação

A API REST do Marketo usa autenticação baseada no OAuth 2.0 com o tipo de concessão Credenciais de cliente. Os tokens de acesso são válidos por uma hora após a criação.

Leads

Documentação da API de clientes potenciais

A API SOAP oferece suporte à sincronização de dados de clientes potenciais, à associação de cookies do Munchkin e à mesclagem de clientes potenciais. Se o aplicativo chamar o método SOAP syncLead e definir o parâmetro marketoCookie, você poderá migrar:

  1. Usando o método REST Sincronizar clientes em potencial, seguido por Cliente em potencial Associado
  2. Você pode chamar Enviar Formulário, embora isso exija a configuração de alguma Assets de marketing e alguma interação com a API do Forms

Os aplicativos que usam o tipo de chave foreignSysPersonId devem migrar para o uso de um campo de cliente potencial personalizado para representar esse identificador externo e usar os Métodos REST Sincronizar Clientes Potenciais ou Importação de Cliente Potencial em Massa.

Método SOAPMétodo(s) REST
getLeadObter Cliente Potencial por ID, Obter Cliente Potencial por Tipo de Filtro
getMultipleLeadsObter Cliente Potencial por ID, Obter Cliente Potencial por Tipo de Filtro, Obter Cliente Potencial por ID de Programa, Obter Cliente Potencial por ID de Lista, Exportação de Cliente Potencial em Massa
mergeLeadsMesclar clientes em potencial
syncLeadSincronizar Clientes Potenciais Enviar Formulário Associar Cliente Potencial
syncMultipleLeadsClientes Potenciais de Sincronização Importação em Massa

Objetos M

M Objects era um conceito abrangente para oferecer suporte à exportação de dados de Atribuição de oportunidades para análise externa e trabalhou com três tipos de objetos: Oportunidades, Funções de oportunidades e Programas.

Documentação REST:

Método SOAPMétodo(s) REST
excluirMObjectsExcluir Oportunidades, Excluir Funções De Oportunidade
descreverMObjectsDescrever oportunidade, Descrever função da oportunidade
getMObjectsObter Oportunidades, Obter Funções de Oportunidade
listMObjectsN/D
syncMObjectsSincronizar Oportunidades, Sincronizar Funções de Oportunidade
getChannelsObter Canais
getTagsObter Tipos de Marca, Obter Marca por Nome

Listas estáticas

Os casos de uso de lista estática na API SOAP estão limitados à assimilação de dados de associação e de cliente potencial, e à remoção de associação, o que pode ser feito com os Métodos REST Adicionar à lista, Importar clientes potenciais em massa ou Remover da lista.

Método SOAPMétodo(s) REST
getImportToListStatusClientes Potenciais de Importação em Massa
importToListAdicionar À Lista Clientes Potenciais De Importação Em Massa
listOperationRemover da lista

Atividades

A API do SOAP só oferece suporte à recuperação de atividades.

Documentação REST:

Método SOAPMétodo(s) REST
getLeadActivityAtividades de Exportação em Massa Obter Atividades de Cliente Potencial
getLeadChangesAtividades de Exportação em Massa Obter Alterações de Cliente Potencial