
Si votre application envoie ou reçoit déjà des fax via un autre fournisseur, la migration vers Fax.Plus commence par comprendre le fonctionnement actuel de cette connexion. Une API de fax est la connexion que votre logiciel utilise pour soumettre des documents, récupérer les fax reçus et vérifier les résultats. Lorsque vous la remplacez, vous devez vous assurer que ces tâches quotidiennes continuent de fonctionner comme prévu. Nous détaillons la migration étape par étape, de l'accès au compte et du traitement des documents jusqu'aux tests et au transfert de vos numéros de fax. Nous expliquons également la bascule (« cutover ») : le moment où votre application commence à utiliser le nouveau fournisseur pour le travail réel. L'objectif est de donner à vos développeurs et à votre équipe d'exploitation un plan commun qu'ils peuvent tester avant d'effectuer cette bascule.
Commencez par une courte liste qu'un développeur et la personne responsable de l'usage quotidien du fax peuvent examiner ensemble. Incluez les fax sortants, les numéros de réception, le stockage des documents, les mises à jour de livraison et tous les logiciels métier qui utilisent ces documents ou ces mises à jour. Dans les étapes ci-dessous, un « job » désigne simplement une tâche de fax que votre application doit suivre.
Pour chaque workflow, notez ce qui le déclenche, la provenance du document, le destinataire et ce qui se passe en cas d'échec de livraison. Repérez les jobs planifiés, les renvois manuels et les documents que quelqu'un a déjà soumis mais que votre application n'a pas encore marqués comme terminés.
Distinguez trois types de travail :
Prévoyez comment exporter et stocker les enregistrements historiques, séparément du transfert de votre numéro. Par exemple, votre équipe peut avoir besoin de retrouver un rapport de confirmation d'un fax envoyé plusieurs mois avant la migration. Décidez où ce rapport sera conservé, qui pourra y accéder et pendant combien de temps votre organisation doit le garder.
Ensuite, définissez ensemble ce que signifie « prêt à basculer ». Ce sont vos critères d'acceptation : les vérifications à réussir avant de commencer à utiliser la nouvelle intégration pour le travail réel. Par exemple, le document doit être lisible, un fax entrant doit parvenir à la bonne équipe et un résultat de livraison doit apparaître à côté de l'enregistrement correct dans l'application. Choisissez des vérifications adaptées à vos propres documents et destinations.
Notre API est disponible avec le plan Enterprise, comme expliqué dans le guide de démarrage rapide de l'API Fax.Plus. Vérifiez le compte, les numéros attribués et les fonctionnalités nécessaires à votre workflow avant de planifier la bascule en production. L'éligibilité au transfert d'un numéro n'est pas la même que l'éligibilité à l'utilisation de l'API.
L'authentification permet à l'API de vérifier à quel compte votre application peut accéder. Notre guide d'authentification couvre les jetons d'accès personnels et OAuth 2.0. Un jeton d'accès personnel est un secret que votre application utilise pour authentifier ses requêtes. OAuth 2.0 permet à un utilisateur d'autoriser l'accès via un processus de connexion et de consentement. Votre développeur doit choisir la méthode adaptée au workflow et suivre les exigences de configuration correspondantes.
Séparez les identifiants utilisés pour le travail réel de votre configuration de test, et stockez les secrets côté serveur plutôt que dans le code du navigateur. Limitez les permissions aux actions dont l'application a besoin. Pendant les tests, désactivez volontairement un identifiant de test et vérifiez que votre application signale clairement le problème. Un problème de connexion doit donner à votre équipe quelque chose à examiner, et non déclencher des envois répétés.
Pour les workflows réglementés, vérifiez les exigences de sécurité et contractuelles de votre organisation avant d'utiliser des documents réels. Une connexion technique ne suffit pas à établir que l'ensemble du workflow répond à ces exigences, surtout lorsque d'autres applications traitent les documents.
Notez comment les informations de votre intégration actuelle correspondent à celles de la nouvelle. On parle parfois de « field map » (table de correspondance des champs). Elle doit couvrir des éléments tels que le numéro de destination, la référence du document, l'ID du fax et le résultat. Conservez l'ID de job propre à votre application tel quel et enregistrez à côté les ID de l'ancien et du nouveau fournisseur.
Par exemple, une commande nommée PO-1042 dans votre système doit rester PO-1042 après la migration. Son fax peut avoir un autre ID de suivi chez le nouveau fournisseur, mais votre équipe doit toujours pouvoir retrouver ensemble la commande, le document et son résultat.
Avec Fax.Plus, vous importez d'abord un fichier. L'API renvoie un chemin (« path »), c'est-à-dire la référence que votre application inclut dans sa requête d'envoi. L'endpoint d'envoi, l'adresse de l'API qui accepte cette requête, peut renvoyer des ID de fax planifiés lorsque vous définissez sur . Enregistrez ces ID pour pouvoir suivre la suite.
Faites apparaître dans votre application la différence entre « soumis », « en cours de traitement » et un résultat de livraison final. Le guide de la boîte d'envoi décrit des étapes telles que la conversion du document et l'envoi. Une requête API réussie indique seulement que la requête a été acceptée ; votre application doit encore suivre le fax jusqu'à son résultat final.
Définissez ce que votre équipe doit voir lorsqu’un fax n’est transmis que partiellement, lorsqu’un envoi échoue ou lorsqu’un résultat nécessite l’attention d’une personne. Un bon message explique ce que l’on sait et ce qu’il faut vérifier ensuite. Cela aide l’opérateur à décider s’il doit examiner le document, vérifier la destination ou autoriser une nouvelle tentative.
Testez le rendu des documents avec des fichiers d’exemple contenant des informations fictives. Incluez des PDF de plusieurs pages, des pages numérisées, du texte de petite taille et toutes les mises en page de page de garde utilisées dans votre workflow. Une requête techniquement réussie peut quand même produire un document difficile à lire pour le destinataire.
Un webhook est un message automatique envoyé à votre application lorsqu’un événement se produit, par exemple lorsqu’un fax termine sa transmission. Il permet à votre application de mettre à jour un enregistrement sans demander à plusieurs reprises si quelque chose a changé. Pour une nouvelle intégration, suivez notre documentation actuelle sur les webhooks et utilisez .
Le nom d’événement signifie que la session sortante est terminée, y compris en cas de tentatives infructueuses. Lisez son statut avant de marquer un enregistrement comme « remis ». Vérifiez la signature du webhook, un contrôle cryptographique servant à authentifier le message, et accusez réception rapidement des messages valides. Planifiez les tâches plus lentes, comme la mise à jour d’un autre système, en arrière-plan afin que votre récepteur puisse répondre rapidement.
Un même webhook peut arriver plusieurs fois. Son en-tête , une valeur envoyée avec le message, identifie la livraison et reste identique lorsque ce message est renvoyé. Gardez la trace des ID déjà traités afin qu’une nouvelle réception ne répète pas l’action métier. C’est ce qu’on appelle la déduplication.
Par exemple, recevoir deux fois la même mise à jour de livraison ne doit pas ajouter deux fois la même pièce jointe à une commande. Testez ce point séparément de la prévention des envois de fax en double : vérifier une mise à jour répétée ne vous dit pas si une requête d’envoi incertaine doit être soumise à nouveau.
Commencez avec des documents ne contenant aucune information client ou sensible, et envoyez-les uniquement à des numéros de test convenus que votre équipe contrôle. Confirmez la configuration et les éventuels frais avant de tester. Si vous utilisiez auparavant un sandbox, un environnement isolé pour tester sans l’activité de production habituelle, vérifiez quel dispositif de test est disponible ici plutôt que de supposer qu’il fonctionne de la même manière.
| Test | À vérifier avant le lancement |
|---|---|
| Accès au compte | L’application peut accomplir sa tâche prévue. Un identifiant invalide ou désactivé produit une erreur claire. |
| Préparation des documents | Les fichiers types restent lisibles, complets et dans l’ordre attendu à la réception. |
| Envoi réussi | Le document arrive, et son résultat final est enregistré à côté du bon enregistrement métier. |
| Échec et livraison partielle | L’application conserve suffisamment d’informations pour permettre une vérification et ne marque pas le job comme remis de façon prématurée. |
| Webhook répété | Recevoir deux fois la même mise à jour ne crée ni pièce jointe ni notification en double. |
| Mises à jour interrompues | Si votre application ne peut temporairement pas recevoir les mises à jour, votre équipe peut consulter l’enregistrement du fax et rétablir la situation sans deviner s’il faut renvoyer le document. |
| Fax entrant | Un fax envoyé à chaque numéro de test arrive au bon endroit dans votre application et auprès de la bonne équipe. |
| Nouvelle tentative d’envoi | Votre équipe sait quelles nouvelles tentatives sont gérées par le fournisseur et lesquelles nécessitent une décision de l’application ou d’un opérateur. |
| Preuves conservées | Votre équipe peut récupérer l’enregistrement du fax et le rapport requis à partir de la tâche métier d’origine. |
| Répétition de la bascule | Votre équipe peut identifier les tâches en cours, suspendre les nouveaux envois si nécessaire et suivre son plan de reprise. |
Conservez un résultat pour chaque test, avec le type de document, la destination contrôlée, le comportement attendu, le comportement observé et le problème non résolu. Corrigez les critères d’acceptation non satisfaits avant d’élargir le déploiement.
Si votre workflow nécessite un document de confirmation, Fax.Plus propose un endpoint de rapport de confirmation PDF. Vérifiez le rapport que votre application récupère et la manière dont il est stocké. Un résultat de transmission ne prouve pas qu’une personne a examiné ou accepté le document.
La portabilité d’un numéro transfère votre numéro existant d’un fournisseur à un autre afin que l’on puisse continuer à l’utiliser pour vous joindre. Si vous souhaitez conserver vos numéros, commencez par vérifier s’ils peuvent être portés. Suivez le processus actuel de portabilité Fax.Plus, y compris les informations de compte et les documents d’autorisation requis.
Conservez votre ligne actuelle active jusqu’à ce que Fax.Plus confirme que la portabilité est terminée. Résilier avant peut empêcher le transfert et mettre le numéro en danger.
Le processus de transfert explique comment un numéro temporaire vous permet de commencer à faxer pendant que le transfert est en cours. Utilisez-le pour tester votre workflow de réception avant le transfert. Vérifiez quel numéro sera remplacé, surtout si le compte en comporte plusieurs. Une fois le transfert terminé, vérifiez ensuite que les fax entrants arrivent de nouveau au bon endroit.
Planifiez ensemble la modification de l'application et le transfert du numéro, mais suivez-les séparément. Une intégration API opérationnelle ne signifie pas que le numéro a été transféré. De même, un transfert terminé ne prouve pas que le récepteur et les règles de routage de votre application sont corrects.
Avant de fixer une date de bascule, confirmez les modalités de transfert et convenez de la marche à suivre si une vérification échoue. Les développeurs parlent parfois de rollback pour désigner le retour à la configuration précédente. Or, rétablir un paramètre de l'application ne ramène pas automatiquement un numéro transféré chez son ancien fournisseur. Prévoyez séparément les options de reprise pour votre logiciel et pour vos numéros.
Lorsque vous commencez à acheminer les envois de production via Fax.Plus, conservez une séparation claire entre les jobs soumis à l'ancien fournisseur et ceux soumis au nouveau. N'envoyez pas le même document de production via les deux fournisseurs simplement pour comparer les résultats.
Au moment de la bascule, dressez la liste des envois non terminés, des jobs planifiés, des échecs non résolus et des documents entrants encore à traiter. Comparez cette liste avec les enregistrements des deux fournisseurs. Cette réconciliation permet de repérer les éléments qui pourraient sinon être oubliés ou envoyés deux fois. Si le résultat d'un envoi est incertain, consultez son enregistrement avant de réessayer via l'autre fournisseur.
Examinez les premières transactions de production au regard de vos critères d'acceptation. Surveillez les symptômes importants sur le plan opérationnel : documents entrants non traités, statuts finaux manquants, pages illisibles, actions répétées et écarts entre votre application et les enregistrements du fournisseur.
Une fois les vérifications validées, faites le point sur les tâches en cours, conservez les enregistrements dont vous avez besoin et confirmez que tous les transferts de numéros sont terminés. Suivez ensuite le plan convenu pour fermer l'ancien service. Désactivez les identifiants que vous n'utilisez plus et supprimez les anciennes destinations de webhook afin qu'elles ne restent pas actives inutilement.
Commencez par un workflow que votre équipe maîtrise bien. Listez ce qu'il doit accomplir, convenez des vérifications qui démontreront son bon fonctionnement, puis suivez le guide de démarrage rapide de l'API Fax.Plus pour les étapes de mise en œuvre.
Si vous comparez encore les solutions, notre page de l'API Fax.Plus présente le service et explique comment nous contacter. Apportez votre workflow, votre volume d'utilisation prévu et vos besoins en numéros à cet échange afin de planifier la migration en fonction de ce dont votre équipe a réellement besoin.
En général, il faut vérifier davantage que l'adresse de connexion. Comparez la façon dont les API gèrent l'accès au compte, l'envoi des documents, les identifiants de suivi, les résultats et les mises à jour automatiques. Votre développeur pourra ensuite identifier et tester les modifications nécessaires à votre application.
Non. Considérez la réponse à la requête comme une simple étape de soumission. Suivez le fax jusqu'à son résultat final et utilisez l'enregistrement ou le rapport de confirmation correspondant lorsque votre workflow nécessite une preuve.
Commencez par des documents fictifs et des numéros de test que votre équipe contrôle. N'utilisez de vrais documents qu'après avoir vérifié les exigences nécessaires en matière de sécurité, d'accès, de contrat et d'exploitation.
Vérifiez l'éligibilité au transfert avant de basculer. Gardez le service existant actif jusqu'à la confirmation de la fin du transfert, puis testez le routage des fax entrants une fois le numéro transféré.
Pas forcément. Séparer votre workflow métier de la gestion des requêtes et des événements propre au fournisseur peut réduire les modifications à effectuer. Le travail réel dépend de l'intégration que vous avez déjà et des comportements sur lesquels elle repose.
