Le champ "acquisitionChannel" vous permet de suivre la source d'un rendez-vous ; c'est un champ optionnel qui peut être passé sous forme de chaîne lors de la création du rendez-vous, soit en utilisant le booking widget v3, soit l'API.
Nous vous suggérons d'utiliser cette propriété pour obtenir un aperçu de la répartition des réservations sur vos canaux et campagnes.
Comment transmettre la source avec les détails de la réservation lors de la création d'un rendez-vous
Booking widget v3
Il suffit d'inclure une valeur valide dans le corps du code de votre widget. Vous pouvez utiliser le générateur de code pour obtenir de l'aide si nécessaire.
API
La propriété acquisitionChannel peut être passée dans le corps d'une requête POST. Voir ici pour plus d'informations.
Voir ici pour la documentation API pertinente
Comment récupérer la source de la réservation
Le canal d'acquisition se trouve dans les éléments suivants :
*Remarque : le "canal d'acquisition" est exclu par défaut (demandez à votre représentant Booxi de l'inclure)
Inclus dans tous les événements webhook de rendez-vous et de réservation. La propriété "acquisitionChannel" se trouve à la racine de l'objet de réservation.
La propriété acquisitionChannel sera incluse dans l'objet de réservation dans les points de terminaison suivants :
Get /Booking
Get /Booking/{bookingId}
Get /Calendar
Put /Booking (inclus dans la réponse)
Limitations
Le booking widget v2 ne supporte pas ce champ ; "acquisitionChannel" sera vide pour les réservations créées à l'aide de BNv2.
La valeur du canal d'acquisition est transmise lors de la création de la réservation et ne sera pas modifiée si la réservation est modifiée.
Le canal d'acquisition est inclus dans les données webhook pour appointment.updated et reservation.updated.
Spécifications
La chaîne de la propriété acquisitionChannel doit respecter les exigences suivantes :
64 caractères max (tronqués si plus de 64 caractères)
Supporte les caractères suivants :
Nombres, lettres
+-.,_=
Les espaces ne sont pas supportés.
Exemples de valeurs valides :
E-commerce
Facebook
Clienteling_app
Line-chat
Google_ad-campaign,summer2024