Fin for Sales pode conectar-se diretamente à sua conta do Marketo e criar um conector de dados funcional em minutos. O processo não requer conhecimento de API, nem código, nem mapeamento manual de campos.
Escolha um modelo, conecte o Marketo com suas credenciais API, e nosso gerador de IA inspeciona sua instância do Marketo (incluindo campos personalizados) para construir um conector totalmente configurado. Reveja os mapeamentos sugeridos, ajuste conforme necessário e adicione à sua configuração. Fin pode então puxar contexto de pessoa em tempo real para conversas de vendas e sincronizar pessoas qualificadas de volta ao Marketo.
O que você pode fazer:
📥 Enriquecer pessoa (leitura) | 📤 Sincronizar pessoa (gravação) |
Fin puxa contexto de pessoa em tempo real do Marketo para suas conversas de vendas. | Fin sincroniza pessoas qualificadas para o Marketo. Isso é um upsert: atualiza a pessoa correspondente se ela existir, ou cria uma nova pessoa na partição selecionada se não existir. |
Nota: Dois modelos estão disponíveis: Enriquecer pessoa do Marketo (leitura) e Sincronizar dados da conversa para um lead do Marketo (gravação).
Importante: Configure Enriquecer pessoa e Sincronizar pessoa juntos
O conector Sync Conversation Data (write) é um upsert (ele atualizará uma pessoa existente no Marketo ou criará uma nova).
No início de uma conversa, Fin não conhece o ID da pessoa no Marketo. O conector Enrich person (read) é o que resolve uma pessoa retornante para seu registro existente no Marketo (e seu ID de lead).
Se você configurar Sync person sem Enrich person, Fin não terá um ID de pessoa do Marketo armazenado e terá que recorrer a corresponder apenas pelo e-mail (o que é mais lento), e falha completamente se duas pessoas na partição compartilharem esse e-mail. Configure ambos para que as gravações sejam chaveadas pelo ID da pessoa e caiam no registro correto.
Antes de começar
O Marketo não usa um login de um clique, então você precisará de quatro valores do administrador do Marketo antes de começar:
REST API endpoint and Identity URL: no Marketo, vá para Admin > Integration > Web Services. Ambos devem ser URLs HTTPS mktorest.com da mesma conta (por exemplo https://123-ABC-456.mktorest.com/rest e https://123-ABC-456.mktorest.com/identity).
Client ID e Client secret: abra seu serviço personalizado em Admin > Integration > LaunchPoint e clique em View Details.
Como configurá-lo
Conecte o Marketo ao Fin for Sales na seção "Connected services" em Fin AI Agent > Sales > Train > Integrations.
Passo 1: Conectar o Marketo
Insira seu REST API endpoint, Identity URL, Client ID e Client secret.
Verificamos as credenciais contra o Marketo antes de salvá-las. Se o Marketo as rejeitar, nada é armazenado.
Passo 2: Escolha um modelo
Escolha Enrich person from Marketo (leitura) ou Sync conversation data to a Marketo lead (gravação). Para sincronizar pessoas de volta, configure ambos.
Passo 3: Escolha uma partição de pessoa
Escolha qual partição o Fin deve usar, para que ele leia e escreva o registro correto. Se sua conta tiver apenas uma partição acessível, ela será selecionada para você.
Tudo que o Fin faz é limitado a essa partição: pessoas fora dela não são encontradas durante o enriquecimento, e novas pessoas são criadas dentro dela.
Passo 4: Forneça um e-mail de teste
Isso executa uma busca real em sua conta do Marketo para que o conector possa ser construído e testado com dados reais. A pessoa não é contatada. O e-mail precisa corresponder a uma pessoa que exista na partição que você selecionou.
Passo 5: Deixe a IA gerar o conector
Isto leva cerca de 15–30 segundos enquanto a IA inspeciona o esquema de leads do Marketo, executa uma solicitação de teste e monta o conector.
Passo 6: Reveja os mapeamentos de campos
Você verá uma tabela de campos do Marketo → mapeamentos de atributos do Intercom que você pode editar antes de confirmar. Campos do Marketo que não correspondem a atributos existentes do Intercom são mapeados automaticamente para novos atributos com prefixo mkto_.
O mapeamento do ID da pessoa do Marketo é gerenciado pelo Fin e não pode ser editado ou removido. É a chave que o Fin usa para atualizar o registro correto com segurança.
Passo 7: Adicione à sua configuração
Read connector: adicione-o ao enriquecimento - ele é executado no início de cada conversa.
Write connector: anexe-o a um resultado de roteamento - ele dispara quando esse resultado é alcançado.
Nota:
Sync is an upsert: Sync person atualiza a pessoa correspondente no Marketo, ou cria uma na partição selecionada quando nenhuma existe. Combine-o com Enrich person para que o Fin possa corresponder pessoas retornantes de forma confiável.
Partition scoped: Fin somente lê e grava dentro da partição que você selecionou. Altere-a e a nova partição será aplicada a partir das próximas conversas.
Auto-refresh: tokens de acesso do Marketo expiram periodicamente; o conector atualiza automaticamente.
Custom fields included: Fin lê seus campos personalizados do Marketo durante a configuração.
Solução de problemas
Problema | Solução |
"Marketo rejected these credentials" | Verifique o Identity URL, Client ID e Client secret, e se o serviço personalizado do usuário apenas-API está ativo. |
"The Marketo API user cannot access any person partitions" | Conceda ao papel do usuário apenas-API acesso Read-Write Lead no Marketo, depois reconecte. |
"No Marketo person with this email exists in the selected partition" | O e-mail de teste não correspondeu a uma pessoa na partição que você selecionou. Verifique se o e-mail existe lá, ou selecione a partição correta. |
"The test Marketo person needs a value in at least one writable field" | O acesso de gravação é verificado sem alterar dados, portanto a pessoa de teste precisa ter pelo menos um campo de texto preenchido. Use um registro de pessoa mais completo. |
Pessoas duplicadas aparecendo no Marketo | Sync person não conseguiu corresponder uma pessoa retornante ao seu registro existente. Garanta que Enrich person também esteja configurado para que o ID da pessoa do Marketo seja capturado. |
Conector parou de funcionar | Geralmente um problema de autenticação do Marketo. O conector deve atualizar automaticamente e tentar novamente. Se persistir, reconecte o Marketo. |
"Reconnect Marketo and select a person partition" | A conexão ou seleção de partição está faltando. Reconecte o Marketo e escolha uma partição novamente. |
Ainda com problemas? Entre em contato com a equipe de suporte para obter assistência.