> 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

Sua recepcionista pode consultar o pedido de quem liga em sua loja BigCommerce e informar o status. Uma [ferramenta de webhook](/docs/pt/reception-ai/integrations/webhooks) encontra pedidos pelo endereço de e-mail do cliente usando a API de pedidos do BigCommerce.

> **Warning**
>
> Os pedidos contêm nomes, endereços, números de telefone e compras dos clientes. Sua recepcionista deve
> confirmar que quem liga é o cliente antes de compartilhar qualquer informação. A descrição da ferramenta abaixo faz com que ela
> peça tanto o número do pedido quanto o endereço de e-mail do pedido e só fale sobre um pedido quando
> ambos corresponderem.

## Antes de começar

### Crie uma conta de API somente leitura

No painel de controle do BigCommerce, abra **Settings** → **Store-level API accounts** e crie uma conta de API. Dê um nome a ela, como "Reception", e defina o escopo **Orders** como **read-only**, com todos os outros escopos definidos como **None**. Não é possível alterar os escopos depois.

### Copie as credenciais

Salve a conta e copie o **Access token** e o **API path**. O caminho da API é semelhante a `https://api.bigcommerce.com/stores/STORE_HASH/v3/`; a parte após `/stores/` é o hash da sua loja. Trate o token de acesso como um segredo.

## Crie a ferramenta de webhook

Acesse **Integrations**, selecione **Add integration** e escolha **Webhook Tool**.

| Campo                | Valor                                                                                                                                                                                                                                                                                                                                                                            |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `find_bigcommerce_order`                                                                                                                                                                                                                                                                                                                                                         |
| **Description**      | "Consulte um pedido quando alguém ligar para perguntar sobre ele. Primeiro, peça o número do pedido e o endereço de e-mail do pedido e peça que a pessoa soletre o e-mail. Compartilhe detalhes apenas de um pedido cujo ID e e-mail de cobrança correspondam ao que a pessoa informou. Caso contrário, diga que você não consegue encontrá-lo e ofereça um retorno de chamada." |
| **Method**           | GET                                                                                                                                                                                                                                                                                                                                                                              |
| **URL**              | `https://api.bigcommerce.com/stores/STORE_HASH/v2/orders`                                                                                                                                                                                                                                                                                                                        |
| **Request Headers**  | `X-Auth-Token`: seu token de acesso  `Accept`: `application/json`                                                                                                                                                                                                                                                                                                                |
| **Query Parameters** | `email` (string, obrigatório): "O endereço de e-mail informado por quem ligou."  `sort` (string, obrigatório): "Sempre o valor exato `date_created:desc`."  `limit` (number, obrigatório): "Sempre o valor exato `5`."                                                                                                                                                           |
| **Assign to agents** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                 |

Os valores de `sort` e `limit` retornam primeiro os pedidos mais recentes do cliente, em vez dos mais antigos.

Selecione **Enable** e, depois, [teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) com um pedido de teste: pergunte sobre ele usando o número e e-mail corretos e, em seguida, com um e-mail incorreto, e confirme que a segunda chamada não recebe detalhes.

> **Tip**
>
> A resposta inclui o endereço de cobrança e os detalhes de pagamento de cada pedido. Adicione uma [regra ou procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) sobre o que sua recepcionista pode
> compartilhar por telefone, por exemplo, apenas o status e a data do pedido.

## Solução de problemas

| Problema                  | O que verificar                                                                                                     |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| O BigCommerce retorna 401 | O cabeçalho deve se chamar `X-Auth-Token` e conter o token de acesso, não o ID do cliente nem o segredo do cliente. |
| O BigCommerce retorna 403 | A conta de API não tem o escopo **Orders** somente leitura. Crie uma nova conta com ele.                            |
| O BigCommerce retorna 404 | Verifique o hash da loja na URL e se a URL usa `/v2/orders`.                                                        |
| A resposta está vazia     | Nenhum pedido tem esse e-mail. Verifique se quem ligou informou o e-mail usado na finalização da compra.            |