Zydon

Showing 25 of 121 from the live probe.

• Ver sessão atual

  Mostra o estado da autenticação atual: se há sessão ativa, qual usuário, qual organização, qual ambiente e se a renovação automática está disponível. 🎯 QUANDO USAR: - Antes de operações no admin, para saber se já existe sessão e em qual organização ela está. - Quando uma tool falhar com AUTH_REQUIRED, para entender se o caso é fazer login ou pedir um token novo ao Zydon. - Quando uma tool falhar com ORGANIZATION_REQUIRED, para confirmar que falta o usuário escolher a organização.

• Autenticar no Zydon

  Autentica um usuário do admin Zydon com e-mail e senha e abre uma sessão neste servidor. 🔐 COMO FUNCIONA: - Os tokens ficam guardados no servidor, associados à sua sessão. Você não precisa (e não vai) manipulá-los. - A renovação por refresh token é automática enquanto a sessão existir. 🔑 SEGUNDO FATOR: Se a conta tiver 2FA, a resposta vem com status "2FA_REQUIRED" e um challenge_id. Nesse caso peça o código de 6 dígitos ao usuário e chame verify_two_factor com o challenge_id devolvido aqui. 🏢

• Encerrar sessão

  Encerra a sessão neste servidor MCP, descartando os tokens guardados. ⚠️ Isso remove a sessão do servidor; o token em si continua válido no backend até expirar naturalmente.

• Escolher organização

  Define em qual organização a sessão vai operar, emitindo um token novo já escopado nela. 🎯 QUANDO USAR: - Depois que login ou verify_two_factor responder "ORGANIZATION_SELECTION_REQUIRED". - Quando o usuário quiser trocar de organização durante a conversa. ⚠️ A escolha é do usuário: pergunte antes, não decida por ele. Se ele não souber o id, use list_organizations (com search) para localizar.

• Confirmar segundo fator

  Conclui o login informando o código do segundo fator (2FA). 🎯 QUANDO USAR: Depois que a tool login responder com status "2FA_REQUIRED" — use o challenge_id que ela devolveu. 🔢 MÉTODOS: - TOTP (padrão): código de 6 dígitos do app autenticador. - RECOVERY: código de recuperação, para quando o usuário perdeu o app. ⏱️ O desafio expira. Se a resposta disser que expirou, chame login de novo para gerar outro challenge_id. 🏢 ORGANIZAÇÃO: a resposta segue a mesma regra do login — "AUTHENTICATED" com

• Listar organizações

  Lista as organizações visíveis para o usuário autenticado, com paginação e busca. 📋 RETORNA: id, nome e datas de criação/atualização de cada organização, mais o total de registros. 🎯 QUANDO USAR: - Para descobrir o id de uma organização antes de operações que o exigem. - Para conferir quantas organizações a conta enxerga. 🔎 BUSCA: o parâmetro search filtra por nome; omita para listar tudo. 📄 PAGINAÇÃO: page começa em 0 e per_page vai até 100.

• Descobrir o que uma URL do admin aponta

  Diz QUAL recurso uma URL do admin está mostrando, e qual tool lê esse recurso. 🎯 QUANDO USAR: sempre que o usuário colar uma URL do admin — "quais os SKUs desse pedido? https://admin.zydon.com.br/sales/pedidos/central/detalhe/01a0…". É o gesto natural de quem está com a tela aberta, e a URL já traz o id escrito em texto puro. ⚠️ NÃO responda "não abro URLs do admin". É verdade e inútil ao mesmo tempo: ninguém precisa abrir a URL — o id está NELA. Esta tool lê esse id e diz qual tool chamar em

• Ver status do domínio personalizado

  Estado da validação do domínio personalizado da loja. 📋 RETORNA o estado atual (por exemplo DISABLED quando não há domínio próprio configurado) e o registro CNAME que precisa existir no DNS do cliente. 🎯 QUANDO USAR: quando o usuário perguntar por que o domínio próprio ainda não funciona, ou o que falta configurar no DNS. ⚠️ Só lê. A configuração de domínio é feita pela tela do admin.

• Ver páginas institucionais da loja

  Lista as páginas institucionais que aparecem no rodapé da loja — termos de uso, política de cookies e política de privacidade. 📋 RETORNA por página: título, endereço na loja, se está publicada e onde aparece. 📝 CONTEÚDO: o corpo é HTML e costuma ser longo. Vem omitido por padrão; peça include_body=true só quando o usuário quiser o texto, e mesmo assim ele vem truncado em 500 caracteres. 🎯 QUANDO USAR: para conferir se a loja tem termos publicados, qual o endereço de cada página, ou quando o u

• Ver configuração da loja

  Lê a configuração de personalização da loja da organização ativa. 📋 RETORNA, agrupado por seção: - identity: nome da loja, razão social, CNPJ, cor primária, logo, favicon, imagem de login - domain: endereço da loja (subdomínio) e domínio personalizado, quando houver - seo: título e descrição para buscadores, e a imagem de compartilhamento - email: provedor de envio configurado (a senha NUNCA é devolvida) - tracking: Google Tag Manager e botão flutuante de WhatsApp 🎯 QUANDO USAR: para responder

• Ver tema da loja

  Lê o TEMA da loja: a cor principal e as cores dos seis blocos da vitrine. 🎨 OS SEIS BLOCOS: botão primário, botão secundário, botão terciário, barra de categorias, cabeçalho e rodapé. Cada um tem as suas cores de fundo, texto, ícone, borda e link, mais as versões "ao passar o mouse". ⚙️ MODO AVANÇADO: a paleta dos blocos só vale com ele LIGADO. Com ele desligado a loja ignora todos os blocos e monta tudo a partir da cor principal. Esta tool diz em que estado ele está — sem isso, uma paleta bon

• Redes sociais, bandeiras de pagamento e selos do portal

  Lê e altera os três blocos de confiança do rodapé do portal: redes sociais, bandeiras de pagamento e selos. 🎯 QUANDO USAR: "põe o Instagram da loja", "mostra que aceita Pix", "adiciona o selo do Reclame Aqui". São os blocos que o comprador usa para decidir se confia — e é comum estarem vazios sem ninguém notar. 📋 CADA UM TEM TÍTULO E UMA LISTA. O título é o que aparece acima do bloco. A lista é substituída inteira ao ser enviada: para acrescentar um item, leia antes, junte, e mande a lista com

• Enviar e-mail de teste

  Envia um e-mail de teste usando a configuração JÁ SALVA da loja, para confirmar que o envio funciona. 🎯 QUANDO USAR: depois de configurar o provedor, ou quando o usuário relatar que a loja parou de enviar e-mails. 📧 Envia de verdade para os endereços informados — não use endereço de cliente para testar. 🔐 Esta tool NÃO pede credenciais: ela usa o que está gravado. Se o teste falhar, o problema está na configuração salva, que é exatamente o que se quer descobrir.

• Configurar envio de e-mail da loja

  Configura o provedor de e-mail que a loja usa para enviar confirmação de pedido e demais notificações. 🔐 CREDENCIAL NA CONVERSA: a senha de SMTP e a chave da Elastic passam por esta conversa para chegar aqui, e a conversa fica registrada. Avise o usuário disso antes de pedir a senha, e prefira orientá-lo a usar a tela do admin quando ele tiver essa opção. ⚠️ A SENHA VAI SEMPRE. A API nunca devolve a senha gravada, então não há como reaproveitá-la: gravar SMTP sem senha derruba o envio da loja

• Alterar identidade da loja

  Altera nome da loja, razão social, CNPJ e cor primária. ⚠️ MUDANÇA PÚBLICA: o que for alterado aqui aparece na loja imediatamente, para todos os clientes. Confirme com o usuário o valor exato antes de aplicar. 🖼️ IMAGENS: informe o file_id que veio do upload_file. Suba primeiro com destination "logo", "favicon" ou "login" — assim a proporção é conferida antes, e o erro diz o que o campo exige em vez de recusar depois. 🎨 COR: aceite com ou sem "#" — a API guarda sem, e a tool converte. 📝

• Alterar SEO da loja

  Altera o título e a descrição que aparecem no Google e nos links compartilhados da loja. ⚠️ MUDANÇA PÚBLICA: é o texto que buscadores e redes sociais vão exibir. 📏 LIMITES: título até 100 caracteres, descrição até 255. 🖼️ A imagem de compartilhamento é enviada por upload_file, não aqui. 📝 Informe SÓ o que muda; o resto é preservado.

• Alterar rastreamento e botão de WhatsApp

  Configura o Google Tag Manager e o botão flutuante de WhatsApp da loja. ⚠️ MUDANÇA PÚBLICA: o botão aparece para todos os clientes da loja assim que for ativado, e o número informado passa a receber as mensagens. Confirme o número com o usuário antes de aplicar. 📞 NÚMERO: informe com DDD. A tool remove máscara e envia só dígitos. 📝 Informe SÓ o que muda; o resto é preservado.

• Alterar tema da loja

  Altera a cor principal e a paleta dos seis blocos da vitrine. 🚨 MUDA A LOJA INTEIRA, PARA TODOS OS CLIENTES, NA HORA. Não há rascunho, não há pré-visualização e não há desfazer: o que for gravado aqui é o que o próximo visitante vê. Diga ao usuário exatamente o que vai mudar e confirme antes. 🎨 A ALTERAÇÃO É POR BLOCO, não por campo solto: - primary_button: bg_color, text_color, icon_color, hover_bg_color, hover_text_color, hover_icon_color - secondary_button: border_color, text_color, icon_

• Ler configurações de acesso

  Lê como novas pessoas entram na loja: se a solicitação de acesso está aberta, se a aprovação é automática, que grupos o novo usuário recebe e qual automação está ligada. 📋 RETORNA: solicitação habilitada, aprovação automática (para usuário de cliente existente e para cliente novo), tipo de pessoa aceito, grupos aplicados e a automação. 🎯 QUANDO USAR: quando o lojista perguntar por que alguém não consegue se cadastrar, por que uma aprovação não saiu sozinha, ou antes de mudar a regra de entrada

• Ler configurações de catálogo

  Lê como o catálogo da loja se comporta: vitrine, busca, filtros, ordenação, detalhe do produto, preço e estoque. 📋 SEÇÕES (peça só as que interessam — são 11 recursos diferentes e pedir tudo gasta contexto à toa): - list_layout — modos de exibição da lista, colunas, subtotal - search — busca: título, QR code, marcas, categorias, mais buscados - filters — filtros laterais da vitrine - sort — campos de ordenação oferecidos ao cliente - listing_rule — regra que decide QUAIS produtos aparecem - hig

• Ler configurações de clientes e vendedores

  Lê o que clientes e vendedores podem FAZER na loja, e a regra de limite de crédito. 📋 RETORNA três conjuntos: - seller_actions — ações de orçamento, financeiro e pedido que o VENDEDOR tem, e se ele pode editar frete - customer_actions — as mesmas famílias de ação para o CLIENTE - credit_limit — se o pedido é bloqueado ao estourar o limite e se o controle do limite é externo (vem do ERP) 🎯 QUANDO USAR: quando perguntarem por que um vendedor não consegue fazer algo, por que um cliente conseg

• Listar requisitos de checkout

  Lista os requisitos mínimos que um pedido precisa cumprir para o cliente finalizar a compra. 📋 Cada requisito tem: nome, tipo de condição (quantidade de itens no carrinho ou valor total em produtos), mínimo, máximo, se está ativo, e a quem se aplica — clientes e segmentos específicos, ou todos quando as duas listas estão vazias. 🎯 QUANDO USAR: quando o lojista perguntar por que um cliente não consegue fechar o pedido, ou antes de criar ou mudar um requisito. ⚠️ Diferente das outras configuraç

• Gerenciar requisito de checkout

  Cria, altera ou remove um requisito mínimo para o cliente finalizar o pedido. ⚠️ MUDANÇA QUE BLOQUEIA VENDA. Um requisito impede o cliente de fechar o pedido enquanto o carrinho não atender à condição. Diga em palavras o que vai passar a ser exigido e de quem, e confirme antes de gravar. 📋 CONDIÇÃO: por quantidade de itens no carrinho ou por valor total em produtos. Informe mínimo, máximo, ou os dois. 👥 A QUEM SE APLICA: com partner_ids e profile_ids vazios, vale para TODOS os clientes. Use l

• Campos de persistência do formulário de acesso

  Cria o conjunto que decide QUAIS respostas do formulário de acesso viram dado no cadastro do cliente. 🔗 SOZINHA ELA NÃO LIGA NADA. Devolve um id; para o conjunto passar a valer, chame update_access_settings com value_assignment_id igual a esse id. São dois passos porque a tela também faz em dois. 📋 Cada item de "campos" liga uma pergunta do formulário a um campo do cadastro. Use manage_form_fields para descobrir os campos do formulário.

• Gerenciar webhooks

  Lista, cria, altera ou exclui webhooks — as chamadas que a Zydon dispara para sistemas de fora quando algo acontece na loja. 🚨 UM WEBHOOK MANDA DADO PARA FORA DA ZYDON. Apontar um webhook para o endereço errado VAZA DADO DE PEDIDO E DE CLIENTE para quem estiver naquele domínio: não há allowlist de destino, não há assinatura de payload, e os cabeçalhos configurados (que normalmente carregam token de autenticação) viajam em toda chamada. Antes de criar ou alterar, diga ao usuário o domínio de des