> 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

Tu recepcionista puede buscar el pedido de quien llama en tu tienda BigCommerce e informarle de su estado. Una [herramienta de webhook](/docs/es/reception-ai/integrations/webhooks) busca pedidos por la dirección de correo electrónico del cliente mediante la API de pedidos de BigCommerce.

> **Warning**
>
> Los pedidos contienen nombres, direcciones, números de teléfono y compras de clientes. Tu recepcionista debe
> confirmar que quien llama es el cliente antes de compartir nada. La descripción de la herramienta a continuación hace que
> pida tanto el número de pedido como la dirección de correo electrónico asociada al pedido, y que solo hable de un pedido cuando
> ambos coincidan.

## Antes de empezar

### Crea una cuenta de API de solo lectura

En el panel de control de BigCommerce, abre **Settings** → **Store-level API accounts** y crea una cuenta de API. Ponle un nombre, como "Reception", y configura el ámbito **Orders** como **read-only**, con todos los demás ámbitos en **None**. No podrás cambiar los ámbitos más adelante.

### Copia las credenciales

Guarda la cuenta y copia el **Access token** y la **API path**. La ruta de API tiene este aspecto: `https://api.bigcommerce.com/stores/STORE_HASH/v3/`; la parte situada después de `/stores/` es el hash de tu tienda. Trata el token de acceso como un secreto.

## Crea la herramienta de webhook

Ve a **Integrations**, selecciona **Add integration** y elige **Webhook Tool**.

| Campo                | Valor                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `find_bigcommerce_order`                                                                                                                                                                                                                                                                                                                                                                |
| **Description**      | "Busca un pedido cuando alguien llama para preguntar por él. Primero pide el número de pedido y la dirección de correo electrónico del pedido, y pídele que deletree el correo. Comparte detalles solo de un pedido cuyo id y correo electrónico de facturación coincidan con lo que ha dicho quien llama. De lo contrario, di que no puedes encontrarlo y ofrece devolver la llamada." |
| **Method**           | GET                                                                                                                                                                                                                                                                                                                                                                                     |
| **URL**              | `https://api.bigcommerce.com/stores/STORE_HASH/v2/orders`                                                                                                                                                                                                                                                                                                                               |
| **Request Headers**  | `X-Auth-Token`: tu token de acceso  `Accept`: `application/json`                                                                                                                                                                                                                                                                                                                        |
| **Query Parameters** | `email` (string, obligatorio): "La dirección de correo electrónico proporcionada por quien llama."  `sort` (string, obligatorio): "Siempre el valor exacto `date_created:desc`."  `limit` (number, obligatorio): "Siempre el valor exacto `5`."                                                                                                                                         |
| **Assign to agents** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                        |

Los valores `sort` y `limit` devuelven primero los pedidos más recientes del cliente, en lugar de los más antiguos.

Selecciona **Enable** y después [prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) con un pedido de prueba: pregunta por él usando el número de pedido y el correo correctos, y luego con un correo incorrecto; comprueba que en la segunda llamada no se proporcionen detalles.

> **Tip**
>
> La respuesta incluye la dirección de facturación y los datos de pago de cada pedido. Añade una [regla o procedimiento](/docs/es/reception-ai/receptionist/rules-and-procedures) sobre qué puede compartir tu recepcionista
> por teléfono, por ejemplo, solo el estado y la fecha del pedido.

## Solución de problemas

| Problema                 | Qué comprobar                                                                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| BigCommerce devuelve 401 | El encabezado debe llamarse `X-Auth-Token` y contener el token de acceso, no el ID de cliente ni el secreto de cliente.   |
| BigCommerce devuelve 403 | La cuenta de API no tiene el ámbito de solo lectura **Orders**. Crea una cuenta nueva con ese ámbito.                     |
| BigCommerce devuelve 404 | Comprueba el hash de la tienda en la URL y que la URL use `/v2/orders`.                                                   |
| La respuesta está vacía  | Ningún pedido tiene ese correo electrónico. Comprueba que quien llama proporcionó el correo usado al finalizar la compra. |