Canaux (boîtes de réception)

Les canaux : vue d'ensemble

À quoi ça sert Un canal, c'est tout simplement un moyen pour vos clients de vous écrire. Chaque canal devient une boîte de réception dans Madyis Hub. Que vos clients vous contactent par e-mail, par WhatsApp, par le chat de votre site ou par Messenger, tous les messages arrivent au même endroit. Fini de jongler entre dix applications. Vous pouvez avoir plusieurs boîtes de réception Rien ne vous limite à un seul canal. Vous pouvez créer une boîte pour votre site, une autre pour WhatsApp, une autre pour vos e-mails, etc. Chaque boîte de réception est indépendante. Ce que vous réglez pour chaque canal - Un agent IA dédié, qui peut répondre automatiquement à votre place. - Des agents humains (les membres de votre équipe) affectés à cette boîte. - Des heures d'ouverture propres à ce canal. Comment ajouter une boîte de réception 1. Allez dans Réglages → Boîtes de réception. 2. Cliquez sur Ajouter une boîte de réception. 3. Choisissez le type de canal (Site web, E-mail, WhatsApp, Telegram, etc.). 4. Renseignez les informations demandées selon le canal choisi. 5. Ajoutez les agents (humains et/ou IA) qui géreront cette boîte. 6. Terminez : votre canal est prêt à recevoir des messages. Astuce : chaque type de canal a son propre article d'aide dans cette catégorie. Reportez-vous-y pour les étapes détaillées.

Widget de chat sur votre site web

À quoi ça sert Le widget de chat est cette petite bulle qui apparaît en bas de votre site. Vos visiteurs cliquent dessus pour vous écrire en direct. C'est le moyen le plus simple de transformer un visiteur en client : il pose sa question, vous (ou votre agent IA) répondez tout de suite. Créer la boîte « Site web » 1. Allez dans Réglages → Boîtes de réception → Ajouter une boîte de réception. 2. Choisissez Site web. 3. Donnez un nom à la boîte (ex. « Chat du site »). 4. Indiquez l'adresse de votre site (l'URL de votre domaine). 5. Choisissez la couleur du widget, le titre de bienvenue et le message de bienvenue. 6. Activez si besoin le message d'accueil automatique. 7. Validez : Madyis Hub génère un code à copier. Installer le code sur votre site 1. Copiez le code fourni à la fin de la création. 2. Collez-le dans votre site, juste avant la balise de fin de page (votre éditeur de site ou votre développeur sait où la placer). 3. Si vous avez une boutique Shopify, vous pouvez installer le chat via l'application Shopify de Madyis Hub, sans toucher au code. Personnaliser le chat Après la création, ouvrez la boîte dans Réglages → Boîtes de réception et ajustez : - La couleur et la position du widget. - Le message d'accueil affiché à l'ouverture. - L'avatar et le nom affichés aux visiteurs. - Le formulaire pré-chat (demander le nom ou l'e-mail avant de discuter). - Les heures d'ouverture du chat. - L'agent IA assigné, qui peut répondre automatiquement. Astuce : testez le chat sur votre site une fois le code installé, pour vérifier que les messages arrivent bien dans Madyis Hub.

Connecter une boîte e-mail

À quoi ça sert Vos clients vous écrivent déjà par e-mail ? Connectez votre boîte e-mail à Madyis Hub : chaque e-mail reçu devient une conversation, et vos réponses partent depuis votre adresse habituelle. Toute votre équipe travaille au même endroit, sans se renvoyer les messages. Les méthodes de connexion Au moment de créer la boîte, vous choisissez l'une de ces options : - Microsoft 365 / Outlook — connexion simplifiée en vous identifiant avec votre compte Microsoft. - Google / Gmail — connexion simplifiée en vous identifiant avec votre compte Google. - Autre fournisseur (IMAP / SMTP) — pour toute autre messagerie : vous saisissez les réglages techniques de votre hébergeur. Étapes 1. Allez dans Réglages → Boîtes de réception → Ajouter une boîte de réception. 2. Choisissez E-mail. 3. Sélectionnez votre fournisseur : Microsoft, Google ou Autre fournisseur. 4. Pour Microsoft ou Google : cliquez pour vous connecter et autorisez l'accès à votre messagerie. 5. Pour un autre fournisseur : renseignez les réglages IMAP (réception) et SMTP (envoi) — serveur, port, identifiant et mot de passe, fournis par votre hébergeur e-mail. 6. Validez, puis ajoutez les agents qui géreront cette boîte. Astuce : si vous ne connaissez pas vos réglages IMAP/SMTP, ils figurent dans l'espace d'aide de votre hébergeur e-mail (souvent sous « Configuration d'un logiciel de messagerie »).

Connecter WhatsApp

ℹ️ Bientôt disponible — La connexion « 1 clic » (Embedded Signup) qui relie WhatsApp en quelques secondes est en attente de validation par Meta. En attendant, utilisez la méthode manuelle ci-dessous : elle fonctionne dès maintenant. À quoi ça sert WhatsApp est l'application de messagerie préférée de millions de clients. En connectant votre numéro WhatsApp Business à Madyis Hub, les messages de vos clients arrivent dans votre boîte de réception, et votre agent IA ou votre équipe peut y répondre. Ce qu'il vous faut La méthode disponible aujourd'hui est WhatsApp Cloud API. Depuis votre compte Meta, vous récupérez : - Votre numéro WhatsApp Business (au format international, ex. +33…). - L'identifiant du numéro de téléphone (Phone Number ID). - L'identifiant du compte WhatsApp Business (WABA ID). - Un jeton d'accès Meta (token). Étapes 1. Sur Meta for Developers, créez une application de type « Entreprise » et ajoutez le produit « WhatsApp ». 2. Dans la Configuration de l'API WhatsApp, ajoutez et vérifiez votre numéro, puis copiez le Phone Number ID et le WABA ID. 3. Créez un jeton d'accès permanent avec les autorisations WhatsApp et copiez-le. 4. Dans Madyis Hub : Réglages → Boîtes de réception → Ajouter une boîte de réception → WhatsApp. 5. Remplissez : nom de la boîte, numéro, Phone Number ID, WABA ID et jeton d'accès. Cliquez sur Créer. 6. Ouvrez l'onglet Configuration de la boîte et copiez l'URL de webhook et le token de vérification. 7. Retournez dans Meta → WhatsApp → Configuration → Webhooks : collez l'URL et le token, puis abonnez-vous au champ « messages ». Astuce : bloqué sur une étape ? Demandez à l'assistant en bas à droite de votre tableau de bord.

Connecter Telegram

À quoi ça sert Telegram permet à vos clients de vous écrire via un bot (un robot de discussion à votre nom). Une fois connecté à Madyis Hub, chaque message envoyé à votre bot arrive dans votre boîte de réception. La connexion est immédiate. Étapes 1. Sur Telegram, ouvrez une conversation avec @BotFather (le bot officiel de création de bots). 2. Envoyez la commande /newbot et suivez les instructions : donnez un nom puis un nom d'utilisateur à votre bot. 3. @BotFather vous renvoie un token (une longue suite de caractères). Copiez-le. 4. Dans Madyis Hub : Réglages → Boîtes de réception → Ajouter une boîte de réception → Telegram. 5. Collez le token du bot dans le champ prévu. 6. Validez : la boîte est créée immédiatement. Ajoutez ensuite les agents qui la géreront. Astuce : gardez votre token secret. Toute personne qui le possède peut contrôler votre bot.

Connecter LINE

À quoi ça sert LINE est une application de messagerie très utilisée, notamment en Asie. En connectant votre canal LINE à Madyis Hub, les messages de vos clients LINE arrivent dans votre boîte de réception, aux côtés de vos autres canaux. Ce qu'il vous faut Depuis la console développeur de LINE (LINE Developers), récupérez les identifiants de votre canal LINE : - L'identifiant du canal (Channel ID). - Le secret du canal (Channel Secret). - Le jeton d'accès du canal (Channel Access Token). Étapes 1. Allez dans Réglages → Boîtes de réception → Ajouter une boîte de réception → LINE. 2. Donnez un nom à la boîte de réception. 3. Renseignez l'identifiant du canal, le secret du canal et le jeton d'accès du canal. 4. Validez, puis ajoutez les agents qui géreront cette boîte. Astuce : conservez ces identifiants en lieu sûr. Ils donnent accès à votre canal LINE.

Connecter le SMS

À quoi ça sert Le SMS reste un canal direct et lu par presque tout le monde. En connectant un fournisseur SMS à Madyis Hub, vous recevez les SMS de vos clients dans votre boîte de réception et vous y répondez comme à n'importe quel autre message. Deux fournisseurs possibles Au moment de créer la boîte, vous choisissez votre fournisseur : Twilio ou Bandwidth. Vous devez avoir un compte chez l'un d'eux. Option 1 — Twilio 1. Allez dans Réglages → Boîtes de réception → Ajouter une boîte de réception → SMS. 2. Choisissez le fournisseur Twilio. 3. Donnez un nom à la boîte. 4. Indiquez votre numéro de téléphone Twilio (au format international, ex. +33…). 5. Renseignez votre Account SID et votre jeton d'authentification (Auth Token), disponibles dans votre tableau de bord Twilio. 6. Validez. Option 2 — Bandwidth 1. Dans la même étape, choisissez le fournisseur Bandwidth. 2. Renseignez le nom de la boîte, votre numéro, ainsi que les identifiants Bandwidth : Account ID, Application ID, clé API et secret API. 3. Validez, puis ajoutez les agents. Astuce : vos identifiants Twilio ou Bandwidth se trouvent dans le tableau de bord de votre fournisseur. Gardez-les confidentiels.

Le canal API

À quoi ça sert Le canal API est destiné aux développeurs. Il vous permet de brancher sur Madyis Hub n'importe quelle source de messages qui n'a pas de connecteur dédié : une application maison, un canal interne, un service tiers, etc. Vos messages entrent et sortent par l'API de Madyis Hub. Pour qui Cette option suppose un minimum de développement. Si vous n'êtes pas technique, les autres canaux (Site web, E-mail, WhatsApp…) couvrent la plupart des besoins sans code. Étapes 1. Allez dans Réglages → Boîtes de réception → Ajouter une boîte de réception → API. 2. Donnez un nom à la boîte de réception. 3. Indiquez si besoin une URL de webhook : Madyis Hub y enverra les messages sortants pour que votre système les transmette à votre client. Ce champ est facultatif. 4. Validez, puis ajoutez les agents. Ensuite Une fois la boîte créée, votre application utilise l'API de Madyis Hub pour envoyer les messages entrants (de votre client vers Madyis Hub) et, via le webhook, pour recevoir les messages sortants (de Madyis Hub vers votre client). Reportez-vous à la documentation API pour les points d'entrée exacts. Astuce : l'URL de webhook doit commencer par http(s). Vous pourrez la modifier plus tard dans les réglages de la boîte.

Connecter Facebook Messenger

ℹ️ Bientôt disponible — La connexion fonctionne dès maintenant pour vos comptes de test. L'ouverture au grand public nécessite la validation « Advanced Access » de Meta, en cours. À quoi ça sert De nombreux clients vous contactent via Messenger depuis votre Page Facebook. En connectant votre Page à Madyis Hub, ces messages arrivent dans votre boîte de réception, et votre équipe ou votre agent IA peut y répondre sans ouvrir Facebook. Ce qu'il vous faut - Une Page Facebook dont vous êtes administrateur. - Un compte Facebook autorisé à gérer cette Page. Étapes 1. Allez dans Réglages → Boîtes de réception → Ajouter une boîte de réception → Facebook. 2. Cliquez pour vous connecter avec Facebook et autorisez l'accès demandé. 3. Dans la liste, choisissez la Page à connecter. 4. Donnez un nom à la boîte de réception (par défaut, le nom de la Page). 5. Validez : la boîte est créée. Ajoutez ensuite les agents qui la géreront. Astuce : vous pouvez connecter plusieurs Pages, chacune dans sa propre boîte de réception.

Connecter Instagram

ℹ️ Bientôt disponible — La connexion fonctionne dès maintenant pour vos comptes de test. L'ouverture au grand public nécessite la validation « Advanced Access » de Meta, en cours (même statut que Facebook Messenger). À quoi ça sert Les messages directs (DM) que vous recevez sur Instagram peuvent arriver directement dans Madyis Hub. Plus besoin d'ouvrir l'application Instagram : votre équipe ou votre agent IA répond depuis votre boîte de réception. Comment ça marche Les DM Instagram arrivent dans Madyis Hub en passant par la Page Facebook liée à votre compte Instagram professionnel. Concrètement : on connecte Facebook, et Instagram suit automatiquement. Vous devez donc disposer : - D'un compte Instagram professionnel (Business ou Créateur). - D'une Page Facebook liée à ce compte Instagram. Étapes 1. Vérifiez que votre compte Instagram est bien lié à votre Page Facebook (dans les paramètres de votre Page Facebook). 2. Dans Madyis Hub : Réglages → Boîtes de réception → Ajouter une boîte de réception → Facebook. 3. Connectez-vous avec Facebook et autorisez l'accès : l'autorisation couvre aussi les messages Instagram de la Page. 4. Choisissez la Page liée à votre Instagram, puis validez. Astuce : si vos DM Instagram n'arrivent pas, vérifiez d'abord que le compte Instagram est correctement lié à la Page Facebook côté Facebook.

Connecter TikTok

ℹ️ Bientôt disponible — La connexion TikTok est prête côté Madyis Hub mais reste en attente d'approbation de TikTok. Elle sera activée dès que TikTok aura validé l'accès. À quoi ça sert TikTok devient un canal de contact à part entière pour de nombreuses marques. L'objectif est de faire arriver les messages TikTok directement dans votre boîte de réception Madyis Hub, pour que votre équipe ou votre agent IA y réponde au même endroit que vos autres canaux. Comment ça marchera 1. Allez dans Réglages → Boîtes de réception → Ajouter une boîte de réception → TikTok. 2. Cliquez pour continuer avec TikTok et connectez votre compte. 3. Autorisez l'accès demandé. 4. La boîte de réception est créée : ajoutez ensuite les agents qui la géreront. Astuce : revenez consulter cet article ou surveillez vos annonces produit : nous vous préviendrons dès que TikTok sera disponible pour tous.

Personnaliser le widget : couleur, forme, taille et icône de la bulle

Au-delà de la couleur, vous pouvez adapter finement l'apparence du widget de chat à votre marque. Allez dans Réglages → Boîtes de réception → (votre boîte Site web) → Paramètres (un aperçu en direct s'affiche à droite). La bulle de chat - Couleur : la couleur principale du widget. - Forme de la bulle : ronde, arrondie ou carrée. - Taille de la bulle : petite, moyenne ou grande. - Icône de la bulle : chat, point d'interrogation, smiley, casque, enveloppe ou cœur. - Position : à gauche ou à droite de l'écran. - Texte du lanceur : un petit libellé à côté de la bulle (ex. « Une question ? »). L'en-tête et l'accueil - Titre de bienvenue et slogan. - Message d'accueil (activable) : le premier message automatique. - Délai de réponse affiché aux visiteurs (« en quelques minutes / heures / un jour »). - Nom de l'expéditeur : votre nom amical ou le nom de l'entreprise. Bon à savoir : si un changement « ne se voit pas » sur votre site, c'est souvent le cache du site (service worker / PWA) qui sert l'ancienne version — pas un bug. Forcez le rechargement.

Le formulaire pré-chat : collecter les infos avant la conversation

Le formulaire pré-chat demande quelques informations au visiteur avant de démarrer la conversation (par exemple son e-mail), pour pouvoir le recontacter et qualifier la demande. L'activer et le configurer 1. Allez dans Réglages → Boîtes de réception → (boîte Site web) → Formulaire pré-chat. 2. Activez le formulaire. 3. Rédigez le message d'introduction affiché au-dessus du formulaire. 4. Pour chaque champ : activez-le, rendez-le obligatoire ou non, et personnalisez le libellé et le texte d'aide. Vous pouvez réordonner les champs. Champs par défaut : E-mail, Nom complet, Téléphone. Vous pouvez aussi ajouter vos attributs personnalisés. Bon à savoir : demandez le minimum (souvent juste l'e-mail) pour ne pas décourager le visiteur. Plus le formulaire est court, plus il est rempli.

Restreindre et sécuriser le widget : domaines autorisés et identité (HMAC)

Vous pouvez contrôler où votre widget se charge et garantir l'identité de vos visiteurs connectés. Allez dans Réglages → Boîtes de réception → (boîte Site web) → Configuration. Domaines autorisés Indiquez la liste des domaines autorisés à charger le widget. Le widget refusera de s'afficher ailleurs — utile pour éviter qu'il soit copié sur un autre site. Validation d'identité (HMAC) Si vous identifiez vos visiteurs (clients connectés sur votre site), activez la validation d'identité. Vous signez l'identifiant du visiteur avec votre clé secrète HMAC (affichée ici) : Madyis Hub vérifie ainsi qu'un visiteur ne peut pas usurper l'identité d'un autre. Bon à savoir : la validation d'identité est recommandée dès que le widget est utilisé par des utilisateurs connectés (espace client, application).

WhatsApp : configuration manuelle avancée (numéro, jeton, webhook)

En plus de la connexion en 1 clic (Embedded Signup), vous pouvez connecter WhatsApp manuellement — utile si vous gérez déjà votre numéro côté Meta. La connexion manuelle (WhatsApp Cloud) 1. Allez dans Réglages → Boîtes de réception → WhatsApp → choisissez WhatsApp Cloud → lien de configuration manuelle. 2. Renseignez : - Nom de la boîte - Numéro de téléphone (format international, ex. +33…) - Phone number ID (identifiant numérique, fourni par Meta) - WhatsApp Business Account ID (identifiant numérique) - Jeton d'accès à l'API 3. Créez la boîte. 4. À l'écran final, copiez l'URL du webhook et le jeton de vérification dans votre application Meta, et abonnez-vous à l'événement « messages ». Un guide pas à pas multilingue est intégré au-dessus du formulaire (avec un lien direct vers Meta for Developers). Et via Twilio ? Si votre WhatsApp passe par Twilio, choisissez le fournisseur Twilio et renseignez vos identifiants Twilio. Bon à savoir : votre propre numéro WhatsApp fonctionne pour de vrais clients dès maintenant. Surveillez sa qualité dans l'onglet Account Health de la boîte.

Configurer IMAP et SMTP pour votre boîte e-mail

Pour relever et envoyer des e-mails depuis votre propre adresse (au-delà de Gmail/Outlook en 1 clic), configurez IMAP et SMTP. Allez dans Réglages → Boîtes de réception → (boîte e-mail) → Configuration. IMAP (réception) Activez IMAP, puis renseignez : Adresse du serveur, Port, Identifiant, Mot de passe, SSL activé, et le mécanisme d'authentification. Exemple Gmail : serveur imap.gmail.com, port 993, SSL activé, avec un mot de passe d'application (pas votre mot de passe habituel). SMTP (envoi) Une fois IMAP activé, la section SMTP apparaît : Adresse du serveur, Port, Identifiant, Mot de passe, Domaine, Chiffrement (SSL/TLS ou STARTTLS). Bon à savoir : pour Gmail, n'utilisez pas le bouton « Se connecter avec Google » si l'OAuth n'est pas configuré — passez par le formulaire IMAP/SMTP manuel avec un mot de passe d'application.

Régler une boîte de réception : agents, attribution, IA, CSAT et horaires

Chaque boîte de réception a ses propres réglages, accessibles via Réglages → Boîtes de réception → (votre boîte), organisés en onglets. Les réglages clés - Collaborateurs : quels agents traitent cette boîte. Activez l'attribution automatique (round-robin) pour répartir les conversations, avec une limite par agent si besoin. - Heures d'ouverture : fuseau horaire, créneaux par jour, et message d'absence. - CSAT (satisfaction) : activez l'enquête envoyée à la résolution (notation par emoji ou étoiles), avec des règles par étiquette. - Configuration du bot : branchez un agent IA sur la boîte pour qu'il réponde automatiquement. - Paramètres : message d'accueil, nom de l'expéditeur, continuité de conversation, et centre d'aide lié. Bon à savoir : pour que votre agent IA réponde sur une boîte, il faut le brancher dans Configuration du bot (ou depuis la section Agents IA → onglet Canaux).

Connecter WhatsApp via Twilio

Vous pouvez recevoir et répondre à vos messages WhatsApp directement dans Madyis Hub en passant par Twilio. Comptez environ 10 minutes. Suivez les étapes dans l'ordre. ⚠️ Le point le plus important : contrairement à d'autres canaux, la connexion WhatsApp via Twilio n'est pas 100 % automatique. Il faut coller une URL (le « webhook ») dans Twilio, sinon les messages reçus n'arrivent jamais dans Madyis Hub. C'est l'étape 3 ci-dessous, et c'est la cause n°1 des messages qui « ne s'affichent pas ». Avant de commencer - Un compte Twilio avec WhatsApp activé (un numéro WhatsApp approuvé, ou le bac à sable « Sandbox » pour tester). - Vos identifiants Twilio : Account SID et Auth Token, visibles sur la page d'accueil de la console Twilio. Étape 1 — Créer la boîte de réception dans Madyis Hub 1. Allez dans Boîtes & canaux → Ajouter un canal → WhatsApp, puis choisissez Twilio. 2. Renseignez : - le nom de la boîte de réception (ex. « Support WhatsApp ») ; - votre numéro WhatsApp au format international (ex. +33612345678, sans espace) ; - votre Account SID et votre Auth Token. 3. Cliquez sur Créer le canal. Étape 2 — Copier l'URL de callback Juste après la création, Madyis Hub affiche une URL de callback. Vous la retrouvez aussi à tout moment dans l'onglet Configuration de la boîte de réception. Elle ressemble à : https://madyishub.io/twilio/callback Copiez-la. C'est elle qui indique à Twilio où livrer les messages que vos clients vous envoient. Étape 3 — Coller l'URL dans Twilio (l'étape à ne pas oublier) Dans la console Twilio, ouvrez la configuration de votre expéditeur WhatsApp : Messaging → Senders → WhatsApp senders → votre numéro. Repérez la section « Messaging Endpoint Configuration » et remplissez : - Webhook URL for incoming messages : collez l'URL de callback copiée à l'étape 2. - Webhook method for incoming messages : HTTP Post. - Status callback URL (optionnel) : https://madyishub.io/twilio/delivery_status — pour recevoir les accusés de livraison (envoyé / lu). - Messaging service : laissez vide si vous n'en utilisez pas. Cliquez sur Save. Le champ « Profile about » que Twilio peut vous demander est simplement le petit texte de description de votre profil WhatsApp (cosmétique, texte libre, ~139 caractères). Par exemple : « Support — réservations et questions ». Il n'a aucun impact sur la réception des messages. Étape 4 — Tester Depuis un téléphone, envoyez un message WhatsApp vers votre numéro. En quelques secondes, il doit apparaître comme une nouvelle conversation dans la boîte de réception que vous venez de créer. Cas particulier : le bac à sable (Sandbox) Twilio Le Sandbox sert à tester avant d'avoir un numéro WhatsApp approuvé : - Depuis votre téléphone, rejoignez d'abord le Sandbox : envoyez join <votre-code> au numéro du Sandbox indiqué par Twilio. - Mettez l'URL de callback dans les réglages du Sandbox, champ « When a message comes in ». - Dans Madyis Hub, le numéro de la boîte doit être le numéro du Sandbox (souvent +14155238886), pas votre vrai numéro. Ça ne marche toujours pas ? - Vérifiez que l'URL de callback est exacte et bien en HTTP Post. - Vérifiez que le numéro de la boîte correspond exactement à votre numéro Twilio (format international +…, sans espace). - Si vous utilisez un Messaging Service Twilio : mettez plutôt l'URL de callback dans la configuration de ce service (onglet Integration → Incoming Messages), puis renseignez son Messaging Service SID au moment de créer la boîte. - Bloqué sur une étape ? Posez votre question à l'assistant en bas à droite de votre tableau de bord.