Configuração de Webhook do WooCommerce

🛍️ Configuração de Webhook do WooCommerce — Integração com Chat-Bot

Este guia apresenta um passo a passo completo, detalhado e profissional sobre como configurar webhooks do WooCommerce e integrá-los perfeitamente ao módulo Ecommerce Webhook Notifications do Chat-Bot.

A integração através de webhooks permite que eventos importantes da loja WooCommerce sejam enviados automaticamente ao Chat-Bot, garantindo automações mais inteligentes, atualizações em tempo real, disparo de fluxos e comunicação instantânea via WhatsApp.

🌐 O que são Webhooks?

Um webhook é um mecanismo de notificação automática enviado de um sistema para outro sempre que um evento ocorre.

Ele funciona como um mensageiro digital que transmite informações para um URL configurado por você, permitindo que diferentes plataformas se comuniquem de forma ágil e precisa.

✔ Por que webhooks são úteis?

• Sincronizam eventos automaticamente entre sistemas

• Eliminam consultas manuais (polling)

• Garantem reações instantâneas a eventos importantes

• Permitem integrações complexas com total controle

• Aumentam a eficiência operacional em ambientes com e-commerce

🛒 Webhooks no WooCommerce

O WooCommerce implementa webhooks desde sua versão 2.2, permitindo disparos automáticos sempre que ações específicas acontecem na loja.

Eles podem ser acionados pelos seguintes itens:

📦 Pedidos

• Novo pedido criado

• Pedido atualizado

• Pedido excluído

🛒 Produtos

• Produto atualizado

• Produto criado

• Produto removido

🎫 Cupons

• Cupons criados, alterados ou removidos

👥 Clientes

• Novas contas

• Atualizações de dados do cliente

⚙️ Ações personalizadas

Você também pode disparar webhooks por meio de actions hooks, como:

• woocommerce_add_to_cart → toda vez que um item é adicionado ao carrinho

• woocommerce_order_status_changed → alterou o status, webhook acionado

Essas possibilidades tornam a integração com o Chat-Bot poderosa e totalmente automatizável.

🧩 Criando Webhooks no WooCommerce – Passo a Passo

🛠️ Tela principal de Webhooks no WooCommerce

Esse painel permite visualizar, criar, editar e manter todos os webhooks ativos na sua loja.

1️⃣ Acessar as Configurações de Webhook

Caminho:

WooCommerce → Configurações → Avançado → Webhooks

📌 Importante:
Nas versões anteriores ao WooCommerce 3.4, os webhooks ficavam em:

WooCommerce → Configurações → API

2️⃣ Criar um novo Webhook

Dependendo se já existem webhooks configurados:

• Clique em Criar um novo webhook (primeiro acesso)
  ou

• Clique em Adicionar webhook

O WooCommerce abrirá a caixa de dados do webhook.

3️⃣ Configurar as definições principais

A seguir, configure cada campo com atenção:

🏷️ Nome do Webhook

O WooCommerce cria automaticamente um nome como:

"Webhook criado em [data e hora]"

Entretanto, recomenda-se substituir por algo descritivo, como:

"Notificações de Pedidos Chat-Bot"

✔ Ajuda na organização
✔ Facilita o diagnóstico futuro
✔ Padroniza ambientes com múltiplos webhooks

🔄 Status do Webhook

Escolha entre:

• Ativo — O webhook entrega a carga útil corretamente.

• Pausado — Temporariamente desativado (não entrega).

• Desativado — Desativado por falhas ou configurações inválidas.

🔎 Recomendação:
Deixe como Ativo somente após validar o URL do Chat-Bot.

📚 Tópico do Webhook — Quando ele será acionado

Selecione o evento que fará o WooCommerce enviar informações ao Chat-Bot.

Exemplos:

• Pedido criado → Notifica novos pedidos

• Pedido atualizado → Notifica mudanças de status

• Pedido excluído → Remoção definitiva

• Produto atualizado → Alterações de Estoque, Preço ou Dados

• Cliente criado → Contas novas na loja

• Ações personalizadas → Hooks avançados do WooCommerce

Essa seleção é fundamental para que o Chat-Bot receba dados precisos.

🌍 URL de entrega (Endpoint)

Insira o endpoint fornecido pelo Chat-Bot.

Formato:

https://yoursite.com/api/webhooks/[webhook_id]

Esse é o endereço onde o WooCommerce enviará dados automaticamente.

⚠️ Certifique-se de usar exatamente o endpoint gerado pelo Chat-Bot.

4️⃣ Salvar o Webhook

Clique em Salvar webhook.

⚠️ Importante — Primeiro Salvamento

Na primeira ativação, com status Ativo, o WooCommerce enviará automaticamente um:

🔔 PING de teste

Esse ping serve para validar:

• Conectividade

• Endpoint correto

• Resposta esperada

• Autorização do Chat-Bot

Se o ping falhar, o WooCommerce poderá desativar o webhook automaticamente.

📄 Navegação

Página anterior: Ouvinte de Webhook
Próxima página: Perguntas frequentes