Intégration Guides de configuration
Instructions étape par étape pour connecter chaque service tiers à votre plateforme Engium. Comprend les informations d'identification, les liens, les tarifs et le dépannage.
Présentation de l'intégration
Engium se connecte à des services tiers pour gérer les appels téléphoniques, les messages WhatsApp, les e-mails, les paiements et les réservations de calendrier. Chaque intégration nécessite des informations d'identification du fournisseur tiers. Vous trouverez ci-dessous des guides étape par étape pour chaque service pris en charge.
Appels vocaux
Twilio (international) ou Exotel (Inde)
API Meta Cloud ou Gupshup (Inde)
SendGrid, AWS SES ou Mailgun
Calendrier
Synchronisation bidirectionnelle de Google Agenda
Discussion en ligne
Widget intégré – aucune configuration nécessaire
Pour les entreprises en Inde, nous recommandons Exotel pour les appels vocaux et Gupshup pour WhatsApp : ils sont 60 à 75 % moins chers que les fournisseurs internationaux avec une meilleure assistance locale.
📞 Twilio — Appels vocaux
Twilio est la plateforme de communication cloud leader du secteur. Utilisez-le pour les appels téléphoniques entrants et sortants, les menus IVR, l'enregistrement des appels et les réponses vocales basées sur l'IA.
Conditions préalables
- Un compte Twilio (essai gratuit disponible avec un crédit de 15 $)
- Une adresse e-mail et un numéro de téléphone vérifiés
- Un numéro de téléphone acheté avec fonctionnalité vocale (~ 1 $/mois)
Étapes de configuration
Créer un compte Twilio
Accédez au site Web de Twilio et inscrivez-vous pour un essai gratuit. Vous obtiendrez 15 $ de crédit gratuit pour tester.
Vérifiez votre identité
Twilio vous demandera de vérifier votre adresse e-mail et votre numéro de téléphone. Effectuez les deux vérifications pour activer votre compte.
Trouvez le SID de votre compte et votre jeton d'authentification
Après vous être connecté, accédez au tableau de bord de la console Twilio. Le SID de votre compte (commence par « AC ») et votre jeton d'authentification sont affichés directement sur la page principale. Cliquez sur l'icône en forme d'œil pour révéler le jeton d'authentification.
Acheter un numéro de téléphone
Accédez à Numéros de téléphone → Gérer → Acheter un numéro. Recherchez un numéro dans votre pays, assurez-vous que la fonctionnalité « Voix » est activée et achetez-le (~ 1 $/mois).
Entrez les informations d'identification dans Engium
Dans Engium, accédez à Intégrations → Voix → Twilio. Entrez le SID de votre compte, le jeton d'authentification et donnez un nom à l'intégration (par exemple, « Secteur d'activité principal »). Cliquez sur « Vérifier les informations d'identification ».
Sélectionnez votre numéro de téléphone
Une fois la vérification réussie, sélectionnez le numéro de téléphone que vous avez acheté dans la liste déroulante. Cliquez sur « Enregistrer » et votre canal vocal est en direct. Engium configure automatiquement le webhook.
Référence des informations d'identification
| Field | Where to find it |
|---|---|
| Account SID* | Console Twilio → Tableau de bord → SID du compte (commence par « AC », 34 caractères) |
| Auth Token* | Console Twilio → Tableau de bord → Jeton d'authentification (cliquez sur l'icône en forme d'œil pour révéler, 32 caractères) |
| Phone Number* | Console Twilio → Numéros de téléphone → Gérer → Numéros actifs |
Tarifs
Tarification à l'utilisation de Twilio (États-Unis)
| Numéro de téléphone | ~$1.00/month |
| Appels vocaux entrants | ~$0.0085/min |
| Appels vocaux sortants | ~$0.013/min |
Liens utiles
Twilio propose des informations d'identification de test qui simulent des appels sans frais. Trouvez-les dans Console → Paramètres → Test des informations d'identification. Parfait pour vérifier votre configuration avant de passer en direct.
📞 Exotel — Voix et SMS (Inde)
Exotel est le premier fournisseur de téléphonie cloud en Inde. Une seule intégration Exotel permet à la fois les appels vocaux et les SMS – et c'est 60 à 75 % moins cher que Twilio pour les numéros indiens.
Pourquoi Exotel ? Comparaison des prix
| Exotel | Twilio | |
|---|---|---|
| Appels vocaux (Inde) | ₹0.50/min | ₹1.25/min |
| SMS (Inde) | ₹0.15/msg | ₹0.55/msg |
| Économies | 60–75% moins cher | |
Étapes de configuration
Créer un compte Exotel
Inscrivez-vous sur le site Exotel. Une vérification commerciale peut être requise pour la conformité des télécommunications indiennes.
Vérification KYC complète
Téléchargez la documentation de votre entreprise selon vos besoins. Ceci est obligatoire pour la réglementation indienne des télécommunications. L'approbation prend généralement 1 à 2 jours ouvrables.
Obtenez vos informations d'identification API
Connectez-vous à votre tableau de bord Exotel. Accédez à Paramètres → API. Copiez votre clé API, votre jeton API et votre SID de compte.
Obtenez un numéro virtuel
Dans votre tableau de bord Exotel, accédez à Numéros et achetez ou activez un numéro de téléphone virtuel. Ce sera votre identifiant d’appelant professionnel.
Entrez les informations d'identification dans Engium
Dans Engium, accédez à Intégrations → Fournisseurs → Exotel. Entrez votre clé API, votre jeton API, votre SID de compte et votre numéro d'expéditeur. Cliquez sur « Vérifier et connecter ». Engium active automatiquement les canaux vocaux et SMS.
Référence des informations d'identification
| Field | Where to find it |
|---|---|
| API Key* | Tableau de bord Exotel → Paramètres → API → Clé API |
| API Token* | Tableau de bord Exotel → Paramètres → API → Jeton API |
| Account SID* | Tableau de bord Exotel → Paramètres → API → SID du compte |
| From Number | Votre numéro virtuel Exotel (chiffres uniquement, par exemple 08047190000) |
Liens utiles
Exotel exige une vérification KYC/entreprise pour la conformité des télécommunications indiennes. Prévoyez 1 à 2 jours ouvrables pour l’approbation. Préparez le PAN de votre entreprise, votre certificat de TPS et votre preuve d'adresse.
💬 WhatsApp Business — API Meta Cloud
Connectez WhatsApp Business directement via l'API Cloud de Meta pour une messagerie fiable et évolutive. Il s’agit du parcours d’intégration officiel recommandé aux entreprises internationales.
Conditions préalables
- Un compte Meta Business (business.facebook.com)
- Un numéro de téléphone NON déjà enregistré sur WhatsApp — il sera converti en numéro professionnel
- Une page Facebook pour votre entreprise (facultatif mais recommandé)
- Un moyen de paiement sur votre compte Meta Business
Étapes de configuration
Créer un compte Meta Business
Si vous n'en avez pas, accédez à Meta Business Suite et créez un compte professionnel. C'est gratuit et prend quelques minutes.
Créer une méta-application
Accédez à Meta for Developers, cliquez sur « Créer une application » et sélectionnez le type « Business ». Ajoutez le produit WhatsApp à votre application.
Ajoutez et vérifiez votre numéro de téléphone
Dans la section WhatsApp de votre application, ajoutez un numéro de téléphone. Meta enverra un code de vérification par SMS ou appel vocal. Important : ce numéro ne doit PAS être déjà enregistré sur WhatsApp ; supprimez-le d'abord de WhatsApp si nécessaire.
Créer un utilisateur système et générer un jeton d'accès
Dans Meta Business Suite → Paramètres → Paramètres professionnels → Utilisateurs → Utilisateurs système : créez un utilisateur système avec le rôle « Administrateur », puis cliquez sur « Générer un nouveau jeton ». Sélectionnez l'application WhatsApp et accordez les autorisations WhatsApp_business_management et WhatsApp_business_messaging. Copiez le jeton – vous ne le reverrez plus.
Obtenez votre identifiant de numéro de téléphone et votre identifiant de compte professionnel
Dans Meta for Developers → votre application → WhatsApp → Configuration de l'API : vous trouverez à la fois votre identifiant de numéro de téléphone (numérique) et votre identifiant de compte WhatsApp Business.
Entrez les informations d'identification dans Engium
Dans Engium, accédez à Intégrations → WhatsApp → API Meta Cloud. Saisissez votre identifiant de numéro de téléphone, votre identifiant de compte professionnel et votre jeton d'accès. Cliquez sur « Vérifier et connecter ».
Configurer le webhook (automatique)
Après une vérification réussie, Engium fournit une URL de webhook. Copiez-le et collez-le dans votre méta-application → WhatsApp → Configuration → URL de rappel. Abonnez-vous aux événements « messages ». Engium recevra désormais tous les messages WhatsApp entrants.
Référence des informations d'identification
| Field | Where to find it |
|---|---|
| Phone Number ID* | Meta pour les développeurs → Application → WhatsApp → Configuration de l'API → ID du numéro de téléphone |
| Business Account ID* | Meta pour les développeurs → Application → WhatsApp → Configuration de l'API → ID de compte professionnel |
| Access Token* | Meta Business Suite → Paramètres → Utilisateurs système → Générer un jeton (utilisez le jeton d'utilisateur système permanent, PAS le jeton de test temporaire) |
Tarifs
Tarification basée sur les conversations WhatsApp
| Initié par l'entreprise (marketing/utilitaire) | ~$0.04–0.06 |
| Initié par l'utilisateur (service) | ~$0.01–0.03 |
| Allocation gratuite | 1 000 premières conversations/mois gratuites |
Utilisez un jeton d’accès utilisateur système permanent pour la production. Le jeton de test temporaire de la configuration de l'API expire dans 24 heures et interrompra votre intégration.
Les premiers messages adressés aux clients doivent utiliser des modèles de messages pré-approuvés (approuvés via WhatsApp Manager). Après la réponse d'un client, vous disposez d'une fenêtre de 24 heures pour les messages libres.
Liens utiles
📧 Intégration de la messagerie
Connectez un fournisseur de messagerie pour activer les réponses par e-mail basées sur l'IA, les suivis automatisés et les e-mails de notification. Engium prend en charge trois fournisseurs : choisissez celui qui correspond à vos besoins.
Fournisseurs pris en charge
| Fournisseur | Idéal pour | Niveau gratuit | Tableau de bord |
|---|---|---|---|
| SendGrid | La plupart des entreprises : configuration facile | 100 emails/day | app.sendgrid.com ↗ |
| AWS SES | Volume élevé – moins cher à grande échelle | 62,000/month (EC2) | AWS Console ↗ |
| Mailgun | Développeurs : des API puissantes | 100 emails/day (trial) | mailgun.com ↗ |
Configuration de SendGrid
Créer un compte SendGrid
Inscrivez-vous sur SendGrid (propriété de Twilio). Le forfait gratuit comprend 100 e-mails/jour.
Vérifier l'identité d'un expéditeur
Accédez à Paramètres → Authentification de l'expéditeur. Vérifiez une seule adresse e-mail d'expéditeur ou authentifiez l'intégralité de votre domaine pour une meilleure délivrabilité.
Créer une clé API
Accédez à Paramètres → Clés API → Créer une clé API. Sélectionnez « Accès complet » ou « Accès restreint » avec l'autorisation d'envoi de courrier. Copiez la clé immédiatement : elle ne sera plus affichée.
Entrez dans Engium
Dans Engium, accédez à Intégrations → E-mail. Sélectionnez « SendGrid », collez votre clé API, entrez votre adresse e-mail d'expéditeur vérifiée et enregistrez.
Configuration d'AWS SES
Accéder à AWS SES
Connectez-vous à la console AWS et accédez à Amazon SES. Si vous êtes nouveau sur AWS, créez d'abord un compte.
Vérifiez votre email/domaine
Dans SES, accédez à Identités → Créer une identité. Vérifiez soit une seule adresse e-mail (rapide), soit un domaine entier (ajoutez des enregistrements DNS). Vous commencerez en mode Sandbox.
Créer des informations d'identification SMTP ou une clé API
Accédez à AWS IAM et créez une clé d'accès avec les autorisations SES. Ou utilisez SES → Paramètres SMTP pour générer des informations d'identification SMTP. Copiez l'ID de clé d'accès et la clé d'accès secrète.
Entrez dans Engium
Dans Engium, accédez à Intégrations → E-mail. Sélectionnez « AWS SES », collez votre clé API, saisissez votre adresse e-mail d'expéditeur vérifiée et enregistrez. Remarque : demandez l'accès à la production à SES pour l'envoyer à des destinataires non vérifiés.
Configuration du pistolet postal
Créer un compte Mailgun
Inscrivez-vous sur Mailgun. L'essai comprend 100 e-mails/jour pendant le premier mois.
Ajoutez et vérifiez votre domaine
Dans Mailgun, accédez à Domaines → Ajouter un nouveau domaine. Suivez les instructions d'enregistrement DNS pour vérifier votre domaine. Cela améliore considérablement la délivrabilité des e-mails.
Obtenez votre clé API
Accédez à Paramètres → Clés API. Copiez votre clé API privée. Ceci est utilisé pour envoyer des e-mails via l'API Mailgun.
Entrez dans Engium
Dans Engium, accédez à Intégrations → E-mail. Sélectionnez « Mailgun », collez votre clé API privée, entrez votre adresse e-mail d'expéditeur vérifiée et enregistrez.
Référence des informations d'identification (tous les fournisseurs)
| Field | Where to find it |
|---|---|
| Fournisseur* | Sélectionnez SendGrid, AWS SES ou Mailgun dans la liste déroulante |
| API Key* | Tableau de bord du fournisseur → section Clés API (voir les étapes individuelles ci-dessus) |
| Depuis un e-mail* | Doit être un e-mail d'expéditeur vérifié dans le tableau de bord de votre fournisseur |
Testez votre intégration de messagerie en envoyant un e-mail de test depuis Engium après la configuration. Vérifiez votre dossier spam s'il n'arrive pas : vous devrez peut-être configurer des enregistrements DNS SPF/DKIM pour votre domaine.
📅 Google Agenda – Synchronisation bidirectionnelle
Connectez Google Agenda pour une synchronisation automatique des réservations bidirectionnelles. Lorsque AI prend un rendez-vous, celui-ci apparaît immédiatement dans votre agenda Google. Les événements créés dans Google Agenda bloquent l'heure dans Engium pour éviter les doubles réservations.
Étapes de configuration
Accédez aux paramètres du calendrier
Dans Engium, accédez à Paramètres → Calendrier. Vous verrez l'option de connexion à Google Agenda.
Cliquez sur « Connecter Google Agenda »
Une fenêtre de connexion Google s'ouvrira. Connectez-vous avec le compte Google contenant le calendrier que vous souhaitez synchroniser. Accordez à Engium l'autorisation de lire et d'écrire des événements de calendrier.
Sélectionnez votre calendrier
Après autorisation, sélectionnez le calendrier Google avec lequel synchroniser (vous pouvez en avoir plusieurs). Choisissez votre calendrier professionnel principal.
Vérifier que la synchronisation fonctionne
Créez une réservation test dans Engium et vérifiez qu'elle apparaît dans votre agenda Google en quelques secondes. Créez ensuite un événement dans Google Agenda et vérifiez qu'il bloque l'heure dans Engium.
Caractéristiques
- Synchronisation bidirectionnelle : les réservations apparaissent à la fois dans Engium et Google Agenda
- Prévention des doubles réservations : les événements de Google Agenda bloquent les plages horaires Engium
- Mises à jour automatiques : les reprogrammations et les annulations se synchronisent dans les deux sens
- Plusieurs calendriers : connectez différents calendriers pour différents membres de l'équipe
Liens utiles
Si vous n'avez pas besoin de la synchronisation de Google Calendar, le calendrier intégré d'Engium fonctionne immédiatement sans aucune configuration. Vous pourrez toujours connecter Google Agenda plus tard.
🌐 Widget de discussion en ligne
Le widget de chat Web d'Engium est intégré et ne nécessite aucune configuration tierce. Activez-le simplement et collez un extrait sur votre site Web. Les visiteurs peuvent discuter directement avec votre assistant IA.
Étapes de configuration
Activer le chat Web
Dans Engium, accédez à Intégrations → Web Chat et activez-le. Personnalisez l'apparence du widget : couleurs, message de bienvenue, position et avatar.
Copiez le code d'intégration
Engium génère un extrait de code JavaScript. Copiez-le et collez-le dans le HTML de votre site Web, juste avant la balise de fermeture </body>. Cela fonctionne sur n’importe quelle plateforme de site Web.
Testez sur votre site internet
Visitez votre site Web et recherchez la bulle de discussion dans le coin inférieur droit. Cliquez dessus pour démarrer une conversation test avec votre assistant IA.
Caractéristiques
- Réponses de l'IA en temps réel : les visiteurs obtiennent des réponses instantanées
- Apparence personnalisable : faites correspondre les couleurs et le style de votre marque
- Partage de fichiers : les clients peuvent envoyer des images et des documents
- Mobile responsive – fonctionne parfaitement sur les téléphones et les tablettes
- Historique des conversations : toutes les discussions sont enregistrées dans votre tableau de bord Engium
🔧 Dépannage
Problèmes d'intégration courants et comment les résoudre.
"La vérification des informations d'identification a échoué"
Vérifiez à nouveau que vous avez copié la valeur complète des informations d'identification sans espaces à la fin. Assurez-vous que la clé/le jeton API n'a pas été révoqué ou expiré. Pour Twilio, le SID du compte doit commencer par « AC ». Pour Stripe, Secret Key commence par « sk_live_ » ou « sk_test_ ».
"Les messages WhatsApp n'arrivent pas"
Vérifiez la configuration de votre webhook dans le tableau de bord Meta/Gupshup : l'URL doit correspondre exactement à celle fournie par Engium. Vérifiez que vous êtes abonné aux événements « messages ». Vérifiez également que vous avez utilisé un jeton d'utilisateur système permanent (et non le jeton de test de 24 heures).
"Les appels ne se connectent pas via Twilio"
Assurez-vous que la fonctionnalité vocale de votre numéro Twilio est activée. Vérifiez que votre compte dispose d'un solde suffisant (les comptes d'essai ne peuvent appeler que des numéros vérifiés). Vérifiez que l'URL du webhook est accessible – consultez Twilio Console → Monitor → Logs pour les détails de l'erreur.
"Exotel KYC prend trop de temps"
Exotel KYC prend généralement 1 à 2 jours ouvrables. Assurez-vous que tous les documents (PAN, certificat TPS, justificatif d’adresse professionnelle) sont clairs et lisibles. Contactez le support Exotel à support@exotel.com si cela prend plus de 3 jours.
"Les e-mails deviennent du spam"
Configurez les enregistrements DNS SPF, DKIM et DMARC pour votre domaine. Utilisez la fonction d'authentification de domaine de votre fournisseur (SendGrid → Authentification de l'expéditeur, Mailgun → Vérification du domaine). AWS SES : demandez un accès en production pour quitter le mode sandbox.
"Google Agenda ne se synchronise pas"
Déconnectez et reconnectez le calendrier dans Paramètres → Calendrier. Assurez-vous d'avoir sélectionné le bon calendrier lors de la configuration. Vérifiez que l'accès à l'API du calendrier est activé sur le compte Google. La synchronisation peut prendre jusqu'à 30 secondes pour les nouveaux événements.
"Échec des paiements Stripe"
Vérifiez que vous utilisez le bon type de clé (live vs test). Vérifiez que votre compte Stripe est entièrement activé et la vérification commerciale est terminée. Pour les problèmes de webhook, consultez Stripe Dashboard → Développeurs → Webhooks → sélectionnez le point de terminaison → consultez les tentatives récentes et les détails des erreurs.