# Ouça quando uma venda acontece.

> Receba uma notificação push a cada pedido do Shopify, WooCommerce ou Stripe. Aponte o webhook da sua loja para o Pocket Alert e saiba de cada venda e reembolso assim que acontecer.

<!-- source: https://pocketalert.app/pt/use-cases/ecommerce-order-alerts -->

Última atualização: 2026-08-11

Cada novo pedido da Shopify, WooCommerce ou da sua própria loja chega ao seu celular com o número do pedido, o valor total e o cliente. Ouça o cling da venda no instante em que ela entra.

## Três passos para alertas de pedidos

1. **Crie o webhook** — Crie um webhook na Pocket Alert com um template GJSON que mapeie order_number, total_price e customer, depois copie a URL de recebimento.
2. **Aponte sua loja para ele** — Na Shopify, adicione um webhook para o evento Order creation e cole a sua URL de recebimento como destino.
3. **Ouça o cling** — Faça um pedido de teste. A venda chega ao seu celular com o valor total e o cliente.

## Sua loja, no seu celular

Cada venda, reembolso e pagamento recusado chega ao seu celular assim que a sua loja dispara o webhook.

- **Qualquer loja, sem plugin** — Shopify, WooCommerce, Stripe, Paddle ou uma loja personalizada envia o webhook do pedido diretamente para a sua URL da Pocket Alert.
- **Total e cliente** — Mapeie o valor total, o cliente e o produto para que a notificação pareça um recibo de verdade, e não um evento bruto.
- **Vendas, reembolsos, falhas** — Um novo pedido, um reembolso ou um pagamento recusado vira cada um sua própria notificação push, enviada pelo mesmo webhook da loja.
- **Reembolsos em canal próprio** — Um webhook separado para refunds/create em um aplicativo próprio toca à parte dos pedidos comuns, então um reembolso nunca se esconde no feed de vendas.
- **Em menos de um segundo** — O pedido sai da loja e chega ao seu celular em menos de um segundo, sem precisar atualizar o painel.
- **Um canal por loja** — Aponte cada loja para o seu próprio aplicativo, para que duas marcas toquem em dois canais que você consiga diferenciar.

## Conectar a Shopify

### 1. Crie um webhook na Pocket Alert

Defina um nome e um template GJSON `message` que mapeie o payload orders/create da Shopify. Isso retorna a sua URL de recebimento.

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Shopify Orders","application_id":"qm47b9pzxzxg","message":"Order #%order_number% · %total_price% %currency% · %customer.first_name% %customer.last_name%"}'
```

A resposta contém um slug, que gera a URL de recebimento `https://p4a.me/wh/1234abcd`. Você também pode criá-lo na página de [Webhooks](https://pocketalert.app/pt/webhooks).

### 2. Cole a URL de recebimento na Shopify

Na Shopify, vá em Configurações, Notificações, Webhooks, e clique em Criar webhook. Escolha o evento `Order creation`, o formato JSON e cole a sua URL de recebimento da Pocket Alert como destino.

### 3. Mapeie os campos

A Shopify envia o JSON do pedido por POST para a sua URL de recebimento. O template é renderizado com base nele: `%order_number%`, `%total_price%`, `%currency%`, `%customer.email%` e `%line_items.0.title%` para o primeiro produto. A [documentação](https://info.pocketalert.app/api/webhooks/settings.html) lista os caminhos GJSON completos.

## Perguntas frequentes

### Como recebo um alerta para novos pedidos?

Crie um webhook na Pocket Alert com um template de mensagem e depois cole a URL de recebimento dele na Shopify, em Configurações, Notificações, Webhooks. A Shopify dispara o webhook orders/create a cada pedido, e a Pocket Alert transforma isso em uma notificação push.

### O alerta pode mostrar o valor total e o cliente?

Sim. Seu template GJSON puxa os campos direto do payload da Shopify — %order_number%, %total_price%, %currency% e %customer.first_name% — então a notificação mostra "Pedido #1001 · 125.00 USD · Jane".

### Quais plataformas funcionam?

Shopify, WooCommerce, BigCommerce e qualquer loja personalizada que envie um POST de webhook. Mapeie os campos do payload de cada plataforma no template — não é preciso plugin além do webhook nativo que cada plataforma já oferece.

### Um reembolso pode se destacar de uma venda?

Sim. Crie um webhook separado na Pocket Alert para orders/create e outro para refunds/create, cada um com seu próprio aplicativo, para que os reembolsos toquem em um canal que você consiga diferenciar das vendas comuns.

### Tenho duas lojas. Consigo mantê-las separadas?

Dê a cada loja seu próprio aplicativo na Pocket Alert. Duas marcas, dois canais, e a notificação informa qual deles tocou.

### Consigo fazer um pedido grande tocar mais alto que os outros?

Sim. Cada mensagem recebe um nível, de silencioso (-2) a crítico (2). Envie totais altos do seu backend com nível high e eles chegam como notificações push urgentes que furam o Foco do iPhone, enquanto um resumo noturno de receita enviado em silencioso vai para o histórico sem som. Um webhook também pode ter seu próprio default_level, então um webhook de pedidos grandes toca separadamente do fluxo de rotina.
