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 ne part avant que vous n'ayez activé le flux. Vous pouvez donc tout régler, tout relire, et n'allumer qu'ensuite.
Ce qu'il faut avoir sous la main
- Une campagne en France ou en Outre-mer : hors de ces territoires, la carte OGGO Data reste grisée.
- 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. Les identifiants d'API sont propres à chaque couple fournisseur / cabinet : ils disent à la fois qui envoie les fiches et dans quel cabinet elles atterrissent. Si vous travaillez avec plusieurs cabinets, vous recevrez un jeu 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.
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 montre d'abord ce qui tourne déjà, puis les destinations que vous pouvez brancher.
2. Cliquer la carte « OGGO Data »
Sous le titre Ajouter une intégration, repérez la carte OGGO Data. Toute la carte est cliquable ; elle ouvre le constructeur avec l'étape OGGO Data déjà posée, ce qui vous évite de refaire ce choix.
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.
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. » Il vaut mieux la lire ici que de la découvrir envoi par envoi.
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 Enregistrer. La mention « Enregistré » confirme l'écriture.
Le secret n'est jamais réaffiché. L'écran n'en montre ensuite que les quatre derniers caractères, et laisser le champ vide le conserve : rouvrir le panneau pour changer autre chose n'efface pas votre authentification. La clé publique voyage dans chaque appel et n'a rien de secret ; le secret, lui, ne quitte jamais nos serveurs : il sert à signer les appels, il n'est jamais transmis.
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.
Prenez le temps de ce choix. Le produit détermine l'adresse à laquelle le projet est créé, donc un mauvais produit ne donne pas « le mauvais dossier » : il donne un refus.
7. Vérifier la correspondance des champs
Sous Correspondance, deux modes s'offrent à vous.
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. Ce chiffre est ce qui partira, pas une promesse.
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.
8. Prévisualiser sur un vrai lead
Ouvrez l'onglet Test, puis cliquez sur Tester. Nous construisons ce qui partirait, sur votre dernier lead livré, sans rien envoyer : aucun projet n'est créé chez OGGO Data à cette étape.
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 Journal s'ajoute en haut du constructeur. Il liste les envois récents, 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 de contenu ne se rejoue pas : le renvoyer produirait le même refus. Un incident passager, lui, est réessayé jusqu'à cinq fois, avec un intervalle qui double à chaque tentative. 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.