Intégrations et API
GoWeBa s'intègre avec des services tiers pour étendre ses fonctionnalités. Ce module explique comment connecter, configurer et gérer les intégrations disponibles.
Page Intégrations
La page Paramètres → Intégrations permet de connecter GoWeBa à des services tiers.
Intégrations disponibles
| Service | Type | Fonction |
|---|---|---|
| Google Workspace | OAuth | Synchronisation contacts, calendrier, emails, Drive |
| Microsoft 365 | OAuth | Synchronisation contacts, calendrier, emails, OneDrive |
| Stripe | API Key | Paiements en ligne, facturation automatique |
| Twilio | API Key | Téléphonie VoIP, SMS, Voice AI |
| SendGrid | API Key | Réception et routage d'emails |
| Slack | Webhook | Notifications d'événements GoWeBa vers Slack |
| Zapier | Webhook | Automatisations avec 5000+ applications |
Configurer une intégration
- Aller dans Paramètres → Intégrations — La liste des intégrations disponibles s'affiche
- Cliquer sur « Connecter » — Le formulaire de configuration s'ouvre
- Entrer les identifiants — API Key, OAuth, ou Webhook URL selon le service
- Tester la connexion — GoWeBa vérifie que les identifiants sont valides
- Activer — L'intégration est active et commence à synchroniser
Migration de données
GoWeBa offre un assistant de migration complet pour importer vos données depuis d'autres plateformes.
Sources supportées
| Source | Données migrées |
|---|---|
| Google Workspace | Contacts, emails, calendrier, Drive |
| Microsoft 365 | Contacts, emails, calendrier, OneDrive |
| CSV / vCard | Contacts |
| Autre CRM | Via export CSV |
Processus de migration
- Connexion — Authentification OAuth avec le service source
- Scan — GoWeBa analyse les données disponibles et affiche un résumé
- Mapping — Vérification du mapping des champs (GoWeBa propose un mapping automatique)
- Exécution — Import des données avec gestion des doublons
- Validation — Rapport détaillé : importés, ignorés, erreurs
Webhooks sortants
GoWeBa peut envoyer des notifications HTTP (webhooks) vers des services externes lorsque certains événements se produisent :
- Nouveau contact créé
- Tâche terminée
- Facture payée
- Appel reçu
- Message WEBA avec sentiment négatif
Les webhooks incluent un header de signature HMAC pour vérifier l'authenticité.
API GoWeBa
GoWeBa expose une API REST complète pour permettre des intégrations personnalisées.
Points d'accès principaux
| Endpoint | Méthode | Description |
|---|---|---|
/api/contacts | GET, POST | Liste et création de contacts |
/api/contacts/[id] | GET, PATCH, DELETE | Détail, modification, suppression |
/api/inbox/threads | GET | Liste des conversations email |
/api/tasks | GET, POST | Liste et création de tâches |
/api/calendar/events | GET, POST | Liste et création d'événements |
/api/invoices | GET, POST | Liste et création de factures |
/api/weba/chat | POST | Envoyer un message à WEBA |
Authentification API
Toutes les requêtes API nécessitent un token d'authentification valide :
Authorization: Bearer <session_token>
Les tokens sont générés lors de la connexion via NextAuth et sont valides pour la durée de la session.
Domaine personnalisé
GoWeBa permet de configurer un domaine personnalisé pour accéder à votre plateforme :
- Paramètres → Domaine — Accéder à la configuration DNS
- Ajouter un domaine — Entrer votre nom de domaine (ex: crm.monentreprise.com)
- Configurer les DNS — Ajouter les enregistrements CNAME indiqués chez votre registraire
- Vérification — GoWeBa vérifie automatiquement la propagation DNS
- Activation — Le domaine est actif avec certificat SSL automatique
FAQ
Q : Combien d'intégrations puis-je configurer ? R : Il n'y a pas de limite. Configurez autant d'intégrations que nécessaire.
Q : Les intégrations sont-elles sécurisées ? R : Oui. Les tokens OAuth sont chiffrés et les API Keys sont stockées de manière sécurisée. Aucune donnée sensible n'est exposée côté client.
Q : La migration écrase-t-elle mes données existantes ? R : Non. La migration ajoute des données sans supprimer les existantes. Les doublons sont détectés et gérés intelligemment.
Q : Puis-je utiliser l'API en dehors de GoWeBa ? R : L'API est conçue pour l'usage interne de la plateforme. Pour des intégrations avancées, contactez le support GoWeBa.