Connexions externes
Reliez un service externe au bon contexte métier
Décrivez le service à connecter, fournissez sa documentation et associez-le aux domaines métier concernés.
Réunissez documentation et informations d’accès
- Déclarer le service
Identifiez l’API externe et donnez un lien ou le texte de sa documentation.
- Séparer les accès
Fournissez les informations de test et de production demandées.
- Relier le contexte métier
Associez une connexion existante aux domaines qui l’utilisent.
Donnez les informations nécessaires à l’intégration
La connexion commence par le nom du service et sa documentation. Expliquez l’action métier concernée et les informations à échanger entre les systèmes.
La déclaration distingue les accès de test et de production. Consultez-les sur la fiche de la connexion en gardant le contexte de l’environnement clair.
Préparez l’intégration autour de l’action qu’elle soutient
Expliquer l’échange nécessaire. Un service peut fournir ou recevoir les informations d’une tâche. Déclarez nom et documentation puis expliquez l’échange dans le contexte du projet. L’intégration possède ainsi un objectif pratique au-delà d’une URL.
Distinguer test et production. Les accès peuvent appartenir à des comptes fournisseurs différents. Conservez-les dans les champs correspondants et vérifiez leur usage. Ces contextes préparent les étapes de développement et d’exploitation.
Réutiliser une connexion déclarée. Un service peut soutenir plusieurs domaines. Rattachez la connexion existante au bon endroit puis examinez ses associations. Détacher un domaine et supprimer la connexion du projet sont des décisions distinctes.
Réutilisez la connexion au bon endroit
Une connexion peut servir plusieurs domaines métier. Consultez les services liés à un domaine pour attacher ou détacher celui qui convient.
La déclaration fournit les besoins de l’intégration. Suivez son état et testez le parcours construit avant de l’utiliser en production.
Expliquez l’échange dont votre application a besoin
Précisez le service, les informations à envoyer ou recevoir et le domaine métier qui les utilise. Un lien vers la documentation actuelle aide à décrire le fonctionnement réel du service externe.
Décrivez un exemple utile et le résultat attendu si le service est indisponible. La connexion peut alors être discutée à partir du travail des utilisateurs, au-delà du seul nom du fournisseur.
De la déclaration au parcours testé
Fournir les informations du service. Fournissez la documentation du service et les accès demandés pour les environnements de test et de production. Identifiez l’opération métier à connecter et le résultat attendu de l’échange.
Associer les bons domaines. Rattachez la connexion aux domaines métier qui doivent utiliser le service. Examinez les associations existantes avant un ajout ou un retrait pour conserver un périmètre compréhensible.
Vérifier l’intégration terminée. Suivez l’état du travail, puis testez l’échange complet dans l’environnement concerné. La déclaration de la connexion apporte son contexte ; la vérification du résultat confirme son fonctionnement.
Ce que votre application peut connecter
Deux statuts seulement. Disponible : inclus dans chaque application, rien à construire. Sur demande : réalisé pendant votre projet avec l’API du fournisseur, à partir de sa documentation et de votre propre compte chez ce fournisseur.
Disponible dans chaque application
Envoi d’e-mails
DisponibleVotre application envoie ses e-mails depuis une adresse de votre propre domaine, une fois cette adresse et le domaine validés dans son back-office.
SMS
DisponibleVotre application envoie des SMS, comme les codes de vérification du téléphone, sous un nom d’expéditeur partagé. Un nom d’expéditeur à vous demande d’abord un enregistrement.
Connexions externes
DisponibleDans Connecteurs, vous déclarez un service avec sa documentation et ses accès de test et de production, puis vous le rattachez aux domaines métier qui l’utilisent.
Réalisé sur demande avec l’API du fournisseur
Un service avec une API documentée
Sur demandeUn service qui publie la documentation de son API peut être connecté à partir de cette documentation et de vos accès de test et de production. La faisabilité est confirmée lors de la revue du périmètre.
Vos logiciels métier
Sur demandeUn ERP, un logiciel comptable ou un CRM qui publie une API : les données échangées, leur sens et leur rythme sont spécifiés avec le domaine métier qui les utilise.
Listes Brevo
Sur demandeLes abonnés qui ont donné leur consentement envoyés vers les listes de votre propre compte Brevo. Ultineo E-commerce fait déjà fonctionner cette synchronisation.
Google Ads
Sur demandeAutorisation sur l’écran de consentement de Google avec le compte qui gère votre publicité, puis vos campagnes existantes suivies depuis votre application. Ultineo E-commerce connecte déjà Google Ads de cette façon.
OVHcloud
Sur demandeDomaines, zones DNS et autres ressources de votre compte OVHcloud gérés depuis votre application via l’API OVHcloud. Une application construite sur le même moteur le fait déjà.
Préparez la connexion réellement utile à l’application
Partez de la documentation et du résultat métier. Gardez accès et associations compréhensibles tout au long du projet.
Questions fréquentes
Nom du service, lien ou contenu de sa documentation, puis accès demandés pour test et production. Un nom seul ne définit pas le comportement de l’intégration.
Oui. Examinez les domaines liés dans les détails pour conserver un périmètre lisible.
La connexion utilise un autre service. L’API optionnelle expose les opérations convenues de votre application. Ce sont des besoins d’intégration différents.
Le détachement concerne un domaine. La suppression du connecteur est une autre action, avec un autre périmètre ; vérifiez la confirmation.
Suivez la réalisation puis testez l’échange complet. Déclaration et activation apportent du contexte sans remplacer la vérification du résultat.