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.

Atualizado em 09/11/2026Só o dono da marca

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

O card Ações da integração com os três botões

Os botões do card Ações#

BotãoO que fazQuando 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 produtosImporta produtos e variações (na Yampi, SKUs) da loja.Depois de conectar, ou quando um produto novo ainda não aparece em Produtos.
Reconciliar agoraVerifica 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:

StatusSignificadoO que fazer
Recebendo eventosEstá tudo certo.Nada.
Aguardando primeiro eventoO webhook está registrado, mas nenhum pedido chegou ainda.Normal logo depois de conectar. Faça uma compra de teste.
Último evento falhouO último aviso da loja não foi processado.Clique em Reconciliar agora. Se continuar, fale com o suporte.
Webhook não configuradoA 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#

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

Este artigo ajudou?

Não resolveu?

Fale com a gente. A mensagem já vai com a tela e o artigo, para agilizar o atendimento.

Leia também