BigCommerce | ElevenLabs Documentation

Votre réceptionniste peut rechercher la commande d’un appelant dans votre boutique BigCommerce et lui indiquer son statut. Un outil webhook recherche les commandes à l’aide de l’adresse email du client via l’API BigCommerce Orders.

Les commandes contiennent les noms, adresses, numéros de téléphone et achats des clients. Votre réceptionniste doit confirmer que l’appelant est bien le client avant de partager la moindre information. La description de l’outil ci-dessous lui demande le numéro de commande et l’adresse email associée à la commande, et de ne parler d’une commande que lorsque les deux correspondent.

Avant de commencer

Créer un compte API en lecture seule

Dans votre panneau de contrôle BigCommerce, ouvrez Settings → Store-level API accounts et créez un compte API. Donnez-lui un nom, tel que « Reception », puis définissez le périmètre Orders sur read-only, et tous les autres périmètres sur None. Vous ne pourrez pas modifier les périmètres ultérieurement.

Copier les identifiants

Enregistrez le compte, puis copiez le Access token et le API path. Le chemin d’API se présente ainsi : https://api.bigcommerce.com/stores/STORE_HASH/v3/ ; la partie après /stores/ correspond au hash de votre boutique. Traitez le jeton d’accès comme un secret.

Créer l’outil webhook

Accédez à Integrations, sélectionnez Add integration, puis choisissez Webhook Tool.

Champ	Valeur
Name	`find_bigcommerce_order`
Description	« Recherchez une commande lorsqu’un appelant pose une question à son sujet. Demandez d’abord le numéro de commande et l’adresse email associée à la commande, puis demandez-lui d’épeler l’email. Ne partagez les détails d’une commande que si son identifiant et son email de facturation correspondent tous deux à ce qu’a indiqué l’appelant. Sinon, dites que vous ne la trouvez pas et proposez de le rappeler. »
Method	GET
URL	`https://api.bigcommerce.com/stores/STORE_HASH/v2/orders`
Request Headers	`X-Auth-Token`: votre jeton d’accès `Accept`: `application/json`
Query Parameters	`email` (chaîne, obligatoire) : « L’adresse email fournie par l’appelant. » `sort` (chaîne, obligatoire) : « Toujours la valeur exacte `date_created:desc`. » `limit` (nombre, obligatoire) : « Toujours la valeur exacte `5`. »
Assign to agents	Receptionist

Les valeurs sort et limit renvoient d’abord les commandes les plus récentes du client, plutôt que les plus anciennes.

Sélectionnez Enable, puis testez votre réceptionniste avec une commande de test : posez une question à son sujet avec le bon numéro de commande et la bonne adresse email, puis avec une mauvaise adresse email, et vérifiez que le second appel ne reçoit aucun détail.

La réponse comprend l’adresse de facturation et les informations de paiement de chaque commande. Ajoutez une règle ou procédure précisant ce que votre réceptionniste peut partager par téléphone, par exemple uniquement le statut et la date de commande.

Résolution des problèmes

Problème	Vérifications à effectuer
BigCommerce renvoie 401	L’en-tête doit s’appeler `X-Auth-Token` et contenir le jeton d’accès, et non l’identifiant client ou le secret client.
BigCommerce renvoie 403	Le compte API ne dispose pas du périmètre Orders en lecture seule. Créez un nouveau compte avec ce périmètre.
BigCommerce renvoie 404	Vérifiez le hash de la boutique dans l’URL et que l’URL utilise `/v2/orders`.
La réponse est vide	Aucune commande n’est associée à cet email. Vérifiez que l’appelant a fourni l’email utilisé lors du paiement.