Conectar a Yampi

Onde achar o alias, o User-Token e o User-Secret-Key da Yampi, como salvar e registrar o webhook, e o que fazer quando dá erro.

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

A Yampi é conectada com três informações da sua conta: o alias da loja, o User-Token e o User-Secret-Key. Só o dono da marca vê e altera essas credenciais.

Passo a passo#

  1. No painel da Yampi, vá em Configurações → API (seção "Aplicações") e gere ou copie o token de API.
  2. No painel da marca, abra Configurações › Loja. Se a plataforma ainda não foi escolhida, clique em Yampi.
  3. No card Yampi, clique em Configurar.
  4. Preencha Alias da loja Yampi (a parte do endereço da sua loja antes de ".yampi.com.br"), User-Token e User-Secret-Key.
  5. Clique em Salvar credenciais.
  6. No card Ações, clique em Registrar webhook. Aparece "Webhook registrado na Yampi." e a integração passa para Conectado.
  7. Clique em Sincronizar produtos para trazer o catálogo.
A tela Integração Yampi com credenciais salvas

As credenciais ficam criptografadas e nunca são exibidas de novo. Para trocar, use Trocar credenciais e depois Salvar novas credenciais.

O que cada status significa#

StatusSignificado
ConectadoCredenciais salvas e webhook registrado.
ErroA última operação com a Yampi falhou. O motivo aparece em "Último erro".
Não configuradoSem credenciais, ou credenciais salvas sem webhook registrado ainda.

O card Webhook mostra a saúde dos avisos: Webhook não configurado, Aguardando primeiro evento, Recebendo eventos ou Último evento falhou.

Erros comuns e o que fazer#

MensagemPor quêO que fazer
"Preencha alias, User-Token e User-Secret-Key."Algum campo ficou vazio.Preencha os três.
"Somente o dono da marca pode alterar credenciais Yampi."Você é da equipe.Peça para o dono.
"Não foi possível registrar o webhook: …"A Yampi recusou o pedido (credenciais erradas ou sem permissão).Confira alias e credenciais, use Trocar credenciais e tente Registrar webhook de novo.
"Não foi possível sincronizar produtos: …"A Yampi não respondeu ou recusou.Clique em Tentar novamente. Se repetir, confira as credenciais.

Perguntas frequentes#

Como desconecto a Yampi?

A tela da Yampi não tem botão de desconectar. Se você mudou de plataforma, veja trocar a plataforma da loja ou fale com o suporte.

Onde vejo o que chegou da Yampi?

Em Atividade recente, na mesma tela: cada evento recebido ou enviado, com data e hora.

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