Ce que fait ce branchement
Chaque mise en relation livrée est créée en projet chez OGGO Data, dès la livraison. Vous réglez le flux une fois, et vos mises en relation 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 commande 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 mises en relation YACI 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 commande. 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 prospects concernés. Vous pouvez ensuite envoyer un prospect 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 commande 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 mise en relation livrée.
Sous De quoi ce flux s'occupe, vous gardez toutes les commandes, ou vous restreignez à certaines verticales, ou à certaines commandes. Choisir des verticales embarque aussi les commandes créées plus tard sur ces verticales ; choisir des commandes 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 commandes 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 commandes portent réellement. Une ligne chiffre le résultat : « … champs remplis automatiquement depuis vos commandes. 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.
La mise en relation envoyée est fictive, jamais un de vos prospects : ses coordonnées sont injoignables, et personne ne sera dérangé. Elle 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 de la mise en relation utilisée, et la liste des champs absents de cette mise en relation. 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 la prochaine mise en relation livrée 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 commande en France ou en Outre-mer. » : aucune de vos commandes 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 commandes. Passez en Avancé et désignez leur source.
- « Aucune mise en relation livrée pour l'instant : il n'y a rien à essayer. » : l'essai a besoin d'au moins une mise en relation livrée. Voir Ma commande est active mais ne reçoit aucune mise en relation.
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'une mise en relation dans le flux, avec pour chacun la date, la mise en relation, 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.