BigCommerce | ElevenLabs Documentation

Ihr Empfang kann die Bestellung eines Anrufenden in Ihrem BigCommerce-Shop nachschlagen und ihren Status mitteilen. Ein Webhook-Tool findet Bestellungen über die E-Mail-Adresse des Kunden mithilfe der BigCommerce Orders API.

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 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.

Die Antwort enthält Rechnungsadresse und Zahlungsdetails jeder Bestellung. Fügen Sie eine Regel oder Vorgehensweise 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.