Intégration Acuity Scheduling
HiLucy s'intègre avec Acuity Scheduling pour vous permettre de proposer des services et expériences sur rendez-vous que les clients peuvent réserver directement. Qu'il s'agisse de soins spa, de visites guidées, de réservations de restaurant ou d'excursions privées, Acuity gère la planification tandis que HiLucy gère l'expérience client.
Comment ça Fonctionne
L'intégration synchronise les données de votre compte Acuity dans la base de données de HiLucy, rendant vos services disponibles via le Portail Client et LucyAI :
- Vous configurez les types de rendez-vous, calendriers et produits dans Acuity Scheduling
- HiLucy synchronise ces données dans des tables locales pour une récupération rapide
- Les clients découvrent les activités via l'onglet Explorer ou en demandant à LucyAI
- LucyAI peut rechercher et réserver des activités au nom des clients pendant la conversation
Configuration de l'Intégration
1. Obtenez vos Identifiants Acuity
Dans votre compte Acuity Scheduling, accédez à Intégrations > API et notez votre :
- User ID -- votre identifiant de compte Acuity
- API Key -- la clé secrète pour l'authentification API
Chaque propriété (annonce) dans HiLucy peut avoir ses propres identifiants Acuity, permettant à différentes propriétés de proposer différents catalogues d'activités.
2. Configurez dans HiLucy
Depuis l'administration WordPress, modifiez votre annonce et localisez le metabox Acuity Integration :
- Activer Acuity -- activez l'intégration pour cette annonce
- User ID -- entrez votre User ID Acuity
- API Key -- entrez votre API Key Acuity
Enregistrez l'annonce pour stocker les identifiants.
3. Synchronisez vos Données
Cliquez sur le bouton Sync Now dans le metabox Acuity Integration. HiLucy récupérera les données de l'API Acuity et remplira trois tables locales :
- Appointment Types -- vos services (ex : "Massage 60 Minutes", "Excursion au Coucher de Soleil")
- Calendars -- vos calendriers de disponibilité (ex : "Calendrier Spa", "Calendrier Visites")
- Products -- forfaits complémentaires et extras liés aux types de rendez-vous
La synchronisation se termine généralement en quelques secondes. Vous pouvez resynchroniser à tout moment pour récupérer les modifications effectuées dans Acuity.
4. Configuration des Webhooks
HiLucy fournit un endpoint webhook à /hilucy/v1/acuity-webhook pour les mises à jour en temps réel. Configurez cette URL dans votre compte Acuity sous Intégrations > Webhooks pour recevoir des notifications instantanées lorsque des rendez-vous sont réservés, reprogrammés ou annulés.
Parcours de Réservation Client
Une fois synchronisées, les activités apparaissent dans l'onglet Explorer du Portail Client. Le processus de réservation fonctionne ainsi :
- Le client parcourt les activités disponibles ou demande à LucyAI « Qu'est-ce que je peux faire aujourd'hui ? »
- Lucy recherche dans vos types de rendez-vous synchronisés et présente les options correspondantes avec les disponibilités
- Le client sélectionne un créneau horaire et confirme la réservation
- Acuity crée le rendez-vous et envoie une confirmation au client et au prestataire
LucyAI utilise trois outils dédiés pour gérer ce flux : rechercher les activités disponibles, obtenir des informations détaillées sur une activité spécifique et finaliser la réservation -- le tout par conversation naturelle.
Configuration par Annonce
Puisque chaque annonce stocke ses propres identifiants Acuity, vous pouvez :
- Proposer différentes activités par propriété -- une villa en bord de mer affiche les sports nautiques tandis qu'un chalet de montagne affiche les randonnées
- Utiliser différents comptes Acuity -- si vous travaillez avec plusieurs prestataires d'activités, chaque annonce peut se connecter à un compte différent
- Activer sélectivement -- n'activez Acuity que pour les annonces où vous avez des activités à proposer
Gestion des Données Synchronisées
Toutes les données synchronisées sont stockées localement pour un accès rapide :
| Table | Contenu |
|---|---|
| Appointment Types | Nom du service, durée, prix, description, catégorie |
| Calendars | Nom du calendrier, fuseau horaire, types de rendez-vous associés |
| Products | Forfaits complémentaires, tarifs, types de rendez-vous liés |
Les modifications effectuées dans Acuity (nouveaux services, tarifs mis à jour, calendriers supprimés) sont reflétées dans HiLucy après la prochaine synchronisation. Utilisez le bouton Sync Now ou attendez que le webhook déclenche une mise à jour automatique.