🔌 Connecteurs et intégrations
téo peut se connecter à d'autres systèmes pour automatiser des flux et enrichir vos données.
Intégrations disponibles
| Système | Fonction |
|---|---|
| Prest@ppli | Import automatique des prescriptions France Travail (→ France Travail (Prest@ppli)) |
| API téo | Lire vos dossiers et vos séances depuis un autre outil (→ API téo) |
| Lucca | Synchronisation des absences RH dans l'agenda |
| Téléphonie (click-to-call) | Appeler en un clic (fonctionne par défaut) |
| Intégration 3CX / Keyyo | Historisation des appels, remontée de fiche (option payante) |
| Microsoft Teams | Visioconférences |
| Système d'authentification (SSO) | Connexion unifiée |
| Pennylane PA | Envoi des factures électroniques B2B (→ Pennylane PA) |
| France Travail | Vue Règlements France Travail : coller un CSV de règlements (→ Règlements) |
| Chorus Pro | Facturation secteur public |
| RésoVAE | Lien vers la plateforme VAE Nouvelle-Aquitaine |
Prest@ppli
Description
Prest@ppli est un système de prise de rendez-vous utilisé par les prescripteurs (France Travail, Missions locales...). Quand un prescripteur prend un rendez-vous pour un bénéficiaire, les informations arrivent automatiquement dans téo.
Ce qui se passe automatiquement
- Le prescripteur prescrit via Prest@ppli
- téo reçoit la session et la prescription
- Quand le RDV passe Validé, commande créée (France Travail transmet la session au financier), un dossier est créé (ou rattaché s'il est déjà connu)
- Le bénéficiaire est inscrit à la séance téo correspondante
- Le conseiller voit le rendez-vous dans son agenda
Quand Prest@ppli est ouvert dans téo, les prescriptions que la nuit n’a pas importées se traitent dans Production > France Travail > RDV et inscrits (création du dossier, rattachement du RDV à une séance existante). L’import CSV reste disponible.
→ Prescriptions France Travail · Date limite de prescription · Paramétrer le compte
Éviter les dossiers en doublon avec Prest@ppli
téo cherche d’abord le dossier du bénéficiaire déjà présent (créé manuellement ou par un import Excel anticipé) :
- Par N° de commande. Le dossier qui porte ce n° est repris s’il appartient au même bénéficiaire : même N° France Travail (historique) quand le dossier et la prescription en ont un, sinon mêmes nom et prénom (casse et accents ignorés). Une prestation collective porte une seule commande pour tous ses inscrits : chaque inscrit a donc son propre dossier, jamais celui d’un autre.
- Sinon par N° France Travail (historique), parmi les dossiers sans n° de commande du marché.
- Sinon, la personne : même e-mail, nom et prénom, ou même N° France Travail (historique). Des homonymes passent en Doublon détecté et restent à trancher à l’écran RDV et inscrits.
Un bénéficiaire qui revient avec une nouvelle commande a un nouveau dossier. Si le dossier lié à un inscrit est supprimé dans téo, la ligne repasse Non importé au passage suivant : le dossier est recréé en Import auto, ou à créer à la main en Import manuel.
| Identifiant | Où le renseigner sur le dossier |
|---|---|
| Numéro de commande | Champ N° de commande de la fiche dossier |
| N° France Travail (historique) | Champ N° France Travail (historique) de la fiche dossier |
Le N° de commande retrouve le dossier, y compris sans N° France Travail. Le N° France Travail (historique) seul ne retrouve qu’un dossier sans n° de commande. Renseigner les deux reste la meilleure garantie, surtout pour un import anticipé.
Si vous importez vos bénéficiaires par fichier Excel avant la création du bon de commande dans Prest@ppli (cas typique : appel à J-7 alors que le bon de commande arrive à J-2), incluez dès l'import Excel les colonnes :
Numéro de commandeIdentifiant du bénéficiaire(enregistré dans N° France Travail (historique))
Au moment où Prest@ppli enverra ses données, téo retrouvera le dossier existant et y ajoutera simplement la séance — pas de doublon.
À défaut, attendez que Prest@ppli ait envoyé ses informations (J-2) pour faire l'import Excel : la fusion se fera dans l'autre sens.
Deux identifiants France Travail
Prest@ppli affiche aujourd'hui deux numéros pour un même demandeur d'emploi. La fiche dossier, groupe Commande, a deux champs :
| Côté Prest@ppli | Champ de la fiche dossier | Rôle |
|---|---|---|
| Identifiant historique (souvent 8 caractères + une lettre) | N° France Travail (historique) | Clé de rapprochement : c’est lui qui retrouve un dossier déjà présent. |
| Nouveau numéro à 11 chiffres | N° national France Travail (11 chiffres) | Recopié quand téo crée le dossier à partir de Prest@ppli, si France Travail le fournit. Jamais utilisé pour rapprocher un dossier : il n’évite pas un doublon. |
Ne remplacez pas N° France Travail (historique) par le numéro à 11 chiffres : le rapprochement ne retrouverait plus le dossier. Un dossier déjà créé n’est pas complété par le numéro national : saisissez-le à la main dans son champ.
→ Éviter les doublons Prest@ppli · Champs de la commande
Lucca
Description
Lucca est une solution RH. L'intégration permet de synchroniser les absences validées dans Lucca vers l'agenda téo.
Ce qui se passe automatiquement
- Une absence est validée dans Lucca pour un collaborateur actif.
- téo retrouve le collaborateur à partir de son adresse email.
- L'absence apparaît dans son agenda comme un événement Autre.
- Si l'absence est annulée ou supprimée dans Lucca, l'événement correspondant est annulé dans téo.
Chaque demi-journée Lucca est synchronisée sur un créneau dédié :
| Demi-journée Lucca | Créneau dans téo |
|---|---|
| Matin | 08:00 - 13:00 |
| Après-midi | 13:00 - 20:00 |
Le libellé de l'événement reprend le type d'absence Lucca. Si ce type n'existe pas encore dans téo, il est créé automatiquement avec une couleur grise.
Conflits avec l'agenda
Si le collaborateur a déjà une séance ou une réunion sur la demi-journée concernée, téo conserve la séance existante et enregistre un Conflit Lucca.
Consultez la liste dans Agenda > Contrôle > Conflits Lucca (visible si Lucca est actif et avec le droit Transférer des séances entre utilisateurs). Pour chaque ligne, vous voyez le conseiller, la date, la demi-journée (matin / après-midi), l'ID Lucca, le libellé de l'absence et les Séances en conflit (liens n°…). Affinez avec le filtre Conseiller (en-tête) et les filtres avancés Date, Demi-journée et Libellé. Le bouton Tableur exporte la liste filtrée. Sans conflit ouvert, la page affiche Aucun conflit Lucca ; avec des filtres trop restrictifs, Aucun conflit trouvé.
Pour résoudre un conflit : déplacez ou annulez la séance qui bloque le créneau, ou ajustez l'absence dans Lucca. téo retente à chaque synchronisation automatique (tâche planifiée côté téo, pas un rappel Lucca vers téo). Quand le créneau est libre et que l'absence Lucca est encore active, la séance d'absence est créée et le conflit quitte la liste. Un conflit local n'empêche pas la synchro des autres absences.
→ Détail de l'écran Conflits Lucca
Les étiquettes Lucca configurées comme informatives peuvent être ajoutées dans l'agenda même lorsqu'un autre événement existe déjà sur la demi-journée.
Activation
Contactez l'équipe téo pour activer l'intégration Lucca et vérifier le rapprochement des collaborateurs par adresse email.
Téléphonie
téo propose deux niveaux de fonctionnalités téléphoniques :
| Fonctionnalité | Click-to-call natif | Intégration 3CX / Keyyo |
|---|---|---|
| Appeler en un clic depuis téo | ✅ | ✅ |
| Historisation des appels dans les dossiers | ❌ | ✅ |
| Remontée de fiche (voir qui appelle) | ❌ | ✅ |
| Lien direct vers téo depuis l'app 3CX | ❌ | ✅ |
| Configuration requise | Aucune | Oui (option payante) |
Click-to-call natif (par défaut)
Le click-to-call fonctionne par défaut dans téo, sans aucune configuration. Il utilise l'application téléphonique installée sur votre poste (3CX, Skype, Teams, application mobile, softphone...).
Comment ça marche :
Le click-to-call utilise un lien tel: standard. Lorsque vous cliquez sur un numéro de téléphone dans téo, votre navigateur ouvre automatiquement l'application téléphonique configurée par défaut sur votre périphérique.
Utilisation :
- Depuis une fiche personne ou dossier
- Cliquez sur le numéro de téléphone ou sur l'icône téléphone
- L'appel se lance via l'application téléphonique de votre périphérique
Un client téléphonique doit être installé sur votre périphérique (ex : Skype, Teams, 3CX, application mobile...). C'est la seule condition pour que le click-to-call fonctionne.
Intégration 3CX / Keyyo (option avancée)
L'intégration téléphonique avancée est une option payante. Contactez l'équipe téo pour obtenir un devis.
Au-delà du click-to-call natif, l'intégration 3CX ou Keyyo apporte des fonctionnalités avancées :
- Historisation des appels : les appels entrants et sortants sont automatiquement enregistrés dans l'historique des dossiers concernés
- Remontée de fiche : lorsqu'un bénéficiaire vous appelle, son nom s'affiche sur votre téléphone (et ceux de vos collègues connectés à 3CX)
- Lien direct vers téo : depuis l'application 3CX, accédez directement au dossier du bénéficiaire qui vous appelle
Mise en place :
- Contactez l'équipe téo pour activer l'option
- Vous recevrez un fichier de configuration 3CX et les paramètres à configurer
- Transmettez ces éléments au prestataire qui gère votre serveur 3CX
- L'équipe téo reste disponible pour accompagner votre prestataire dans l'intégration
Pennylane PA
Pennylane est la plateforme agréée (PA) de facturation électronique B2B dans téo. Activation (compte ou compte existant, un SIREN par centre) et Envoyer depuis la fiche facture : Pennylane PA.
Chemins et droits : Accéder. Les factures fournisseurs se reçoivent dans Pennylane, pas dans téo.
Facturation électronique
| Voie | Pour qui |
|---|---|
| Pennylane PA | Clients privés (B2B — Pennylane). Activer et envoyer. |
| Export Factur-X | Autre plateforme ou expert-comptable : téléchargez le fichier depuis la facture (→ mode d'emploi). |
| Chorus Pro | Secteur public. Chorus Pro. |
Microsoft Teams
Description
L'intégration Microsoft Teams permet de créer une visioconférence depuis une séance d'agenda, d'ouvrir la réunion le jour J et d'envoyer les invitations par email aux participants.
Activation
L'administrateur de votre environnement doit autoriser téo à accéder à votre tenant Microsoft en créant une réunion avec son compte.
Authentification (SSO)
Description
téo utilise un système d'authentification centralisé (SSO) pour gérer les connexions. Cela permet :
- Connexion unifiée
- Politique de mot de passe centralisée
- Gestion des accès
Fonctionnement
- L'utilisateur accède à téo
- Il est redirigé vers la page de connexion SSO
- Il s'authentifie
- Il est redirigé vers téo, connecté
Configuration
La configuration SSO est gérée par les équipes téo lors de l'installation.
RésoVAE
Description
RésoVAE est une plateforme partenaire liée à la VAE (Validation des Acquis de l'Expérience) en Nouvelle-Aquitaine. L'intégration permet d'accéder directement à la plateforme RésoVAE depuis un dossier téo, avec authentification automatique.
Accéder à RésoVAE depuis un dossier
- Ouvrez le dossier concerné
- Dans le menu latéral, section Liens partenaires
- Cliquez sur RésoVAE
- La plateforme s'ouvre dans un nouvel onglet, avec le dossier déjà identifié
Ce lien n'est visible que si l'intégration RésoVAE est activée pour votre instance. Contactez le support téo pour en savoir plus.
API téo
Description
L’API téo permet à un outil de votre centre (tableur de suivi, application interne) de lire des données téo. Elle s’adresse à un développeur. La référence technique est sur le centre développeur : Démarrage rapide et Authentification.
Obtenir les identifiants
Il n’y a pas de libre-service : l’équipe téo remet les identifiants du client API (CLIENT_ID, CLIENT_SECRET et l’identifiant de structure TEO_ID). Demandez-les au service client.
Ils ne se trouvent pas dans Admin > Applications > Applications partenaires, qui sert à paramétrer des connecteurs. L’identifiant de structure désigne votre structure, ce n’est pas un filtre par prestation.
Erreur 401 ou 403
| Réponse | Sens | Que faire |
|---|---|---|
| 401 | Le jeton est refusé. | Reprendre l’authentification. |
| 403 après un jeton accepté | L’authentification a réussi, mais le client API n’a pas le droit de lecture sur cette ressource (dossiers, activités). Ce droit est distinct des droits de l’interface : voir les dossiers dans téo ne suffit pas. | Demander au service client d’accorder la lecture des dossiers ou des activités au client API déjà remis. |
Où lire quelle donnée
| Besoin | Où le lire |
|---|---|
| Les séances | GET /api/production/activities : identifiant, dossier (son identifiant seul), action, startAt, durée, isCancelled, distanciel, lieu, salle, conseiller, description, capacité. |
| La présence ou l’absence d’un bénéficiaire, l’état d’une séance (prévisionnelle ou validée) | Ces données ne sont pas dans cette réponse. Elles se lisent sur la fiche de la séance dans téo : Valider les séances · Séances. L’export Tableur de Agenda > Contrôle > Recherche ne les contient pas non plus : il reprend la date, les heures, l’objet, le consultant, le lieu, la mention annulée et les places. |
| Le n° de lettre de commande d’un dossier | GET /api/production/dossiers/{id}/markers, champ markers.dossier.commande.num (avec markers.dossier.commande.dateDebut et dateFin). La ressource dossier, GET /api/production/dossiers/{id}, ne porte que la période de commande (order.startDate, order.endDate). Ce n’est pas GET /api/prestappli/commandes, qui concerne les rendez-vous France Travail. Le fichier de la lettre, déposé comme document du dossier, n’est pas servi par ces adresses. |
Les marqueurs de l’API portent les mêmes noms que ceux des modèles de documents : markers.dossier.commande.num correspond à {d.dossier.commande.num} (Marqueurs Dossier).
Auteur d’un dossier créé par l’API
Un dossier créé par l’API n’a pas d’auteur : sa fiche affiche Inconnu dans Créé par. Le consultant transmis à la création devient le conseiller du dossier, pas son auteur, et la personne qui a lancé l’appel n’est pas reprise. L’API ne permet pas de la désigner. Ce n’est pas l’avatar API et le libellé intégration des séances créées par un connecteur.
→ Qui est l’auteur selon le canal de création
Questions fréquentes
Que signifie l'auteur « intégration » sur une séance ?
Les séances créées automatiquement par un connecteur ou une synchronisation affichent l'avatar API et le libellé intégration comme Auteur (dans le volet séance et dans Infos & historique). Cela distingue ces créations automatiques d'une action manuelle d'un collaborateur ou de téo assistance.
Cela ne vaut que pour les séances. Un dossier créé par l'API a un Créé par vide, affiché Inconnu.
→ Auteur d'un dossier créé par l'API
→ Créer et modifier des séances
Comment activer une intégration ?
Pour Pennylane PA, un Superadministrateur ouvre le menu et suit l’activation. Pour France Travail (Prest@ppli), s'il est ouvert pour votre structure : mettre en route. Pour les autres, contactez le support téo : certaines intégrations nécessitent un paramétrage spécifique et des accords avec les fournisseurs.
Les intégrations sont-elles incluses dans l'abonnement ?
Cela dépend de votre contrat. Certaines intégrations peuvent être en option.
Que se passe-t-il si une intégration échoue ?
téo continue de fonctionner normalement. Les données peuvent être saisies manuellement en attendant la résolution.
Puis-je connecter téo à mon propre système ?
Un développeur de votre centre peut lire des données téo avec l'API téo. Pour les identifiants ou un besoin d'intégration spécifique, contactez le support.
Bonnes pratiques
Après configuration, testez avec des cas réels pour vérifier que les données circulent correctement.
Vérifiez régulièrement les informations visibles dans téo pour détecter les données manquantes ou incohérentes.
Gardez une trace des paramètres utilisés. En cas de problème, cela facilitera le diagnostic.
Cet article vous a été utile ?