Pour utiliser notre logiciel de téléprospection, vous devez posséder une licence d'utilisation ou démarrer votre période d'essai de 15 jours.

Chargement en cours...

API JobPhoning

JobPhoning vous offre la possibilité de synchroniser un fichier de prospection avec votre base de prospect, automatisant ainsi le processus d'importation et d'exportation des prospects sur la plateforme. Vos Téléopérateurs pourront ainsi contacter directement les prospects de votre base et les mettre à jour.

La synchronisation avec une base de données fonctionne de la manière suivante :

  • - Vous devez créer un service web, accessible via une URL, capable d'être appelé par JobPhoning afin de retourner des données formatées suivant la documentation, en prenant en compte les paramètres envoyés.
  • - Une fois paramétré, le service web sera contacté par JobPhoning dès que la plateforme en a besoin (récupération du prochain prospect à appeler, mise à jour des informations d'un prospect déjà récupéré...)

Ci-dessous un schéma résumant le fonctionnement :

Le service web pourra être paramétré pour trois fonctions différentes : La récupération de prospect (Obligatoire), l'utilisation du filtre (optionnel), et la mise à jour de votre base (optionnel). Le détail de ces trois fonctionnalités est présenté ci-dessous.

1. Récupération de prospects (Obligatoire)

La fonction minimale du service web est de retourner des prospects qui seront proposés à vos Téléopérateurs. Un prospect devra être retourné dans un tableau associatif suivant le formatage ci-dessous :

Clé Description Format de la donnée Exemple de données envoyées Obligatoire
idunique Identifiant unique du prospect. Cet identifiant doit n'être attribué qu'a un seul prospect et ne doit jamais changer Chaine de caractères 100001 Oui
nom Nom du prospect Chaine de caractères DOE Non
prenom Prénom du prospect Chaine de caractères John Non
civilite Civilité du prospect Chaine de caractères Mr Non
societe Société du prospect Chaine de caractères ABC construction Non
fonction Fonction dans l'entreprise du prospect Chaine de caractères Commercial Non
activite Activité de l'entreprise Chaine de caractères Rénovation habitat Non
adresse Adresse du prospect Chaine de caractères 1 rue de la gare Non
codepostal Code postal du prospect Chaine de caractères 75000 Non
ville Ville du prospect Chaine de caractères Paris Non
mail Mail du prospect Adresse mail john.doe@abc.com Non
siret Siret de l'entreprise Chaine de caractères 53901642800044 Non
telephone-fixe Téléphone fixe du prospect Numéro de téléphone au format xxxxxxxxx (Sans le 0) 558585858 Non
telephone-portable Téléphone portable du prospect Numéro de téléphone au format xxxxxxxxx (Sans le 0) 695959595 Non
data-[Nom-Colonne] Vous pouvez ajouter vos propres données en plus de celles de JobPhoning. La clé doit ainsi contenir le préfixe "data-", suivi du nom de la colonne désiré Chaine de caractères pour la colonne et la donnée Clé "data-Effectif", avec en donnée "5 employés" Non

Le prospect sera lui-même intégré dans un tableau. Ci-dessous un exemple de données pouvant être envoyés contenant deux prospects, au format JSON :

[{"nom":"DOE","prenom":"John","idunique":"100001","activite":"Renovation habitat","adresse":"1 rue de la gare","civilite":"Mr","codepostal":"7500","ville":"Paris","fonction":"Commercial","mail":"john.doe@abc.com","siret":"53901642800044","societe":"ABC construction","telephone-fixe":"558585858","telephone-portable":"695959595","data-Effectif":"13 employ\u00e9s"},{"nom":"DUPONT","prenom":"Jane","idunique":"100002","activite":"Compatibilit\u00e9","adresse":"2 avenue des lilas","civilite":"Mme","codepostal":"40100","ville":"Dax","fonction":"Comptable","mail":"jane.dupont@gmail.com","siret":"53901642800044","societe":"ABC compta","telephone-fixe":"554545454","telephone-portable":"625252525","data-Effectif":"16 employ\u00e9s"}]

Les prospects devront être retournés en accordance avec les paramètres envoyés. Deux demandes de nature différente, avec des paramètres variables, peuvent ainsi être effectuées :

Demande d'un prospect non appelé

Cette requête a pour objectif de récupérer un (et un seul) prospect qui n'a jamais été appelé afin qu'il soit traité par un Téléopérateur. Le prospect retourné devra avoir été filtré préalablement par vos soins selon les différents paramètres envoyés (correspondance avec les villes, activités, etc). Cette requête ne devra jamais retourner deux fois un même prospect. Un prospect livré par cette requête devra alors systématiquement être retiré des prospects pouvant être envoyés.

Paramètre Description Format de la donnée Exemple de donnée Valeur
requete Description de la requête effectué Chaine de caractères prospectsuivant
filtre_ville Tableau de villes Tableau de chaines de caractères ["Paris", "Dax"] Variable
filtre_codepostal Tableau de code postaux Tableau de chaines de caractères ["75100", "40100"] Variable
filtre_civilite Tableau de civilités Tableau de chaines de caractères ["Mr", "Mme"] Variable
filtre_nom Tableau de noms Tableau de chaines de caractères ["DOE", "DUPONT"] Variable
filtre_prenom Tableau de prénoms Tableau de chaines de caractères ["John", "Jane"] Variable
filtre_societe Tableau de sociétés Tableau de chaines de caractères ["ABC construction", "ABC compta"] Variable
filtre_activite Tableau d'activités Tableau de chaines de caractères ["Renovation habitat", "Compatibilité"] Variable
filtre_adresse Tableau d'adresses Tableau de chaines de caractères ["1 rue de la gare", "2 avenue des lilas"] Variable
filtre_telephonefixe Tableau de téléphones fixe Tableau de numéros de téléphone (sans le 0) ["558585858", "554545454"] Variable
filtre_telephoneportable Tableau de téléphones portable Tableau de numéros de téléphone (sans le 0) ["695959595", "625252525"] Variable
filtre_mail Tableau de mails Tableau de chaines de caractères ["john.doe@abc.com", "jane.dupont@gmail.com"] Variable
filtre_siret Tableau de sirets Tableau de chaines de caractères ["53901642800044"] Variable
filtre_data-[Colonne] Un tableau contenant des valeurs associés à une colonne personnalisé Tableau de chaines de caractères Clé "filtre_data-Effectif" : ["14 employes","20 employes"] Variable
test TRUE si la requête effectuée s'est faite dans le cadre d'un test lors du paramètrage de la synchronisation, FALSE si elle a été déclenchée pour une utilisation réelle Booléen FALSE Variable
filtre_fonction Tableau des fonctions Tableau de chaines de caractères ["Assistant", "Secrétaire"] Variable
filtre_modealeatoire Quand le mode aléatoire est activé, le prospect suivant ne doit pas être retourné selon l'ordre des prospects du fichier de prospection, mais de façon aléatoire Booléean FALSE Variable
filtre_fixeobligatoire Détermine si le prospect retourné doit obligatoirement avoir un téléphone fixe ou non Booléean FALSE Variable
filtre_portableobligatoire Détermine si le prospect retourné doit obligatoirement avoir un téléphone portable ou non Booléean FALSE Variable

Mise à jour d'un prospect

Cette requête a pour objectif de récupérer un ou plusieurs prospects ayant déjà été envoyés par la requête du "Prospect suivant" afin de mettre à jour ses données. Votre service web doit retourner le ou les prospects correspondant aux identifiants envoyés en paramètre.

Paramètre Description Format de la donnée Exemple de donnée Valeur
requete Description de la requête effectué Chaine de caractères demandeprospect
iduniquetargetarray Tableau d'identifiant unique de prospects à retourner Tableau de chaines de caractères ["10000", "100001"] Variable
test TRUE si la requête effectuée s'est faite dans le cadre d'un test lors du paramètrage de la synchronisation, FALSE si elle a été déclenchée pour une utilisation réelle Booléen FALSE Variable

2. Filtre du fichier de prospection (Optionnel)

Pour qu'un Téléopérateur puisse filtrer votre base de données pour récupérer les prospects qui l’intéresse, JobPhoning doit être en mesure de lui proposer une liste des valeurs disponibles dans celle-ci. L'objectif de cette requête est ainsi de récupérer une liste des valeurs disponibles pour une catégorie précise (ville, activité...).

Paramètre Description Format de la donnée Valeur
requete Description de la requête effectué Chaine de caractères listefiltre
filtre Type de filtre demandé Chaines de caractère Voir liste
test TRUE si la requête effectuée s'est faite dans le cadre d'un test lors du paramètrage de la synchronisation, FALSE si elle a été déclenchée pour une utilisation réelle Booléen Variable

Le paramètre filtre pourra ainsi contenir les valeurs suivantes :

Valeur du paramètre filtre Données attendus en retour Exemple de données envoyés
ville Tableau de villes ["Paris", "Dax", "Lyon"]
codepostal Tableau de code postaux ["7500", "40100", "64100"]
civilite Tableau des différentes civilités ["Mr", "Mme", "Mlle", "Monsieur"]
nom Tableau de noms ["DUPONT", "MARTIN", "PETIT"]
prenom Tableau de prénoms ["John", "Alexandre"]
societe Tableau de societés ["ABC construction", "ABC comptabilité"]
activite Tableau d'activités ["Construction BTP", "Médecin"]
adresse Tableau d'adresses ["1 avenue de la gare", "2 avenue des lilas"]
telephonefixe Tableau de téléphones fixes ["556565656", "954545454"]
telephoneportable Tableau de téléphones portables ["695959595", "684848484"]
mail Tableau de mails ["john.doe@gmail.com", "jane.doe@hotmail.fr"]
siret Tableau de sirets ["53901642800044", "53901642800054"]
data-[colonne] Tableau de valeur de la donnée supplémentaire [colonne] Avec la variable envoyé : "data-Effectif" : ["14 employés", "20 employés"]
fonction Tableau de fonctions ["Secrétaire", "Comptable"]

3. Mise à jour de votre base (Optionnel)

Vous avez la possibilité d'être informé de la mise à jour d'un prospect sur notre plateforme. Vous recevrez ainsi les données à jour et pourrez mettre à jour la fiche du prospect dans votre base.

Paramètre Description Format de la donnée Exemple de donnée Valeur
requete Description de la requête effectué Chaine de caractères miseajourprospect
idunique Identifiant unique du prospect. Cet identifiant doit n'être attribué qu'a un seul prospect et ne doit jamais changer Chaine de caractères 100001 Variable
nom Nom du prospect Chaine de caractères DOE Variable
prenom Prénom du prospect Chaine de caractères John Variable
civilite Civilité du prospect Chaine de caractères Mr Variable
societe Société du prospect Chaine de caractères ABC construction Variable
fonction Fonction dans l'entreprise du prospect Chaine de caractères Commercial Variable
activite Activité de l'entreprise Chaine de caractères Rénovation habitat Variable
adresse Adresse du prospect Chaine de caractères 1 rue de la gare Variable
codepostal Code postal du prospect Chaine de caractères 75000 Variable
ville Ville du prospect Chaine de caractères Paris Variable
mail Mail du prospect Adresse mail john.doe@abc.com Variable
siret Siret de l'entreprise Chaine de caractères 53901642800044 Variable
telephone-fixe Téléphone fixe du prospect Numéro de téléphone au format xxxxxxxxx (sans le 0) 558585858 Variable
telephone-portable Téléphone portable du prospect Numéro de téléphone au format xxxxxxxxx (sans le 0) 695959595 Variable
data-[Nom-Colonne] Vous pouvez ajouter vos propres données en plus de celles de JobPhoning. La clé doit ainsi contenir le préfixe "data-", suivi du nom de la colonne désiré Chaine de caractères pour la colonne et la donnée Clé "data-Effectif", avec en donnée "5 employés" Variable
test TRUE si la requête effectuée s'est faite dans le cadre d'un test lors du paramètrage de la synchronisation, FALSE si elle a été déclenchée pour une utilisation réelle Booléen FALSE Variable
timestampappel Timestamp du dernier appel Timestamp 1545692400 Variable
etatappel État du dernier appel Chaine de caractères Non décroché Variable
teleoperateur Nom d'utilisateur du Téléopérateur ayant passé le dernier appel Chaine de caractères John42 Variable

Points importants

  • - L'interface de paramètrage de la synchronisation, accessible lors de la création d'un fichier de prospection, vous permettra de tester les différentes requêtes avant une mise en production
  • - Selon le nombre de Téléopérateur intervenant sur votre fichier de prospection synchronisé, le service web sera sollicité à de nombreuses reprises. Il est important qu'il soit le plus optimisé possible afin d'obtenir des temps de chargement ne génant pas le travail de vos Téléopérateurs.
  • - Les identifiants uniques des prospects ne doivent pas être changé, sous peine d'avoir une perte de cohérence dans le traitement du fichier de prospection
  • - Une indisponibilité du service web empéchera à vos Téléopérateurs d'avoir accès aux dernières informations à jour des prospects, mais ils pourront tout de même travailler sur les fiches déjà récupérées
  • - JobPhoning met en cache pendant 2 minutes les requêtes effectuées afin de solliciter le moins possible le service web

Support

Si vous avez des questions ou rencontrez un soucis dans le paramètrage de l'API, vous pouvez nous contacter :

2014 - 2024 JobPhoning.com, toute reproduction interdite.
CGU - Mentions légales - Données personnelles - Offres d'emploi