> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# BigCommerce

Votre réceptionniste peut rechercher la commande d'un appelant dans votre boutique BigCommerce et lui indiquer son statut. Un [outil webhook](/docs/fr/reception-ai/integrations/webhooks) recherche les commandes à l'aide de l'adresse email du client via l'API BigCommerce Orders.

> **Warning**
>
> 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](/docs/fr/reception-ai/receptionist/testing) 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.

> **Tip**
>
> La réponse comprend l'adresse de facturation et les informations de paiement de chaque commande.
> Ajoutez une [règle ou procédure](/docs/fr/reception-ai/receptionist/rules-and-procedures) 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.         |