> 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

Ihr Empfang kann die Bestellung eines Anrufenden in Ihrem BigCommerce-Shop nachschlagen und ihren Status mitteilen. Ein [Webhook-Tool](/docs/de/reception-ai/integrations/webhooks) findet Bestellungen über die E-Mail-Adresse des Kunden mithilfe der BigCommerce Orders API.

> **Warning**
>
> Bestellungen enthalten Namen, Adressen, Telefonnummern und Einkäufe von Kunden. Ihr Empfang muss
> bestätigen, dass der Anrufende der Kunde ist, bevor Informationen geteilt werden. Die unten stehende
> Tool-Beschreibung fordert deshalb sowohl die Bestellnummer als auch die E-Mail-Adresse der Bestellung
> ab und bespricht eine Bestellung nur, wenn beide übereinstimmen.

## Bevor Sie beginnen

### API-Konto mit Leseberechtigung erstellen

Öffnen Sie in Ihrem BigCommerce-Control-Panel **Settings** → **Store-level API accounts** und erstellen Sie ein API-Konto. Geben Sie ihm einen Namen, etwa „Reception“, und setzen Sie den Bereich **Orders** auf **read-only**. Setzen Sie alle anderen Bereiche auf **None**. Sie können Bereiche später nicht ändern.

### Zugangsdaten kopieren

Speichern Sie das Konto und kopieren Sie den **Access token** sowie den **API path**. Der API-Pfad sieht etwa so aus: `https://api.bigcommerce.com/stores/STORE_HASH/v3/`; der Teil nach `/stores/` ist Ihr Store-Hash. Behandeln Sie den Access Token wie ein Geheimnis.

## Webhook-Tool erstellen

Gehen Sie zu **Integrations**, wählen Sie **Add integration** und dann **Webhook Tool**.

| Feld                 | Wert                                                                                                                                                                                                                                                                                                                                                                                              |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `find_bigcommerce_order`                                                                                                                                                                                                                                                                                                                                                                          |
| **Description**      | „Schlage eine Bestellung nach, wenn ein Anrufender danach fragt. Frage zuerst nach der Bestellnummer und der E-Mail-Adresse der Bestellung und lasse die E-Mail-Adresse buchstabieren. Teile nur Details einer Bestellung mit, deren ID und Rechnungs-E-Mail beide mit den Angaben des Anrufenden übereinstimmen. Sage andernfalls, dass du sie nicht finden kannst, und biete einen Rückruf an.“ |
| **Method**           | GET                                                                                                                                                                                                                                                                                                                                                                                               |
| **URL**              | `https://api.bigcommerce.com/stores/STORE_HASH/v2/orders`                                                                                                                                                                                                                                                                                                                                         |
| **Request Headers**  | `X-Auth-Token`: Ihr Access Token  `Accept`: `application/json`                                                                                                                                                                                                                                                                                                                                    |
| **Query Parameters** | `email` (Zeichenfolge, erforderlich): „Die E-Mail-Adresse, die der Anrufende angegeben hat.“  `sort` (Zeichenfolge, erforderlich): „Immer genau der Wert `date_created:desc`.“  `limit` (Zahl, erforderlich): „Immer genau der Wert `5`.“                                                                                                                                                         |
| **Assign to agents** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                  |

Die Werte `sort` und `limit` geben zuerst die neuesten Bestellungen des Kunden zurück, statt der ältesten.

Wählen Sie **Enable** und [testen Sie dann Ihren Empfang](/docs/de/reception-ai/receptionist/testing) mit einer Testbestellung: Fragen Sie mit der richtigen Bestellnummer und E-Mail danach, dann mit einer falschen E-Mail, und prüfen Sie, dass der zweite Anruf keine Details erhält.

> **Tip**
>
> Die Antwort enthält Rechnungsadresse und Zahlungsdetails jeder Bestellung. Fügen Sie eine [Regel oder Vorgehensweise](/docs/de/reception-ai/receptionist/rules-and-procedures) hinzu, die festlegt, was Ihr
> Empfang am Telefon mitteilen darf, zum Beispiel nur den Status und das Bestelldatum.

## Fehlerbehebung

| Problem                     | Prüfen Sie                                                                                                                 |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| BigCommerce gibt 401 zurück | Der Header muss `X-Auth-Token` heißen und den Access Token enthalten, nicht die Client-ID oder das Client Secret.          |
| BigCommerce gibt 403 zurück | Dem API-Konto fehlt der Lesebereich **Orders**. Erstellen Sie ein neues Konto damit.                                       |
| BigCommerce gibt 404 zurück | Prüfen Sie den Store-Hash in der URL und dass die URL `/v2/orders` verwendet.                                              |
| Die Antwort ist leer        | Keine Bestellung hat diese E-Mail-Adresse. Prüfen Sie, ob der Anrufende die beim Checkout verwendete E-Mail angegeben hat. |