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.
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#
- No painel da Yampi, vá em Configurações → API (seção "Aplicações") e gere ou copie o token de API.
- No painel da marca, abra Configurações › Loja. Se a plataforma ainda não foi escolhida, clique em Yampi.
- No card Yampi, clique em Configurar.
- Preencha Alias da loja Yampi (a parte do endereço da sua loja antes de ".yampi.com.br"), User-Token e User-Secret-Key.
- Clique em Salvar credenciais.
- No card Ações, clique em Registrar webhook. Aparece "Webhook registrado na Yampi." e a integração passa para Conectado.
- Clique em Sincronizar produtos para trazer o catálogo.
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#
| Status | Significado |
|---|---|
| Conectado | Credenciais salvas e webhook registrado. |
| Erro | A última operação com a Yampi falhou. O motivo aparece em "Último erro". |
| Não configurado | Sem 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#
| Mensagem | Por 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.

