Intégrations
Relier le bot à Google Sheets, Drive, GetCourse ou à l’IA : enregistrer l’accès et choisir l’action correspondante dans une réaction.
Sur cette page
Une intégration permet au bot de travailler avec un autre service, par exemple d’ajouter une demande dans Google Sheets ou d’envoyer un client à GetCourse. Elle se règle en deux temps : enregistrez la connexion, puis sélectionnez-la dans une action de réaction.
Ouvrez Intégrations → Ajouter une intégration, choisissez le service et renseignez ses champs. Les informations d’accès sont chiffrées. Sur la fiche, vous pouvez activer ou désactiver la connexion, ou ouvrir Configurer.
Services disponibles
- IA : modèle de langage via une API compatible OpenAI. Voir Réponses IA et agent IA.
- Google Sheets : ajouter, lire, rechercher et mettre à jour des lignes par intitulé de colonne. Voir Actions.
- Google Drive : déposer des fichiers dans un dossier.
- GetCourse : créer et mettre à jour utilisateurs et transactions, exporter utilisateurs, transactions et groupes.
- Webhook : envoyer des données à un service par HTTP.
- Gestionnaire externe : confier une réaction à votre programme par une connexion WebSocket permanente. Voir Gestionnaire externe.
Google Agenda se connecte aussi, mais depuis IA → Calendrier par OAuth, où vous configurez également les types de rendez-vous. Voir Rendez-vous et Google Agenda.
Les CRM amoCRM/Kommo, Bitrix24, RetailCRM et OzmaCRM ont leur propre section Intégrations → CRM. Elle permet de connecter le service, faire correspondre ses champs à GetMyBot, vérifier l’effet avant le lancement, consulter le journal et résoudre les conflits. La synchronisation va dans les deux sens. amoCRM/Kommo utilisent OAuth, RetailCRM une clé API, OzmaCRM OIDC et Bitrix24 un webhook entrant du portail. Voir Intégrations CRM.
Configuration
À l’ajout, choisissez le Service, donnez un nom à la connexion et renseignez les champs correspondants.
Webhook
- URL du webhook : adresse du récepteur.
- Signature HMAC : secret partagé qui permet au récepteur de vérifier l’origine GetMyBot. La signature est transmise dans
X-Signature: sha256=....
GetCourse
- Compte : nom de votre école, tel que
myschool, et clé secrète de l’API. - Objet : Utilisateurs ou Transactions.
L’action GetCourse réalise deux types d’opération.
Importer dans GetCourse. Les champs suivent les groupes de l’API officielle : Utilisateur (email, phone, first_name, last_name, city, country, group_name), Réglages de l’import comme refresh_if_exists, Source du trafic (utm_source, utm_campaign, referer), Transaction (offer_code, deal_cost, deal_status, deal_is_paid) et Champs utilisateur supplémentaires. Vous pouvez lire une valeur du client, par exemple email = {{param.email}}, ou saisir une constante, comme utm_source = telegram. Les suggestions de groupes et de champs supplémentaires viennent de votre compte. Si elles ne chargent pas, saisissez les noms manuellement. Les anciennes actions avec une liste de champs unique continuent de fonctionner ; Convertir en sections répartit les clés connues et place les autres dans les champs supplémentaires.
Une réponse GetCourse HTTP 200 accompagnée de success: false est un échec de l’action ; le texte error_message est affiché. En cas de succès, les identifiants {user_id, deal_id, lead_id} sont conservés dans les données temporaires ; les valeurs absentes restent nulles.
Lire les données GetCourse. Exporter les utilisateurs, Exporter les transactions et Exporter les groupes lancent un export et attendent jusqu’à 25 secondes. Si les données ne sont pas prêtes, l’action échoue avec export_not_ready : réessayez plus tard ou affinez le filtre. Celui-ci comporte des lignes « clé, type, valeur », par exemple created_at[from] = 2026-10-01 ; les clés inconnues sont transmises telles quelles. Le résultat contient les noms de champs du compte et au plus 1 000 lignes par exécution, 50 par défaut. has_more dans Informations de page indique s’il reste une page. GetCourse limite la fréquence des exports : ne les lancez pas pour chaque message ; utilisez des scénarios rares ou planifiés.
Google Sheets
- Lien du tableau ou son ID.
- JSON du compte de service, secret : fichier de clé d’un compte Google distinct pour le programme. Donnez à l’adresse email de ce compte accès au tableau, sinon lecture et écriture échouent ; l’erreur apparaît dans l’éditeur et lors du test.
Les champs de l’action correspondent aux en-têtes de colonnes, dans la première ligne par défaut, ou une autre ligne choisie. Opérations :
- Ajouter une ligne : chaque champ va dans la colonne portant son nom, quel que soit l’ordre des colonnes. Un en-tête inconnu est une erreur. Résultat
{row_number, range}. - Lire des lignes : lignes après l’en-tête sous forme d’objets, avec
_row. La page contient 50 lignes par défaut et au plus 500.has_moreetnext_offsetpeuvent être enregistrés dans une clé distincte. - Lire la dernière ligne et Trouver une ligne : parcourent la feuille page par page. Une feuille trop grande produit une erreur plutôt qu’une ligne erronée.
- Mettre à jour une ligne : change les cellules de
row_number, par exemple{{ctx.found.row_number}}après une recherche.
Vous pouvez écrire les valeurs comme une saisie utilisateur, ce qui laisse Google reconnaître dates et formules, ou comme du texte. L’éditeur propose les en-têtes de la feuille ; s’ils ne chargent pas, saisissez les noms manuellement. Aperçu des lignes montre au plus 20 lignes sans modifier le tableau. Son résultat peut servir d’exemple à Analyser la réponse, qui choisit les champs utiles à l’action suivante.
Google Drive
- ID du dossier.
- JSON du compte de service, secret. Donnez à ce compte le droit de modifier le dossier.
L’action Google Drive téléverse un fichier avec nom, type MIME et contenu. Son ID et son lien {file_id, web_view_link} sont conservés dans les données temporaires, par exemple sous upload. Insérez ensuite le lien par {{ctx.upload.web_view_link}}. Analyser la réponse est également disponible.
IA
- URL de base, Modèle, Prompt système, Clé API, secrète. Voir Réponses IA et agent IA.
Une même connexion IA sert à l’action IA, à l’agent IA et à la préparation des sources de connaissances pour la recherche. Le modèle produit alors des représentations numériques du texte, les embeddings, demandés avec la même URL et la même clé ; le modèle par défaut est text-embedding-3-small. Sans connexion IA opérationnelle, les sources ne peuvent pas être indexées et l’agent ne peut pas être activé.
Gestionnaire externe
Votre serveur se connecte à GetMyBot par WebSocket et traite les réactions au moyen de commandes au format Telegram Bot API.
- Adresse WebSocket : adresse à laquelle votre service se connecte.
- Jeton de connexion, secret : visible une seule fois à la création ; un bouton permet de le renouveler.
Protocole et exemples : Gestionnaire externe.
Utilisation dans les réactions
- IA et Webhook sont disponibles immédiatement : ajoutez l’action IA ou utilisez Requête web vers l’URL du webhook.
- GetCourse, Google Sheets et Google Drive sont disponibles dans le constructeur. Chacune de ces actions peut analyser sa réponse pour placer les valeurs voulues dans le contexte. Une erreur suit la route d’erreur configurée. Si le forfait n’inclut pas la fonction, l’étape échoue avec
feature_unavailable.
Tester une intégration
La fiche possède un bouton Tester qui n’écrit rien. Il lit les informations du tableau pour Google Sheets, du dossier pour Google Drive, fait une lecture sûre pour GetCourse et vérifie seulement les champs renseignés pour l’IA, sans appel payant. Il n’y a rien à tester pour les autres types. Le résultat détaille les contrôles réussis et échoués avec une explication courte.
Sécurité
GetMyBot empêche les intégrations d’appeler les réseaux internes et limite la taille des réponses. C’est une protection contre les requêtes vers des adresses non destinées à un accès externe, appelée SSRF. Les secrets des intégrations sont chiffrés.
L’exploration de sites et l’analyse de fichiers ont des limites supplémentaires : adresses HTTPS autorisées, respect de robots.txt, redirections limitées, plafonds de taille et de temps, refus d’exécuter macros, scripts ou objets intégrés. Voir Sources de connaissances.
Pour aller plus loin
- Réponses IA et agent IA : régler le modèle.
- Sources de connaissances : contenu utilisé par l’agent.
- Rendez-vous et Google Agenda : connexion du calendrier.
- Gestionnaire externe : votre serveur par WebSocket.
- Intégrations CRM : amoCRM/Kommo, Bitrix24, RetailCRM, OzmaCRM.
- Sources et clés : connecteurs REST et OzmaDB.
- Requêtes web et webhooks : HTTP entrant et sortant.
Reconnaissance vocale
Choisissez un fournisseur compatible OpenAI ou votre propre service, puis indiquez l’URL de base de l’API, le modèle et la clé API. Le code de langue facultatif, tel que ru ou en, oriente la reconnaissance ; s’il est vide, le fournisseur détecte la langue. La clé et le modèle doivent appartenir au fournisseur choisi.