Fin for Sales peut se connecter directement à votre compte Marketo et créer un connecteur de données fonctionnel en quelques minutes. Le processus ne nécessite aucune connaissance de l'API, aucun code et aucun mappage de champs manuel.
Choisissez un modèle, connectez Marketo avec vos identifiants API, et notre générateur IA inspecte votre instance Marketo (y compris les champs personnalisés) pour créer un connecteur entièrement configuré. Passez en revue les mappings proposés, ajustez si nécessaire, et ajoutez-le à votre configuration. Fin peut ensuite récupérer le contexte de personnes en direct dans les conversations commerciales et synchroniser les personnes qualifiées vers Marketo.
Ce que vous pouvez faire :
📥 Enrichir la personne (lecture) | 📤 Synchroniser la personne (écriture) |
Fin récupère le contexte des personnes en direct depuis Marketo dans vos conversations commerciales. | Fin synchronise les personnes qualifiées vers Marketo. Il s'agit d'un upsert : il met à jour la personne correspondante si elle existe, ou crée une nouvelle personne dans la partition sélectionnée si elle n'existe pas. |
Remarque : Deux modèles sont disponibles : Enrich person from Marketo (lecture) et Sync conversation data to a Marketo lead (écriture).
Important : configurez Enrich person et Sync person ensemble
Le connecteur Sync Conversation Data (write) est un upsert (il mettra soit à jour une personne Marketo existante soit en créera une nouvelle).
Au début d'une conversation, Fin ne connaît pas l'ID de la personne Marketo. Le connecteur Enrich person (read) est ce qui résout une personne retournante vers son enregistrement Marketo existant (et son ID de lead).
Si vous configurez Sync person sans Enrich person, Fin n'a pas d'ID de personne Marketo stocké et doit se rabattre sur la correspondance par e-mail uniquement (ce qui est plus lent), et échoue totalement si deux personnes dans la partition partagent cet e-mail. Configurez les deux afin que les écritures soient clés sur l'ID de la personne et arrivent sur le bon enregistrement.
Avant de commencer
Marketo n'utilise pas une connexion en un clic, vous aurez donc besoin de quatre valeurs fournies par votre administrateur Marketo avant de commencer :
REST API endpoint et Identity URL : dans Marketo, allez dans Admin > Integration > Web Services. Les deux doivent être des URL HTTPS mktorest.com du même compte (par exemple https://123-ABC-456.mktorest.com/rest et https://123-ABC-456.mktorest.com/identity).
Client ID et Client secret : ouvrez votre service personnalisé sous Admin > Integration > LaunchPoint et cliquez sur View Details.
Comment le configurer
Connectez Marketo à Fin for Sales depuis la section "Connected services" dans Fin AI Agent > Sales > Train > Integrations.
Étape 1 : Connecter Marketo
Entrez votre REST API endpoint, Identity URL, Client ID et Client secret.
Nous vérifions les identifiants auprès de Marketo avant de les enregistrer. Si Marketo les rejette, rien n'est stocké.
Étape 2 : Choisir un modèle
Choisissez Enrich person from Marketo (lecture) ou Sync conversation data to a Marketo lead (écriture). Pour synchroniser les personnes en retour, configurez les deux.
Étape 3 : Choisir une partition de personnes
Choisissez la partition que Fin doit utiliser, afin qu'il lise et écrive le bon enregistrement. Si votre compte n'a qu'une seule partition accessible, elle est sélectionnée pour vous.
Tout ce que Fin fait est limité à cette partition : les personnes en dehors de celle-ci ne sont pas trouvées pendant l'enrichissement, et les nouvelles personnes sont créées à l'intérieur.
Étape 4 : Fournir un e-mail de test
Ceci effectue une recherche réelle dans votre compte Marketo afin que le connecteur puisse être construit et testé sur des données en direct. La personne n'est pas contactée. L'e-mail doit correspondre à une personne qui existe dans la partition que vous avez sélectionnée.
Étape 5 : Laisser l'IA générer le connecteur
Cela prend environ 15 à 30 secondes pendant que l'IA inspecte votre schéma de leads Marketo, effectue une requête de test et assemble le connecteur.
Étape 6 : Examiner les mappings de champs
Vous verrez un tableau de correspondance champ Marketo → attribut Intercom que vous pouvez modifier avant de confirmer. Les champs Marketo qui ne correspondent pas aux attributs Intercom existants sont automatiquement mappés vers de nouveaux attributs préfixés mkto_.
La mise en correspondance de l'ID de la personne Marketo est gérée par Fin et ne peut pas être modifiée ou supprimée. C'est la clé que Fin utilise pour mettre à jour le bon enregistrement en toute sécurité.
Étape 7 : Ajoutez-le à votre configuration
Connecteur de lecture : ajoutez-le à l'enrichissement - il s'exécute au début de chaque conversation.
Connecteur d'écriture : attachez-le à un résultat de routage - il se déclenche lorsque ce résultat est atteint.
Remarque :
La synchronisation est un upsert : Sync person met à jour la personne Marketo correspondante, ou en crée une dans la partition sélectionnée lorsqu'aucune n'existe. Associez-le à Enrich person afin que Fin puisse reconnaître les personnes revenantes de manière fiable.
Portée de la partition : Fin lit et écrit uniquement dans la partition que vous avez sélectionnée. Changez-la et la nouvelle partition s'appliquera à partir de la conversation suivante.
Actualisation automatique : les jetons d'accès Marketo expirent périodiquement ; le connecteur se rafraîchit automatiquement.
Champs personnalisés inclus : Fin lit vos champs personnalisés Marketo lors de la configuration.
Dépannage
Problème | Solution |
"Marketo rejected these credentials" | Vérifiez l'Identity URL, le Client ID et le Client secret, et que le service personnalisé de l'utilisateur API-only est actif. |
"The Marketo API user cannot access any person partitions" | Attribuez au rôle de l'utilisateur API-only l'accès Read-Write Lead dans Marketo, puis reconnectez-vous. |
"No Marketo person with this email exists in the selected partition" | L'e-mail de test ne correspondait pas à une personne dans la partition que vous avez sélectionnée. Vérifiez que l'e-mail existe là-bas, ou sélectionnez la bonne partition. |
"The test Marketo person needs a value in at least one writable field" | L'accès en écriture est vérifié sans modifier les données, donc la personne de test a besoin d'au moins un champ texte rempli. Utilisez un enregistrement de personne plus complet. |
Les personnes en double apparaissent dans Marketo | Sync person n'a pas pu faire correspondre une personne revenante à son enregistrement existant. Assurez-vous que Enrich person est également configuré pour que l'ID de la personne Marketo soit capturé. |
Le connecteur a cessé de fonctionner | Généralement un problème d'authentification Marketo. Le connecteur devrait se rafraîchir automatiquement et réessayer. Si cela persiste, reconnectez Marketo. |
"Reconnect Marketo and select a person partition" | La connexion ou la sélection de partition est manquante. Reconnectez Marketo et choisissez une partition à nouveau. |
Toujours bloqué ? Contactez l'équipe d'assistance pour obtenir de l'aide.