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

# WooCommerce

Sua recepcionista pode consultar o pedido de quem está ligando na sua loja WooCommerce e informar o status. Uma [ferramenta de webhook](/docs/pt/reception-ai/integrations/webhooks) pesquisa os pedidos da sua loja pela API REST do WooCommerce.

> **Warning**
>
> Os pedidos contêm nomes, endereços, números de telefone e compras dos clientes. Sua recepcionista deve
> confirmar que quem está ligando é 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

### Verifique as configurações da sua loja

Sua loja deve usar HTTPS, e os links permanentes devem estar ativados: no WordPress, abra **Configurações** → **Links permanentes** e escolha qualquer opção exceto **Simples**.

### Crie uma chave de API somente leitura

No WordPress, abra **WooCommerce** → **Configurações** → **Avançado** → **API REST** e selecione **Adicionar chave**. Insira uma descrição, como "Recepção", escolha um usuário, defina **Permissões** como **Ler** e selecione **Gerar chave de API**. Copie a **Chave do consumidor** e o **Segredo do consumidor**; o segredo é exibido apenas uma vez.

### Crie o valor do cabeçalho

O WooCommerce autentica chaves com autenticação básica HTTP. Crie o valor do cabeçalho no seu computador:

```bash
printf 'CONSUMER_KEY:CONSUMER_SECRET' | base64
```

## Crie a ferramenta de webhook

Acesse **Integrações**, selecione **Adicionar integração** e escolha **Ferramenta de webhook**.

| Campo                         | Valor                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                      | `find_woocommerce_order`                                                                                                                                                                                                                                                                                                                                                               |
| **Descrição**                 | "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 informado no pedido e peça que a pessoa soletre o e-mail. Compartilhe detalhes apenas de um pedido cujo número e e-mail de cobrança correspondam ao que a pessoa informou. Caso contrário, diga que não consegue encontrá-lo e ofereça retornar a ligação." |
| **Método**                    | GET                                                                                                                                                                                                                                                                                                                                                                                    |
| **URL**                       | `https://YOUR-STORE.com/wp-json/wc/v3/orders`                                                                                                                                                                                                                                                                                                                                          |
| **Cabeçalhos da solicitação** | `Authorization` definido como `Basic ` seguido do valor codificado                                                                                                                                                                                                                                                                                                                     |
| **Parâmetros de consulta**    | `search` (string, obrigatório): "O endereço de e-mail informado por quem ligou."  `per_page` (número, obrigatório): "Sempre o valor exato `5`."                                                                                                                                                                                                                                        |
| **Atribuir a agentes**        | **Recepcionista**                                                                                                                                                                                                                                                                                                                                                                      |

Selecione **Ativar** e depois [teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) com um pedido de teste: pergunte sobre ele usando o número e o e-mail corretos e depois usando um e-mail incorreto; verifique se a segunda ligação não recebe detalhes.

> **Tip**
>
> A resposta inclui todos os campos de cada pedido, inclusive endereços. 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, a data do pedido e o número de rastreamento.

## Solução de problemas

| Problema                                    | O que verificar                                                                                                                                                       |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| O WooCommerce retorna 401                   | Codifique novamente o valor do cabeçalho. Alguns provedores removem o cabeçalho `Authorization` antes que o WordPress o receba; peça ao seu provedor para repassá-lo. |
| 404 `rest_no_route`                         | Verifique o endereço da loja na URL e se os links permanentes não estão definidos como **Simples**.                                                                   |
| Pedidos conhecidos não são encontrados      | A pesquisa corresponde aos dados de cobrança armazenados no pedido. Verifique se a pessoa informou o e-mail usado na finalização da compra.                           |
| Um firewall ou plugin de segurança bloqueia | Permita solicitações para `/wp-json/wc/` no plugin ou no firewall do seu provedor.                                                                                    |