Intégrations et canaux
Une intégration connecte OneTrace.pro à un service externe : serveur de messagerie, passerelle SMS, bot de messagerie, plateforme publicitaire ou stockage de fichiers. Les canaux connectés servent aux parcours et aux campagnes, les plateformes aux exports d'audiences, et les sources à l'import de données régulier.
La section s'ouvre depuis le menu Engagement → Intégrations.
Ce que vous pouvez connecter
Les boutons Connecter : … sont regroupés par type.
Canaux : ils servent à envoyer les messages.
| Canal | Fonctionnement |
|---|---|
| Service de messagerie de la plateforme : envoi depuis votre domaine connecté dans Domaines d'envoi, avec signature DKIM, rebonds, plaintes et liste de suppression gérés automatiquement ; ou Votre serveur SMTP : adresse, port, chiffrement, identifiant et mot de passe. Dans les deux cas, vous indiquez l'adresse et le nom de l'expéditeur et pouvez activer le suivi des ouvertures et des clics. Avec votre serveur SMTP, vous pouvez indiquer un domaine et une boîte de retour pour que les e-mails non remis désabonnent automatiquement l'adresse | |
| SMS | fournisseur au choix : SMS.ru, SMSC.ru, Twilio ou l'API HTTP de votre propre passerelle. Les statuts de distribution arrivent à l'adresse indiquée dans l'intégration |
| Telegram | un bot créé avec BotFather : le jeton suffit, le bot obtient lui-même l'adresse des messages entrants |
| Viber (messages professionnels) | messages par numéro de téléphone via un agrégateur : SMSC.ru, Infobip ou votre propre API HTTP |
| Bot Viber | un bot Viber avec le jeton de l'espace partenaire, avec un message de bienvenue pour les nouveaux abonnés |
| WhatsApp Business Cloud API : ID du numéro, ID du compte, jeton et secret de l'application Meta | |
| Web Push | notifications dans le navigateur ; les clés sont créées automatiquement et les abonnements sont collectés par le code du site, voir Connexion du site |
| Webhook | une requête vers votre serveur avec les données du message, par exemple pour votre propre système de notifications |
Exports d'audiences : Webhook, S3 (CSV), Meta Custom Audience, Yandex Audiences, VK Ads et Google Ads Customer Match.
Sources de données : fichier par URL, fichier depuis S3 et Google Sheets.
Vous pouvez connecter plusieurs intégrations du même type : par exemple, deux serveurs SMTP pour les e-mails marketing et transactionnels. Dans les modèles, les parcours et les campagnes, vous choisissez l'intégration à utiliser pour l'envoi.
Connecter une intégration
- Cliquez sur le bouton du service souhaité, par exemple Connecter : E-mail.
- Indiquez un Nom : vous le verrez dans les modèles, les parcours et les exports, par exemple « E-mails marketing ».
- Renseignez les paramètres. Les indications sous les champs expliquent où trouver le jeton ou la clé dans l'espace du service.
- Cliquez sur Enregistrer.
- Sur la fiche de l'intégration, cliquez sur Tester.
Pour certains services, des champs techniques apparaissent dans les paramètres après l'enregistrement : par exemple URL du webhook et Jeton de vérification pour WhatsApp, ou URL des statuts de distribution pour les SMS. Copiez-les dans l'espace du service, sinon les statuts de distribution et les messages entrants n'arriveront pas.
Telegram, Bot Viber et WhatsApp reçoivent les messages entrants à l'adresse de votre installation OneTrace.pro, qui doit être accessible depuis Internet en HTTPS.
Test et statuts
Le bouton Tester se connecte au service et affiche le résultat : « La connexion fonctionne » avec des détails (nom du bot, solde chez le fournisseur SMS, bucket accessible) ou « Le test a échoué » avec le texte de l'erreur. L'heure du dernier test est affichée sur la fiche.
| Statut | Signification |
|---|---|
| Active | la connexion fonctionne correctement |
| Erreur | le dernier test ou la dernière configuration a échoué ; le texte de l'erreur figure sur la fiche. Corrigez les paramètres et testez à nouveau |
| Désactivée | l'intégration a été désactivée avec l'interrupteur Activée dans ses paramètres ; aucun message n'est envoyé par son intermédiaire |
Le test d'un SMS via votre propre API HTTP vérifie uniquement que l'adresse de la passerelle est joignable : un vrai SMS est payant, vérifiez donc l'envoi avec un message de test depuis un modèle.
Modification et suppression
- Modifier ouvre les paramètres. Les mots de passe, jetons et clés ne sont plus affichés après l'enregistrement : laissez ce champ vide pour conserver la valeur précédente.
- Pour suspendre temporairement les envois, désactivez l'interrupteur Activée : les paramètres sont conservés.
- Supprimer l'intégration : plus aucun message n'est envoyé par son intermédiaire, et les exports et sources utilisant cette connexion s'arrêtent avec une erreur.
Qui peut gérer les intégrations
| Action | Rôles |
|---|---|
| Voir les intégrations | « Propriétaire », « Administrateur », « Gestionnaire » |
| Connecter, modifier, tester et supprimer | « Propriétaire », « Administrateur » |
Le rôle d'un membre peut être limité à certaines intégrations, voir Membres et rôles. Ce membre ne voit dans la section que ses intégrations et ne gère qu'elles, si son rôle le permet. Il ne peut pas connecter de nouvelle intégration : cela exige un droit sur tout le projet. Dans les éditeurs de modèles et de parcours, il choisit toujours l'intégration parmi toutes celles connectées au projet.
À savoir
- Les canaux ne vérifient pas eux-mêmes les abonnements et la fréquence : ces règles sont communes à tous les canaux et se définissent sur la page Règles d'envoi.
- Vous pouvez aussi y désactiver une extension inutile, par exemple WhatsApp. Une extension désactivée disparaît des intégrations, des modèles et des parcours du projet.
- Le premier message WhatsApp et les envois en masse ne sont possibles qu'avec des modèles approuvés par Meta ; le texte libre est possible dans les 24 heures suivant un message du client.
- Avec le service de messagerie de la plateforme, vous ajoutez les enregistrements DKIM, SPF et de retour une seule fois, lors de la connexion du domaine : voir Domaines d'envoi. Pour votre propre serveur SMTP, SPF, DKIM et DMARC se configurent du côté du serveur et de votre domaine.