# LINE Connectez votre propre **compte officiel LINE** afin que vos conversations LINE soient transmises à l'application et qu'un agent IA puisse y répondre. Vous vous connectez en collant vos identifiants de l'API Messaging de LINE (secret du canal + jeton d'accès) et en définissant une URL de webhook — aucune programmation requise. --- ## Qu'est-ce que l'intégration LINE ? L'intégration LINE relie un **compte officiel LINE (OA)** que vous possédez à la plateforme en utilisant l'API Messaging officielle de LINE — le système propre à LINE pour envoyer et recevoir des messages automatiquement, au lieu de les saisir manuellement dans l'application LINE. Vos discussions individuelles avec les personnes ayant ajouté votre OA en tant qu'ami deviennent disponibles dans l'application, et un agent IA, des diffusions et une boîte de réception partagée peuvent être utilisés par-dessus. Contrairement à Telegram ou WhatsApp Web, il s'agit d'une intégration **officielle** — elle utilise l'API Messaging propre à LINE, elle est donc stable et respecte les règles de LINE. Comme LINE ne propose pas de bouton « connecter » en un clic pour les outils tiers, vous devez coller les identifiants de votre OA une seule fois lors de la configuration. > **Disponibilité.** Les comptes officiels LINE sont principalement utilisés au Japon, à Taïwan, en Thaïlande et en Indonésie, et ne sont **pas disponibles dans l'UE**. Vous devez disposer d'un compte officiel LINE enregistré dans une région prise en charge pour utiliser ce canal. --- ## Avant de commencer Vous devrez créer (ou utiliser) trois éléments dans les consoles de LINE. Il s'agit d'une configuration unique d'environ 5 minutes. 1. Un **compte officiel LINE** (créé dans le [LINE Official Account Manager](https://manager.line.biz)). Si vous n'en avez pas encore, connectez-vous avec votre identifiant LINE Business et **créez un nouveau compte** — donnez-lui un nom et remplissez le court formulaire. 2. Un **canal API Messaging** pour cet OA. Le moyen le plus simple est de l'activer depuis le gestionnaire OA (voir l'étape 1 ci-dessous) — vous n'avez pas besoin de créer le canal manuellement dans la console des développeurs au préalable. Lorsque vous y êtes invité, choisissez un **fournisseur** existant ou créez-en un nouveau. 3. Depuis ce canal, trois valeurs que vous collerez dans l'application : - **ID du canal** (onglet Paramètres de base) — facultatif, informatif uniquement - **Secret du canal** (onglet Paramètres de base) - **Jeton d'accès au canal** — un jeton à longue durée de vie que vous émettez dans l'onglet **Messaging API** Aucun document professionnel n'est requis pour un compte officiel standard (non vérifié) — juste un identifiant LINE Business. La vérification (le badge bleu) est facultative et n'est proposée que dans certaines régions. --- ## Configuration de LINE ### Étape 1 : Activer la Messaging API pour votre compte officiel 1. Connectez-vous au [LINE Official Account Manager](https://manager.line.biz) (ou créez d'abord un nouveau compte officiel). 2. Ouvrez votre OA. 3. Cliquez sur **Paramètres** (coin supérieur droit). 4. Dans le menu des paramètres, cliquez sur **Messaging API**. 5. Le statut est initialement **Désactivé** — cliquez pour l'activer. 6. Choisissez le **fournisseur** pour ce canal (l'entreprise/le développeur qui le possède). Si vous n'en avez pas encore, **créez un nouveau fournisseur**, puis confirmez. ### Étape 2 : Obtenir vos identifiants depuis la console développeur L'activation de l'API Messaging crée un canal sous votre fournisseur dans la [console des développeurs LINE](https://developers.line.biz/console/). 1. Ouvrez le **compte développeur / fournisseur**. 2. Cliquez sur le **canal API Messaging**. 3. Ouvrez l'onglet **Paramètres de base** et copiez votre **ID de canal** et votre **Secret de canal**. 4. Ouvrez l'onglet **Messaging API**, émettez (ou régénérez) un **jeton d'accès au canal** à longue durée de vie, et copiez-le. > Gardez ces valeurs à portée de main — vous les collerez dans l'application ensuite. ### Étape 3 : Connecter LINE dans l'application 1. Dans la barre latérale gauche, cliquez sur **Settings** près du bas. 2. Dans le volet de gauche des paramètres, sous **Channels**, cliquez sur **Channels**. 3. Trouvez la carte **LINE** et cliquez sur **Connect**. 4. Facultatif : collez votre **Channel ID** — à titre informatif uniquement. 5. Collez votre **Channel secret**. 6. Collez votre **Channel access token**. 7. Cliquez sur **Connect**. 8. L'application valide les identifiants auprès de LINE et affiche **"Connected to: \"**. Si les identifiants sont incorrects, vous recevrez une erreur — générez à nouveau le jeton d'accès dans la console LINE Developers et réessayez. ### Étape 4 : Définir l'URL du Webhook dans LINE Après la connexion, l'application affiche une section **Terminer la configuration dans LINE** avec une **URL de webhook** — copiez-la. (Une URL de webhook est simplement une adresse web ; la coller dans LINE indique à LINE où envoyer automatiquement les nouveaux messages.) Ensuite, dans la **console des développeurs LINE** pour votre canal API Messaging : 1. Ouvrez l'onglet **Messaging API**. 2. Collez l'URL dans **URL de webhook**. 3. Cliquez sur **Mettre à jour**. 4. Activez (**ON**) l'option **Utiliser le webhook**. ### Étape 5 : Corriger les paramètres du gestionnaire de compte officiel (Important) Par défaut, un OA LINE gère lui-même les discussions et les *réponses automatiques*, ce qui empêche les messages d'atteindre l'IA. De retour dans le [LINE Official Account Manager](https://manager.line.biz), ouvrez les paramètres de votre OA et définissez : | Paramètre | Valeur requise | Pourquoi | |---|---|---| | **Discussion** | **Activé** | Active la discussion pour que la conversation soit transmise (vous permet d'utiliser le filtre de discussion). | | **Mode de réponse** | **Bot** | Permet à l'API (votre agent IA) de gérer les messages. Le mode "Discussion" seul les bloque. | | **Heures de réponse / Messages de réponse automatique** | **Désactivé** | Désactive les réponses automatiques de LINE pour que l'IA gère les réponses à la place (la cause n°1 des "doubles réponses"). | | **Messages de bienvenue** | **Désactivé** | Empêche l'accueil automatique de LINE d'entrer en conflit avec l'IA. | | **Webhooks** | **Activé** | Pour que LINE transfère les messages vers l'application. | > Si l'application vous avertit que votre compte est en **mode Chat**, passez-le en **mode Bot** ici — le bot ne pourra ni recevoir ni envoyer de messages tant que vous ne l'aurez pas fait. ### Étape 6 : Tester le bot 1. Depuis un autre téléphone (par exemple votre propre application LINE), ajoutez votre compte officiel en tant qu'ami et **envoyez-lui un message**. 2. Ouvrez l'application et allez dans **Discussions** — le message entrant apparaît dans la liste des conversations. 3. Si un agent IA gère ce canal, vous le verrez **répondre automatiquement** au message de test. Une fois connecté avec le webhook configuré et les options ci-dessus correctement définies, votre compte LINE apparaît comme **Connecté** sur la page des Canaux et l'IA répond aux messages entrants. --- ## Coût LINE est un canal **gratuit** dans l'application — il n'y a pas de frais par message ni de frais de connexion mensuels de notre part. Notez que les **plans de LINE** ont leurs propres limites mensuelles sur les messages *push* (envois proactifs), qui varient selon la région et le type de compte. Les réponses envoyées peu de temps après qu'un client vous a envoyé un message sont gratuites sur LINE ; les envois proactifs/diffusions sont décomptés du quota de votre plan LINE. --- ## Messages multimédias Les photos, vidéos, notes vocales, fichiers, autocollants et localisations 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 composées de **texte et d'images** dans cette version. Les réponses longues sont automatiquement tronquées pour respecter la limite de 5 000 caractères de LINE. --- ## Gestion de session ### Vérification de l'état de la connexion L'état de votre connexion LINE est affiché sur la carte **LINE** sur la page **Canaux** : | Statut | Signification | |---|---| | **Connecté** | Un compte officiel LINE est lié à ce compte | | **Non connecté** | Aucune connexion configurée | La carte vérifie également le paramètre **Mode Chat** de votre compte à chaque fois que vous ouvrez la page Canaux. Si votre compte LINE a été remis en mode Chat (ce qui empêche le bot de recevoir ou d'envoyer des messages), un avertissement orange apparaît sur la carte pour vous indiquer de le remettre en **Mode Bot** dans le LINE Official Account Manager — vérifiez à nouveau les options de l'étape 5 à cet endroit et l'avertissement disparaîtra lors de votre prochaine visite. ### Déconnexion Ouvrez la carte **LINE** et cliquez sur **Gérer**, puis cliquez sur **Déconnecter** dans le panneau qui s'ouvre et confirmez **Supprimer LINE ?**. Cela supprime la connexion de notre côté. Pour empêcher complètement LINE d'envoyer des événements, désactivez également **Utiliser le webhook** (ou supprimez l'URL du webhook) dans la console LINE Developers. --- ## Limitations - **Un compte officiel par connexion.** Connectez chaque OA séparément ; un OA ne peut être lié qu'à un seul compte. - **Envoi de texte + image.** Le bot IA répond avec du texte et des images ; les messages enrichis "Flex"/modèles/carrousels ne sont pas envoyés dans cette version. - **Région.** Les comptes officiels LINE ne sont pas disponibles dans l'UE ; vous devez disposer d'un OA dans une région prise en charge (par exemple, Japon, Taïwan, Thaïlande, Indonésie). - **Délai de réponse.** Les réponses instantanées gratuites de LINE ont une fenêtre de temps courte ; les messages envoyés plus tard sont automatiquement livrés en tant que messages push (décomptés du quota). --- ## Dépannage ### Identifiants rejetés lors de la connexion - Assurez-vous d'avoir créé un canal **Messaging API** (et non « LINE Login »). - Générez à nouveau un **jeton d'accès au canal à longue durée de vie** dans l'onglet Messaging API et collez la nouvelle valeur. - Confirmez que vous avez copié le **Channel secret** depuis l'onglet Basic settings (et non le Channel ID). ### Le bot ne répond pas - Confirmez que les **Webhooks** sont activés (**On**) à la fois dans la console développeur et dans l'OA Manager. - Confirmez que l'**URL du webhook** correspond à celle affichée dans l'application. - Confirmez que le **Mode de réponse** est réglé sur **Bot** (et non Chat) dans l'OA Manager. ### Le client reçoit deux réponses - Désactivez les **messages de réponse automatique** et les **messages d'accueil** (**Off**) dans l'OA Manager — les réponses automatiques intégrées de LINE sont envoyées en même temps que celles de l'IA. ### Les messages n'arrivent pas dans l'application - Vérifiez que le contact a bien **ajouté votre compte officiel en tant qu'ami** (LINE ne livre les messages qu'aux amis). - Vérifiez à nouveau l'URL du webhook et assurez-vous que **Use webhook** est activé. --- ## Bonnes pratiques - **Terminez les réglages dans l'OA Manager** (mode Bot, Webhooks activés, messages d'accueil et de réponse automatique désactivés) — la plupart des problèmes de configuration viennent de là. - **Répondez rapidement** pour maintenir les réponses dans la fenêtre gratuite de LINE et économiser votre quota de messages push. - **Gardez votre jeton d'accès en sécurité** — toute personne le possédant peut envoyer des messages en tant que votre compte officiel. Générez-le à nouveau dans la console développeur en cas de fuite.