# Envie eventos para seus sistemas com webhooks

> Um webhook avisa seu próprio sistema no momento em que algo acontece na sua loja, como um novo pedido ou uma mudança de estoque. Adicione a URL de um endpoint em Configurações > Webhooks, escolha os eventos, envie um teste e veja cada entrega e a resposta dela.

Central de Ajuda / Integrações - Atualizado em 2 de novembro de 2026

Um webhook envia uma mensagem para um endereço web que você escolhe, no momento em que algo acontece na sua loja. Por exemplo, um novo pedido pode ir direto para o seu sistema de logística, uma mudança de estoque para a sua planilha de inventário, ou um novo cliente para o seu CRM. Seus sistemas não precisam ficar perguntando à Shoprocket se houve mudanças.

Você precisa de um lugar para onde as mensagens vão: um endereço no seu próprio servidor, ou uma ferramenta que forneça um, como uma plataforma de automação. Configurar o lado que recebe costuma ser trabalho de um desenvolvedor.

## Antes de começar

- Os webhooks estão disponíveis a partir do plano **Growth**. Em um plano inferior, a tela mostra qual plano os inclui.
- Eles fazem parte do app **Ferramentas para desenvolvedores**, junto com **Chaves de API**. Se você não vê **Webhooks** em **Configurações** na barra lateral, vá em **Apps**, encontre **Ferramentas para desenvolvedores** em **Desenvolvedores** e clique em **Adicionar**. Veja [Adicionar e remover apps](https://shoprocket.io/pt/ajuda/adicionar-e-remover-apps.md).

## Adicionar um endpoint

1. No seu painel, vá em **Configurações > Webhooks** e clique em **Adicionar endpoint**.
2. Digite um **Nome**. Dê a ele o nome do sistema para onde ele envia, para saber o que para de funcionar se você removê-lo.
3. Digite a **URL do endpoint**. Ela precisa começar com `https://`.
4. Deixe **Endpoint do modo de teste** desligado para o endpoint do seu negócio real. Ligue-o para um endpoint que deve receber só pedidos de teste.
5. Escolha os eventos a enviar. Marque os eventos um a um, use **Selecionar tudo** para um grupo, ou **Assinar todos os eventos**. O melhor é escolher só os eventos que seu sistema usa. Clique em **Exemplo** ao lado de um evento para ver a mensagem que ele envia.
6. Clique em **Adicionar endpoint**.

![O painel para adicionar um endpoint de webhook: o nome Logística, uma URL https, Endpoint do modo de teste desligado e order.created marcado com o payload de exemplo aberto](https://shoprocket.io/img/help/webhooks/add-endpoint.webp)

## Os eventos

| Grupo | Eventos |
|---|---|
| **Pedidos** | Criado, atualizado, pago, reembolsado, enviado, parcialmente enviado, excluído |
| **Clientes** | Criado, atualizado, excluído |
| **Produtos** | Criado, atualizado, excluído |
| **Estoque** | Estoque atualizado |
| **Descontos** | Criado, atualizado, excluído |
| **Categorias** | Criada, atualizada, excluída |
| **Assinaturas** | Criada, renovada, falha na renovação, pausada, retomada, cancelada, expirada |
| **Chaves de licença** | Atribuída, suspensa, restabelecida, expirada, revogada |

## Enviar um teste

Clique em **Enviar teste** em um endpoint. A Shoprocket envia um evento de teste na hora e diz se seu endpoint o aceitou e o que seu servidor respondeu, por exemplo "Respondeu 200 em 140 ms.", ou que ele nem pôde ser alcançado.

## Ver o que foi enviado

O cartão **Entregas recentes**, abaixo dos seus endpoints, lista cada evento que a Shoprocket tentou enviar: quando, o código de resposta do seu servidor e quantas tentativas foram necessárias. Uma entrega fica como **Entregue**, **Na fila**, **Tentando de novo** ou **Falhou**. Depois de corrigir um problema do seu lado, clique em **Reenviar** em qualquer entrega para enviá-la de novo.

![As entregas recentes de um endpoint: eventos entregues com HTTP 200, um Tentando de novo com HTTP 500 e o botão Reenviar](https://shoprocket.io/img/help/webhooks/recent-deliveries.webp)

## Quando as entregas falham

Seu servidor deve responder a cada mensagem com qualquer código de resposta 2xx. Se não responder, a Shoprocket continua tentando por cerca de um dia.

Se as entregas para um endpoint falharem 20 vezes seguidas, o endpoint é desligado e diz o motivo. Corrija seu endpoint e clique em **Reativar agora**. Tudo o que ficou na fila enquanto ele estava desligado é então enviado. Antes de um endpoint ser desligado, ele avisa quando as falhas se acumulam, por exemplo "3 entregas falharam seguidas. Depois de 20, desligamos este endpoint automaticamente."

## Editar ou excluir um endpoint

Clique no botão de editar de um endpoint para mudar o nome, o endereço ou os eventos, e depois em **Salvar**. Para parar de enviar para ele de vez, clique em **Excluir** e confirme.

## Para desenvolvedores

Cada mensagem é assinada com o segredo de assinatura do endpoint, para que seu servidor possa confirmar que ela veio mesmo da Shoprocket. Clique em **Mostrar segredo de assinatura** no endpoint para copiá-lo. Cada mensagem também traz o nome do evento e um ID de entrega, para que seu servidor possa ignorar repetições. O guia para desenvolvedores tem a verificação da assinatura, o payload de cada evento e os detalhes das novas tentativas. Veja [Webhooks](https://shoprocket.io/docs/webhooks.md).

## Relacionados

- [Criar uma chave de API](https://shoprocket.io/pt/ajuda/criar-uma-chave-de-api.md)
- [Zapier](https://shoprocket.io/pt/ajuda/zapier.md)
- [Modo de teste e modo real](https://shoprocket.io/pt/ajuda/modo-de-teste-e-pagamentos-reais.md)

[Abrir Webhooks no seu painel](https://app.shoprocket.io/go/settings/webhooks)

---

- HTML version: https://shoprocket.io/pt/ajuda/envie-eventos-com-webhooks
- Language: Português (pt)
- Also in: [العربية](https://shoprocket.io/ar/help/webhooks.md), [Deutsch](https://shoprocket.io/de/hilfe/ereignisse-mit-webhooks-senden.md), [Ελληνικά](https://shoprocket.io/el/help/webhooks.md), [English](https://shoprocket.io/help/webhooks.md), [Español](https://shoprocket.io/es/ayuda/envia-eventos-con-webhooks.md), [Français](https://shoprocket.io/fr/aide/envoyer-des-evenements-avec-les-webhooks.md), [עברית](https://shoprocket.io/he/help/webhooks.md), [हिन्दी](https://shoprocket.io/hi/help/webhooks.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/webhook.md), [Italiano](https://shoprocket.io/it/aiuto/invia-eventi-con-i-webhook.md), [日本語](https://shoprocket.io/ja/help/webhooks.md), [Lietuvių](https://shoprocket.io/lt/pagalba/webhookai.md), [Norsk](https://shoprocket.io/nb/hjelp/webhooks.md), [Nederlands](https://shoprocket.io/nl/hulp/webhooks.md), [Polski](https://shoprocket.io/pl/pomoc/webhooki.md), [Română](https://shoprocket.io/ro/ajutor/webhooks.md), [Русский](https://shoprocket.io/ru/help/webhooks.md), [ไทย](https://shoprocket.io/th/help/webhooks.md), [Türkçe](https://shoprocket.io/tr/yardim/webhooklar.md), [中文](https://shoprocket.io/zh/help/webhooks.md)
