Webhooks, sincronizar produtos e "Reconciliar agora"
O que fazem os botões Registrar webhooks, Sincronizar produtos e Reconciliar agora, o que roda sozinho e como ler a saúde do webhook.
A loja avisa o painel de cada pedido por webhook, em tempo real. Para o caso de algum aviso se perder, existem a reconciliação e a sincronização do catálogo. Você encontra tudo na tela da sua integração: Configurações › Loja e depois Gerenciar conexão (Nuvemshop e Yever) ou Gerenciar credenciais (Yampi).
Os botões do card Ações#
| Botão | O que faz | Quando usar |
|---|---|---|
| Registrar webhooks (Nuvemshop) / Registrar webhook (Yampi) | Registra (ou confere) na loja os avisos de pedido. | Logo depois de conectar, ou quando o card Webhook mostra Webhook não configurado. |
| Sincronizar produtos | Importa produtos e variações (na Yampi, SKUs) da loja. | Depois de conectar, ou quando um produto novo ainda não aparece em Produtos. |
| Reconciliar agora | Verifica os pedidos dos últimos 3 dias, caso algum webhook tenha se perdido. | Quando um pedido com cupom ou link do programa não apareceu em Pedidos. |
Na Yever não existe Registrar webhooks: o webhook é criado no painel da Yever. Veja conectar a Yever.
Se um botão falhar, a mensagem de erro aparece embaixo e ele vira Tentar novamente.
O que roda sozinho#
- Catálogo: lojas conectadas têm o catálogo sincronizado automaticamente uma vez por hora.
- Reconciliação: uma vez por dia, de madrugada, a plataforma relê os últimos 3 dias de pedidos de cada loja conectada e recupera os que faltarem.
O botão Reconciliar agora só antecipa o que a reconciliação diária já faria.
A saúde do webhook#
O card Webhook no topo da tela mostra:
| Status | Significado | O que fazer |
|---|---|---|
| Recebendo eventos | Está tudo certo. | Nada. |
| Aguardando primeiro evento | O webhook está registrado, mas nenhum pedido chegou ainda. | Normal logo depois de conectar. Faça uma compra de teste. |
| Último evento falhou | O último aviso da loja não foi processado. | Clique em Reconciliar agora. Se continuar, fale com o suporte. |
| Webhook não configurado | A loja não está avisando o painel. | Clique em Registrar webhooks (ou, na Yever, refaça o passo 2). |
Embaixo aparecem a data do último evento e quantos eventos chegaram (e quantos falharam) nos últimos 7 dias.
Atividade recente#
O card Atividade recente lista cada comunicação com a loja: Recebido (avisos que chegaram) ou Enviado (chamadas do painel para a loja), com data e hora. Um ponto vermelho indica falha.
Mensagens de sucesso#
| Mensagem | Significado |
|---|---|
| "X webhooks registrados na Nuvemshop." / "Webhook registrado na Yampi." | Os avisos de pedido estão ativos. |
| "X variações sincronizadas, Y com página na loja." | O catálogo foi atualizado. |
| "X pedidos verificados, Y com atribuição." | A reconciliação leu X pedidos da loja; Y tinham cupom ou link do programa. |
Perguntas frequentes#
A reconciliação verificou pedidos, mas nenhum apareceu. Por quê?
Só entram no painel os pedidos com sinal do programa (cupom de afiliada ou link rastreado). Os demais são verificados e ignorados. Veja um pedido não apareceu.
Quem da equipe pode usar esses botões?
Só o dono da marca vê o card Ações.

