BigCommerce | ElevenLabs Documentation

Sua recepcionista pode consultar o pedido de quem liga em sua loja BigCommerce e informar o status. Uma ferramenta de webhook encontra pedidos pelo endereço de e-mail do cliente usando a API de pedidos do BigCommerce.

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

A resposta inclui o endereço de cobrança e os detalhes de pagamento de cada pedido. Adicione uma regra ou procedimento 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.