Fone Ninja instável — o que fazer
Diagnóstico quando o banner amarelo "Fone Ninja está instável" aparece, ou o vermelho "credenciais não funcionam mais". Causas, fixes e quando você precisa agir.
A Verbix monitora a saúde da sincronização com o Fone Ninja em tempo real. Quando algo trava, aparece um banner no topo do dashboard com diagnóstico curto e ação sugerida. Esse artigo explica os 2 cenários e o que fazer em cada um.
Cenário 1 — Banner amarelo: "O Fone Ninja está instável agora"
Você vê:
⚠️ O Fone Ninja está instável agora. Última sincronização bem-sucedida foi há X minutos. Seu estoque pode estar desatualizado. Isto é problema do Fone Ninja, não do Verbix. Tente novamente em alguns minutos ou confira direto no painel deles. [Abrir painel do Fone Ninja ↗]
Causa
API do Fone Ninja não está respondendo ou retorna dados inesperados. A Verbix detecta e classifica como falha externa — o sistema deles tá fora do ar (parcial ou total), não tem nada quebrado do nosso lado.
O que fazer
Abre o painel do Fone Ninja (link do banner)
Confere se você consegue logar e ver o estoque normalmente lá. Se eles também tão fora, o cenário é do lado deles e basta aguardar.
Espera 5-10 min
O sistema tenta sincronizar de novo automaticamente. Se voltar, banner some sozinho.
Se passou de 30 min e ainda tá no ar
Abre o chat de Suporte do Fone Ninja pra confirmar se é instabilidade conhecida do lado deles. Em paralelo, pode operar com estoque manualmente (ver "Enquanto tá fora" abaixo).
Por que esse banner existe
Sem ele, você descobriria que o estoque tá desatualizado quando um cliente reclamasse. Com ele, você sabe na hora — e tem a transparência de que o problema não é do Verbix.
Cenário 2 — Banner vermelho: "Credenciais não funcionam" ou "Identificador da loja mudou"
Você vê uma de duas versões:
🔑 Suas credenciais do Fone Ninja não funcionam mais. Parece que a senha foi alterada no painel deles. Seu estoque não está sincronizando. Reconecte pra voltar ao ar. [Reconectar agora →]
OU:
🔑 O identificador da loja no Fone Ninja mudou. O slug da loja não bate mais com o que está cadastrado no Fone Ninja. Seu estoque não está sincronizando. Reconecte pra voltar ao ar. [Reconectar agora →]
Causa
- "Credenciais não funcionam": a senha (ou token de API) que a Verbix tem pra acessar o Fone Ninja não vale mais. Geralmente alguém da equipe trocou a senha no painel deles sem atualizar aqui.
- "Identificador da loja mudou": o slug que identifica sua loja no Fone Ninja mudou. Aconteceu se você reorganizou unidades, mudou o nome cadastrado, ou criou uma loja nova.
O que fazer
Clica em Reconectar agora
O banner já te leva direto pra Configurações → Sistema de Gestão.
Pega credencial atualizada no painel do Fone Ninja
Login com sua conta deles, vai em Configurações → Integrações → Tokens de API. Se for caso de senha trocada: cria token novo. Se for caso de slug mudou: copia o slug atual da loja (fica no rodapé do painel ou nas configurações da loja).
Cola na Verbix e salva
Modal pede token + ID da loja. Cola os dois, salva. Sistema valida na hora — se aceitar, banner some e sync volta no próximo ciclo (5-10 min).
Confere que voltou
Na mesma tela, status muda pra Conectado com horário da última sincronização atualizado.
Procedimento completo de conexão tá em Integração com ERP Fone Ninja.
Enquanto a sincronização tá fora — como operar
| Risco | O que pode acontecer | Como mitigar |
|---|---|---|
| Estoque inflado | A IA oferece item que já vendeu (vendido no Fone, não atualizado aqui) | Confere drill-down do item antes de confirmar venda; usa Confirmar manualmente se necessário |
| Estoque escondido | Item novo cadastrado no Fone ainda não apareceu aqui | No modo Sync (default), a Verbix sobrescreve cadastros locais no próximo sync — cadastrar item direto na aba Produtos não persiste. Caminho seguro: aguarda o Fone voltar e cadastra lá (propaga no próximo sync). Se for urgência operacional E o Fone também está fora, troca temporariamente pra modo Manual (ver Callout abaixo) — aí cadastros locais passam a persistir |
| Preço desatualizado | Mudança de preço no Fone não propagou | No modo Sync (default), a Verbix bloqueia edição de preço pra não conflitar com o Fone — corrige direto no painel do Fone Ninja se conseguir acessar, propaga no próximo sync. Se o Fone também está fora e o ajuste é urgente, ver Callout abaixo sobre trocar modo |
Pra editar preço ou cadastrar item na Verbix durante a falha
No modo Sync (default), edição e cadastro na Verbix ficam subordinados ao Fone Ninja — ele é fonte da verdade e qualquer mudança local seria sobrescrita no próximo sync. Se você precisa ajustar preço OU cadastrar item urgente E o Fone também está fora, o caminho é:
- Vai em Configurações → Robô → Modo de preço e troca de Sync pra Manual
- Edita preço ou cadastra item direto na Verbix — a partir daqui as mudanças locais persistem
- Quando o Fone Ninja voltar e você quiser retomar a fonte da verdade dele, troca o modo de volta pra Sync — a partir daí o Fone sobrescreve
Cuidado: ao voltar pra Sync, mudanças locais feitas no modo Manual serão sobrescritas pelo Fone Ninja. Garante que você reconciliou (cadastrou no Fone também) antes de voltar pra Sync, senão perde os cadastros locais.
Se você já estava em modo Manual (Fone serve só pra estoque/modelos importados, preço sempre da Verbix), pode editar e cadastrar direto sem precisar trocar nada.
Se a integração ficar fora por mais de 1 dia, vale ativar o modo Manual em Configurações → Robô → Modo de preço — Verbix passa a usar só os preços dela e ignora o sync. Lembra de voltar pra Sync depois que reconectar (e reconciliar primeiro — ver Callout).
Como dispensar o banner
Botão "X" no canto direito. Some pela sessão (próxima vez que abrir o dashboard, volta se o problema persistir). Não some pra sempre — é proteção: você não pode esconder permanentemente um aviso de integração quebrada.
Se o erro mudar de categoria (ex: era "instável" e agora é "credenciais erradas"), o banner reaparece mesmo dispensado — são problemas diferentes que exigem ações diferentes.
FAQ
O banner é só pra mim ou todos da equipe veem?
Todo usuário da loja vê. Banner é por loja, não por usuário individual. Útil pra equipe saber que tem operação manual rolando.
Aparece o banner amarelo, mas eu consigo acessar normal o painel do Fone Ninja
Pode ser que o problema esteja num endpoint específico que o Fone usa internamente pra API mas não pro painel. Espera 5-10 min e confere se voltou. Se persistir, abre Suporte deles informando que o painel funciona mas a API tá retornando erro.
Reconectei mas o banner vermelho voltou em 1 min
Provavelmente o token novo também não tem permissão certa. Recria no Fone Ninja marcando Estoque (leitura) + Preços (leitura) + Modelos (leitura) — read-only é o suficiente, write não é necessário.
Posso pausar a integração até resolver?
Sim — em Configurações → Sistema de Gestão tem botão Pausar sync. Banner some, e a Verbix para de tentar sincronizar (não tenta mais até você reativar). Útil quando você sabe que vai ficar fora por dias e não quer banner constante.
Como faço pra ser avisado por email/Slack se a integração travar?
Notificação de saúde da integração tá em roadmap pro plano Pro+ via webhook. Hoje, o aviso só aparece no dashboard.
Banner some, eu reconecto, mas sync nunca acontece
Pode ser cache. Na aba Sistema de Gestão, clica em Sincronizar agora pra forçar uma rodada manual. Se essa não retornar nada em 5 min, abre Suporte.
Configurar do zero
Se a integração ainda não tá configurada: Integração com ERP Fone Ninja — setup passo a passo.
PIX não confirmou — o que fazer
Diagnóstico passo a passo quando o cliente afirma que pagou mas o sistema não confirmou. 90% dos casos resolvem em 5 min.
Esqueci o PIN — como recuperar
Por que a Verbix não tem auto-recuperação de PIN, como solicitar reset pelo suporte, o que fica bloqueado enquanto espera, e como evitar esquecer de novo.