Ce que fait ce branchement
Chaque lead livré est créé en projet chez OGGO Data, dès la livraison. Vous réglez le flux une fois, et vos leads arrivent ensuite dans l'outil où vos conseillers travaillent déjà.
Rien n'est envoyé tant que vous n'avez pas activé le flux : vous pouvez tout régler et tout relire d'abord.
Ce qu'il faut avoir sous la main
- Un produit compatible avec OGGO Data dans votre catalogue. Une campagne existante n’est pas nécessaire pour préparer la connexion.
- Une clé publique (consumer key) et un secret (consumer secret), délivrés par OGGO Data.
- Le droit de gérer les intégrations sur votre compte, voir Que peut faire chaque rôle ?.
Ces deux valeurs ne sont pas vos identifiants de connexion à OGGO Data. Votre adresse e-mail et votre mot de passe ne fonctionneront pas ici. Ils sont propres à chaque cabinet : si vous travaillez avec plusieurs cabinets, vous recevrez un jeu d'identifiants par cabinet.
Demandez-les à votre interlocuteur OGGO Data, ou au support de votre cabinet de courtage :
« Je souhaite recevoir mes leads Yacla directement dans OGGO Data. Pouvez-vous me communiquer les identifiants API Fournisseur (consumer key et consumer secret) correspondants ? »
Cette demande est aussi écrite dans l'application : le lien Où trouver mes identifiants ? ouvre la page qui la porte.
Connexion en mode simplifié
Dans Intégration, choisissez OGGO Data. Sélectionnez les produits concernés : vous pouvez préparer la connexion avant votre première campagne. Les produits proposés tiennent compte de la compatibilité avec OGGO Data.
Renseignez votre Clé publique et votre Secret, puis vérifiez le récapitulatif. Le parcours prépare les correspondances pour les produits choisis. Activez la connexion pour envoyer les prochains leads concernés. Vous pouvez ensuite envoyer un lead de test ; ses informations sont affichées pour le retrouver facilement dans OGGO Data.
Configuration en mode expert
Le parcours détaillé ci-dessous permet de régler le déclencheur, les filtres, les étapes et les correspondances dans l’éditeur de flux.
Le chemin, depuis le tableau de bord
1. Ouvrir « Intégration » dans le menu
Dans le menu de gauche, cliquez sur Intégration. L'écran Applications & notifications s'ouvre sur l'onglet Mes intégrations, qui liste vos flux existants.
2. Cliquer la carte « OGGO Data »
Ouvrez l'onglet Catalogue, repérez la carte OGGO Data et cliquez sur Configurer : le constructeur s'ouvre avec l'étape OGGO Data déjà en place.
Une carte grisée porte son motif : « Disponible avec une campagne en France ou en Outre-mer. » Dans ce cas, la destination n'est pas ouverte à votre compte pour l'instant.
3. Régler le déclencheur et son périmètre
Le panneau de droite s'ouvre sur Déclencheur. Temps réel est retenu par défaut : le flux part à chaque lead livré.
Sous De quoi ce flux s'occupe, vous gardez toutes les campagnes, ou vous restreignez à certaines verticales, ou à certaines campagnes. Choisir des verticales embarque aussi les campagnes créées plus tard sur ces verticales ; choisir des campagnes fige la liste. Tant que rien n'est coché, l'écran prévient : « Aucune sélection : rien ne passerait dans ce flux ».
Si votre sélection contient une verticale hors France et Outre-mer, un avertissement la nomme : « OGGO Data ne sert que la France et l'Outre-mer : … n'y sera pas envoyée. »
4. Ouvrir l'étape « OGGO Data »
Au centre de l'écran, cliquez sur le bloc Envoyer vers : OGGO Data. Son panneau porte deux onglets : Réglage et Test.
5. Saisir vos clés d'accès
Sous Clés d'accès, remplissez Clé publique puis Secret, et cliquez sur le bouton Enregistrer placé sous les clés : il enregistre vos identifiants, avant même le flux. La mention « Enregistré » confirme l'enregistrement. Le lien Où trouver mes identifiants ? est juste à côté.
L'écran le rappelle : « Le secret n'est jamais réaffiché ». Il n'en montre ensuite que les quatre derniers caractères. Laissez le champ vide pour le conserver quand vous modifiez autre chose.
Les identifiants sont enregistrés pour votre société, pas pour un flux. Un second flux vers OGGO Data réutilisera les mêmes, et une nouvelle saisie remplace la précédente.
6. Choisir le produit OGGO
La liste Produit OGGO est en deux groupes. Projets détaillés contient les sept projets typés (complémentaire santé, obsèques, GAV, IJH, emprunteur, chiens & chats, auto) qui portent chacun leurs champs propres. Autres marchés contient la cinquantaine de marchés simplifiés, qui partagent le même socle de champs.
Le produit est proposé d'après les campagnes de votre périmètre, et vous restez libre de le changer. C'est lui qui décide des champs attendus : sous le sélecteur, une ligne indique combien de champs le produit compte, et combien sont obligatoires.
Vérifiez bien ce choix : avec un produit qui ne correspond pas, OGGO Data refuse l'envoi.
7. Vérifier la correspondance des champs
Sous Correspondance, deux modes s'offrent à vous : Automatique et Avancé.
Le mode Automatique remplit les champs depuis ce que vos campagnes portent réellement. Une ligne chiffre le résultat : « … champs remplis automatiquement depuis vos campagnes. Rien à régler. » quand tout y est, ou « Obligatoires à compléter en mode avancé : … » quand il manque quelque chose.
Le mode Avancé affiche les champs attendus par OGGO pour le produit choisi, et vous désignez ce qui les remplit. Vous pouvez aussi y traduire des valeurs, ou poser une valeur fixe. Passer en avancé part de la correspondance automatique, jamais d'une page blanche.
En avancé, la liste des champs proposés inclut aussi l'identité du prospect : prénom, nom, adresse, ville, e-mail. Vous pouvez donc désigner explicitement l'un de ces champs pour un champ de contact attendu par OGGO, plutôt que de dépendre du seul mode automatique.
Si vous avez ajouté un nœud Transformer les données au-dessus de cette étape, ses champs produits apparaissent aussi dans la liste : vous pouvez donc désigner, par exemple, un régime déjà converti au code attendu par OGGO.
8. Faire un essai
Ouvrez l'onglet Test, puis cliquez sur Tester. L'essai crée un vrai projet chez OGGO Data, avec la correspondance que vous avez réglée : l'écran vous demande donc une confirmation avant l'envoi.
Le lead envoyé est fictif, jamais un de vos prospects : ses coordonnées sont injoignables, et personne ne sera dérangé. Il répond à toutes les questions de qualification de votre verticale, pour vérifier votre correspondance en conditions réelles. Votre conseiller OGGO le reconnaît facilement : sa note de suivi commence par « ESSAI ». Prévenez-le, ou supprimez ce projet d'essai ensuite.
Le panneau affiche le document exact, l'identifiant du lead utilisé, et la liste des champs absents de ce lead. Un champ absent n'empêche pas l'envoi : la valeur est simplement omise. Un défaut de réglage, lui, est signalé en rouge et doit être corrigé.
9. Activer le flux
Nommez le flux en haut de l'écran (sans nom, il prend celui de sa destination) puis cliquez sur Activer. L'état passe de Brouillon à Actif, et le prochain lead livré dans le périmètre part chez OGGO Data.
Si vos identifiants manquent, l'activation est refusée avec le motif : « Renseignez d'abord vos identifiants OGGO. » Enregistrez-les d'abord, puis réessayez.
Ce qui bloque, et ce que l'écran en dit
- « Disponible avec une campagne en France ou en Outre-mer. » : aucune de vos campagnes n'est sur un territoire servi par OGGO Data.
- « Renseignez vos identifiants OGGO. » : le pied du panneau réclame les clés avant que l'étape soit complète.
- « Renseignez d'abord vos identifiants OGGO. » : l'activation a été refusée pour la même raison.
- « OGGO Data ne sert que la France et l'Outre-mer : … n'y sera pas envoyée. » : une verticale de votre périmètre ne sera pas transmise ; les autres partiront normalement.
- « Obligatoires à compléter en mode avancé : … », des champs obligatoires ne sont alimentés par aucune de vos campagnes. Passez en Avancé et désignez leur source.
- « Aucun lead livré pour l'instant : il n'y a rien à essayer. » : la prévisualisation a besoin d'un vrai lead. Voir Ma campagne est active mais ne reçoit aucun lead.
Vérifier que ça marche
Une fois le flux enregistré, un onglet Historique s'ajoute en haut de l'éditeur. Il liste les soixante dernières exécutions, c'est-à-dire les passages d'un lead dans le flux, avec pour chacun la date, le lead, la destination, l'état et le détail.
Quatre états sont possibles.
- Envoyé : le projet a été créé, et la référence rendue par OGGO Data figure dans le détail.
- Échec : OGGO Data a refusé, et son message est affiché tel quel dans le détail.
- En attente : l'envoi a rencontré un incident passager ; une nouvelle tentative est programmée.
- Ignoré, rien n'a été envoyé, et le détail dit pourquoi : identifiants absents, ou correspondance incomplète avec le nom des champs en cause.
Un refus d'OGGO Data n'est pas renvoyé : corrigez le réglage en cause. Un incident passager est réessayé automatiquement, jusqu'à cinq fois. Le nombre de tentatives s'affiche dans le détail de la ligne.
L'écran Intégration donne la même information en plus court : la ligne de votre flux y porte la date du dernier envoi et un interrupteur pour le mettre en pause.
Mettre en pause, ou arrêter
Désactiver le flux arrête les envois immédiatement. Le journal des livraisons déjà faites reste consultable, et votre réglage est conservé : réactiver ne demande aucune ressaisie.
Supprimer le flux est définitif. Les envois cessent, et le réglage est perdu. Si vous hésitez, mettez en pause plutôt que de supprimer.