Intégrations

L'onglet Intégrations permet à votre agent de récupérer des données en direct depuis des services externes pendant une conversation. Une fois connecté, l'agent appelle automatiquement le bon service quand un visiteur pose une question pertinente — sans déclenchement manuel.

Allez dans votre agent → Intégrations pour configurer l'un des services ci-dessous.

Disponibilité par forfait : les agendas (Cal.com, Calendly) et les transporteurs sont disponibles à partir de Base. L'e-commerce, le CRM et les paiements nécessitent Business et supérieurs. Voir Forfaits et facturation.

Planification

Cal.com

Permet à l'agent d'afficher les créneaux libres de votre agenda Cal.com.

1. Dans Cal.com, ouvrez l'événement à partager et copiez son URL publique (p. ex. cal.com/yourname/30min).
2. Collez l'URL dans le champ Cal.com Event URL et cliquez sur Enregistrer.

Calendly

Permet à l'agent d'afficher les créneaux libres de votre agenda Calendly.

1. Copiez l'URL de l'événement depuis Calendly (p. ex. calendly.com/yourname/30min).
2. Allez dans Calendly → Integrations → API & Webhooks → Personal Access Tokens et générez un token.
3. Collez l'URL de l'événement et le token, puis cliquez sur Enregistrer.

Le token est requis car l'API de disponibilité de Calendly est authentifiée. Il est stocké chiffré et n'est jamais exposé aux visiteurs.

E-commerce

Lorsqu'une intégration e-commerce trouve des produits correspondants, les résultats apparaissent sous forme de carrousel de produits défilant dans le chat — image, nom, prix et lien — et non en simple texte.

Shopify

Permet à l'agent de rechercher dans votre catalogue de produits et de consulter le statut de commande d'un client — paiement, préparation et numéro de suivi. Avant de divulguer les détails de la commande, l'agent demande de confirmer le téléphone ou l'e-mail utilisé lors de la commande, afin que personne ne puisse consulter la commande d'autrui.

1. Saisissez le domaine de votre boutique (p. ex. mystore.myshopify.com) et cliquez sur Connecter Shopify.
2. Autorisez l'accès dans Shopify et approuvez les permissions demandées.
3. Après approbation, vous êtes redirigé et l'intégration affiche Connecté.

WooCommerce

Permet à l'agent de consulter le statut et les détails d'une commande par numéro.

1. Dans WordPress, allez dans WooCommerce → Settings → Advanced → REST API et cliquez sur Add key.
2. Réglez les permissions sur Read, générez la clé et copiez la Consumer Key et le Consumer Secret.
3. Saisissez l'URL de votre boutique et les deux clés dans BotChata, puis cliquez sur Connecter WooCommerce.

PrestaShop

Permet à l'agent de rechercher dans votre catalogue de produits.

1. Dans l'admin PrestaShop, allez dans Advanced Parameters → Webservice et activez le webservice.
2. Ajoutez une nouvelle clé avec accès en lecture aux produits et copiez la API key générée.
3. Saisissez l'URL de votre boutique et la clé API dans BotChata et cliquez sur Enregistrer.

Shoper

Permet à l'agent de rechercher dans le catalogue de votre boutique Shoper.

1. Dans l'admin Shoper, créez un accès API (un utilisateur d'application) dans les réglages API.
2. Saisissez l'URL de votre boutique et les identifiants API dans BotChata et cliquez sur Enregistrer.

Magento

Permet à l'agent de rechercher dans votre catalogue Magento.

1. Dans l'admin Magento, allez dans System → Integrations et créez une intégration avec accès en lecture au catalogue.
2. Copiez l'Access Token.
3. Saisissez l'URL de votre boutique et le token dans BotChata et cliquez sur Enregistrer.

Expédition et suivi

Toutes les intégrations d'expédition fonctionnent de la même façon : l'agent demande au visiteur son numéro de suivi et renvoie le statut actuel de l'envoi directement dans le chat.

InPost

1. Connectez-vous à InPost Manager et allez dans API.
2. Générez ou copiez votre clé API.
3. Collez-la dans BotChata et cliquez sur Enregistrer.

DHL

1. Inscrivez-vous sur developer.dhl.com (offre gratuite disponible).
2. Créez une app et copiez la API key.
3. Collez-la dans BotChata et cliquez sur Enregistrer.

DPD

1. Contactez votre gestionnaire de compte DPD ou inscrivez-vous sur developer.dpd.de pour obtenir une clé API.
2. Collez la clé dans BotChata et cliquez sur Enregistrer.

GLS

1. Connectez-vous à votre compte myGLS Business.
2. Utilisez l'identifiant et le mot de passe de vos identifiants myGLS Business.
3. Saisissez les deux champs dans BotChata et cliquez sur Enregistrer.

Nova Poshta

1. Ouvrez le cabinet personnel Nova Poshta et allez dans Réglages → API.
2. Copiez votre clé API.
3. Collez-la dans BotChata et cliquez sur Enregistrer.

UPS

UPS utilise OAuth2 client credentials.

1. Inscrivez-vous sur developer.ups.com et allez dans My Apps → Create App.
2. Copiez le Client ID et le Client Secret.
3. Saisissez les deux dans BotChata et cliquez sur Enregistrer.

BotChata échange automatiquement les identifiants contre un token bearer et le renouvelle avant son expiration — vous n'avez pas à gérer les tokens manuellement.

FedEx

FedEx utilise également OAuth2 client credentials.

1. Inscrivez-vous sur developer.fedex.com et allez dans My Projects → Create Project.
2. Copiez le Client ID et le Client Secret.
3. Saisissez les deux dans BotChata et cliquez sur Enregistrer.

CRM

HubSpot

Permet à l'agent de retrouver un contact dans votre CRM par adresse e-mail.

1. Dans HubSpot, allez dans Settings → Integrations → Private Apps et créez une nouvelle app.
2. Accordez au minimum le scope crm.objects.contacts.read.
3. Copiez le Private App Token (commence par pat-).
4. Collez-le dans BotChata et cliquez sur Enregistrer.

L'agent renvoie le nom, le téléphone et la société du contact — les champs internes sensibles sont automatiquement filtrés.

Pipedrive

Permet à l'agent de retrouver une personne ou une affaire dans votre CRM Pipedrive.

1. Dans Pipedrive, allez dans Settings → Personal preferences → API et copiez votre API token.
2. Saisissez le domaine de votre entreprise et le token dans BotChata et cliquez sur Enregistrer.

Paiements

Stripe

Permet à l'agent de vérifier le statut de paiement récent d'un client par son adresse e-mail.

1. Ouvrez Stripe Dashboard → Developers → API keys.
2. Copiez la Secret Key (sk_live_ en production ou sk_test_ en mode test).
3. Collez-la dans BotChata et cliquez sur Enregistrer.

Pour plus de sécurité, utilisez une Restricted key avec uniquement la permission charges: read.

Conseils

• Plusieurs intégrations peuvent être actives en même temps. L'agent choisit la bonne selon ce que demande le visiteur.
• Déconnectez à tout moment en cliquant sur le lien rouge Déconnecter sous une intégration connectée — les identifiants stockés sont supprimés immédiatement.
• Les identifiants sont chiffrés avec Fernet (AES-128) avant stockage et ne sont jamais renvoyés au navigateur.
• Chaque carte d'intégration dispose d'un bouton Tester la connexion — utilisez-le pour confirmer que vos identifiants fonctionnent avant la mise en ligne.
• Si un appel d'intégration échoue pendant une conversation (p. ex. l'API est indisponible), l'agent se rabat sur ses connaissances et informe le visiteur qu'il n'a pas pu récupérer de données en direct.