# Viber Connectez votre propre **bot Viber** afin que vos conversations Viber soient centralisées dans l'application et qu'un agent IA puisse y répondre. Il vous suffit de coller une valeur (le jeton d'authentification de votre bot) et nous nous occupons du reste de la configuration pour vous. --- ## Qu'est-ce que l'intégration Viber ? L'intégration Viber relie un **bot Viber** que vous possédez à la plateforme en utilisant l'API officielle des bots de Viber, le système propre à Viber pour envoyer et recevoir des messages automatiquement, au lieu que vous ayez à les saisir manuellement. Les conversations entre votre bot et ses abonnés deviennent disponibles dans l'application, et un agent IA ainsi qu'une boîte de réception partagée peuvent alors les gérer. Il s'agit d'une intégration **officielle**, elle est donc stable et conforme aux règles de Viber. > **Disponibilité.** Viber est principalement utilisé aux Philippines, au Vietnam et dans d'autres régions d'Asie du Sud-Est, ainsi qu'en Europe de l'Est et en Grèce. --- ## Avant de commencer **Vous devez posséder votre propre bot Viber, et Viber ne délivre des bots que dans le cadre d'un forfait professionnel payant.** Depuis février 2024, Viber ne crée plus de bots gratuits. Vous configurez le compte directement auprès de Viber, et ce compte ainsi que ses frais restent une affaire entre vous et Viber. Nous ne le revendons pas, n'appliquons aucune majoration, ne prenons aucune commission et nous ne pouvons pas créer le bot en votre nom. Au moment de la rédaction de ce document, Viber facture des frais mensuels par bot ainsi que des frais par message pour les messages initiés par votre bot (voir [Coût](#cost) ci-dessous). Vérifiez les conditions actuelles de Viber lors de votre inscription, car leur tarification peut être modifiée à leur discrétion. Il n'existe pas de formulaire d'inscription en libre-service. Viber examine manuellement chaque demande de chatbot, et vous pouvez postuler de deux manières : - **Via un partenaire Viber vérifié**, ce qui est la méthode recommandée par Viber et généralement la plus rapide. - **Directement auprès de Viber**, en envoyant un e-mail à `partners@viber.com`. Si vous travaillez déjà avec Viber, votre responsable de compte professionnel peut initier la procédure à votre place. Une fois votre demande approuvée, vous signez l'accord de Viber et acceptez leurs conditions commerciales, puis votre bot est créé. Ensuite, vous trouverez son jeton dans l'application Viber sous **Plus → Paramètres → Bots → Modifier les informations → Votre clé d'application**. Viber l'appelle votre *clé d'application* ; leur documentation API appelle la même valeur un *jeton d'authentification*, et les administrateurs de bots peuvent également le voir dans le panneau d'administration de Viber. Quel que soit son nom, c'est la seule valeur demandée par cette application. Ce jeton est la seule chose dont vous avez besoin de la part de Viber. La configuration ici prend environ une minute. --- ## Configuration de Viber ### Étape 1 : Copiez le jeton d'authentification de votre bot L'endroit le plus rapide pour le trouver est l'application Viber sur votre téléphone. 1. Ouvrez Viber sur le téléphone dont le compte possède le bot. 2. Allez dans **Plus → Paramètres → Bots**. 3. Sélectionnez votre bot et appuyez sur **Modifier les informations**. 4. Copiez la valeur affichée sous **Votre clé d'application**. C'est le jeton. > Gardez ce jeton privé. Toute personne le possédant peut envoyer des messages en tant que votre bot. ### Étape 2 : Connectez Viber dans l'application 1. Dans la barre latérale gauche, cliquez sur **Paramètres** près du bas. 2. Dans le menu de gauche des paramètres, sous **Canaux**, cliquez sur **Canaux**. 3. Trouvez la carte **Viber** et cliquez sur **Connecter**. 4. Collez votre **jeton d'authentification**. 5. Cliquez sur **Connecter**. 6. L'application vérifie le jeton auprès de Viber et affiche **"Connecté à : \"**. **Il n'y a pas de webhook à configurer.** Contrairement à la plupart des autres canaux, nous enregistrons tout auprès de Viber pour vous lors de la connexion ; il n'y a donc rien à copier dans une autre console. L'écran de connexion affiche l'adresse à laquelle vos messages arrivent uniquement pour que vous puissiez la partager avec le support si nécessaire. ### Étape 3 : Tester le bot 1. Depuis un autre téléphone, ouvrez Viber et **suivez votre bot** (recherchez-le ou utilisez son lien). 2. **Envoyez-lui un message.** 3. Ouvrez l'application et accédez à **Discussions**. Le message entrant apparaît dans la liste des conversations. 4. Si un agent IA gère ce canal, vous le verrez **répondre automatiquement**. Une fois connecté, votre bot Viber s'affiche comme **Connecté** sur la page Canaux et l'IA répond aux messages entrants. --- ## Qui votre bot peut contacter C'est le point le plus important à comprendre concernant Viber, et il diffère de tous les autres canaux : **Votre bot ne peut envoyer de messages qu'aux personnes qui le suivent.** Quelqu'un doit trouver votre bot et le suivre avant que vous puissiez lui envoyer quoi que ce soit. Il n'y a aucun moyen d'envoyer un message à un utilisateur Viber qui n'a pas suivi votre bot au préalable. Si quelqu'un se désabonne ou bloque votre bot, vous ne pouvez plus lui envoyer de messages tant qu'il ne vous suit pas et ne vous envoie pas de message. Lorsque cela se produit, l'application marque la conversation pour arrêter les tentatives, et toute réponse que vous envoyez s'affiche comme ayant échoué avec une explication plutôt que de disparaître silencieusement. Pour cette raison, Viber fonctionne très bien comme **canal de support et de réponse** (quelqu'un vous envoie un message, l'IA répond) et mal comme canal de prospection à froid. --- ## Coût Viber est un canal **gratuit** dans l'application : aucun frais par message et aucuns frais de connexion mensuels de notre part. Vos coûts proviennent de **Viber**, sur votre propre compte : - Des **frais mensuels par bot** (environ 100 € au moment de la rédaction). - **Les réponses au sein d'une conversation initiée par quelqu'un sont gratuites et illimitées.** Cela couvre presque tout ce qu'un agent IA fait. - **Les messages initiés par votre bot**, en dehors d'une conversation commencée par la personne, sont facturés par message à un tarif qui dépend du pays du destinataire. En pratique : répondre aux gens ne vous coûte rien au-delà des frais mensuels. Ce sont les diffusions et les suivis proactifs qui font grimper la facture. --- ## Messages multimédias Les photos, vidéos, fichiers, autocollants, emplacements et contacts partagés entrants sont reconnus afin que l'IA sache que du contenu multimédia a été envoyé (une courte note est ajoutée à la conversation). Les réponses sortantes de l'IA sont du **texte et des images** dans cette version. Les réponses longues sont automatiquement tronquées pour respecter la limite de 7 000 caractères de Viber. --- ## Gestion de session ### Vérification de l'état de la connexion L'état de votre connexion Viber est affiché sur la carte **Viber** de la page **Canaux** : | État | Signification | |---|---| | **Connecté** | Un bot Viber est lié à ce compte | | **Connecté, action requise** | Un autre outil a pris le contrôle de votre bot ; les messages ne nous parviennent pas | | **Non connecté** | Aucune connexion configurée | La carte vérifie à nouveau votre bot chaque fois que vous ouvrez la page Canaux. **Un bot Viber ne peut envoyer ses messages qu'à un seul endroit à la fois** ; par conséquent, si vous connectez le même bot à un autre outil, cet outil prend le relais et vos messages cessent d'arriver ici, sans avertissement de la part de Viber. C'est ce que signifie **« Connecté, action requise »**. Ouvrez la carte et reconnectez-vous pour reprendre la main. ### Déconnexion Ouvrez la carte **Viber** et cliquez sur **Gérer**, puis cliquez sur **Déconnecter** et confirmez **Supprimer Viber ?**. Cela nous empêche de recevoir les messages du bot et le supprime de votre compte. Votre bot reste votre propriété. Rien ne change sur votre compte Viber. --- ## Limitations - **Abonnés uniquement.** Votre bot ne peut envoyer des messages qu'aux personnes qui le suivent. Voir [Qui votre bot peut contacter](#who-your-bot-can-message). - **Vous avez besoin de votre propre bot Viber payant.** Nous ne pouvons pas en fournir un. - **Un bot par connexion.** Connectez chaque bot séparément ; un bot ne peut être lié qu'à un seul compte. - **Envoi de texte + image.** L'IA répond avec du texte et des images ; les carrousels et les cartes enrichies ne sont pas envoyés dans cette version. - **Pas de message de bienvenue.** Lorsqu'une personne ouvre votre bot pour la première fois mais ne l'a pas encore suivi, Viber autorise un message d'accueil instantané unique. Cette version n'en envoie pas. La conversation commence lorsqu'ils envoient leur premier message. --- ## Dépannage ### Jeton rejeté lors de la connexion - Assurez-vous d'avoir copié la valeur depuis **Modifier les informations → Votre clé d'application** dans l'application Viber, et non un identifiant différent. - Vérifiez que votre bot est toujours actif sur votre compte Viber. - La connexion vérifie également que Viber peut nous joindre. Si votre jeton est certainement correct et que cela échoue toujours, attendez une minute et réessayez, puis contactez le support. ### « Ce bot Viber est déjà connecté à un autre compte » Le même bot est lié à un compte différent dans l'application. Déconnectez-le d'abord là-bas, ou utilisez un bot différent. ### Le bot ne répond pas - Confirmez que la carte affiche **Connecté**, et non **Connecté, action requise**. - Confirmez que la personne avec qui vous effectuez le test a **suivi votre bot**. Viber ne distribue les messages qu'aux abonnés. - Vérifiez qu'un agent IA est affecté à ce canal. ### Les messages ont cessé d'arriver Il s'agit presque toujours du problème de prise de contrôle décrit dans [Vérification de l'état de la connexion](#checking-connection-status) : le même bot a été connecté à un autre outil. Ouvrez la carte **Viber** et reconnectez-vous. ### Une réponse a échoué avec « Non abonné » La personne s'est désabonnée ou a bloqué votre bot. Vous ne pouvez pas lui envoyer de message tant qu'elle ne s'est pas réabonnée et qu'elle ne vous a pas envoyé de message en premier. --- ## Bonnes pratiques - **Privilégiez le support plutôt que la prospection.** Les réponses au sein d'une conversation initiée par quelqu'un sont gratuites et illimitées ; les messages que vous initiez sont facturés et n'atteignent que les abonnés. - **Facilitez le suivi de votre bot.** Placez son lien sur votre site, dans votre signature d'e-mail et sur vos autres canaux. Le suivre est le seul moyen pour les gens de l'atteindre. - **Gardez votre jeton d'authentification en sécurité.** Toute personne le possédant peut envoyer des messages en tant que votre bot. Régénérez-le dans l'application Viber s'il fuit, puis reconnectez-vous ici. - **Ne connectez pas le même bot à deux outils.** Le second prend silencieusement le relais.