> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🌍 Como configurar o Hoppy Currency Converter

> ℹ️ **Note:** Este artigo foi traduzido automaticamente utilizando IA e pode conter imprecisões. Se algo parecer errado, entre em contato com nossa equipe de suporte.

A Hoppy Currency Converter permite que os clientes vejam os preços em sua moeda preferida durante as compras em sua loja.

Ao exibir preços localizados, o Conversor de Moedas ajuda a criar uma experiência de compras mais familiar, reduz a confusão de preços e melhora a confiança com os visitantes internacionais.

Este guia caminha através do processo completo de configuração, desde a integração até a configuração de moedas e colocação de storefront.

---

# **⚠️ Antes de começar**

Antes de configurar o Conversor de Moedas, certifique-se:

*   Sua Shopify armazenamento está ativo
*   Produtos com preços estão disponíveis na frente da loja
*   Você tem acesso ao seu Shopify Administrador

💡 O Conversor de Moedas depende Shopify's formatação de preço e integração do tema, então um processo de onboarding curto é necessário antes que ele pode começar a converter os preços corretamente.

---

# **✅ Passo 1: Habilitar a incorporação da aplicação**

Para que o Conversor de Moedas apareça em sua storefront, o aplicativo embed deve ser ativado dentro de seu Shopify tema.

Ir para:

**Shopify Admin → Canais de Vendas → Loja online → Temas → Editar Tema → App Incorpora**

Depois:

*   Procurar **Conversor de moeda**
*   Alternar **ON**
*   Clique **Gravar**

Uma vez habilitado, o aplicativo pode exibir o conversor de moeda em sua loja.

---

# **✅ Passo 2: Completar a configuração de integração**

Ao abrir o aplicativo pela primeira vez, você será guiado através de um processo de onboarding curto.

Esta configuração garante que seu tema está configurado corretamente antes do Conversor de Moedas vai ao vivo.

---

## **📝 Configurar o Formato do Dinheiro**

O conversor de moeda identifica elementos de preço usando ShopifyAs configurações de formatação de dinheiro.

Dentro da abordagem:

*   Copie os formatos monetários gerados pela aplicação
*   Abrir:

**Shopify Admin → Configurações → Geral → Armazenar padrões → Exibição de moeda → Alterar formatação de moeda**

Colar os valores gerados em:

*   HTML com moeda
*   HTML sem moeda

Depois:

→ Clique **Gravar**

💡 Usando os formatos gerados ajuda o Conversor de Moedas a detectar e converter os preços de forma consistente em toda a sua loja.

---

## **🔌 Habilitar extensão de tema**

O processo de onboarding também irá guiá-lo através de habilitar a Extensão do aplicativo do tema.

Simplesmente:

*   Abrir o link do Editor de Temas fornecido
*   Activar o Conversor de Moedas
*   Gravar o tema

Isso garante que o conversor de moeda pode carregar corretamente na frente da loja.

---

## **👀 Verificar a Configuração**

Após completar os passos anteriores:

*   Visite sua loja
*   Confirme que o conversor de moeda está visível
*   Voltar à aplicação
*   Clique **Junta completa**

Uma vez concluída, todas as configurações do aplicativo ficam disponíveis.

---

# **✅ Passo 3: Selecione moedas suportadas**

Abrir:

**Configurações → Geral**

Localização:

### **Selecionar moedas**

Use o dropdown para escolher as moedas que você gostaria que os clientes vissem.

### **Acções Disponíveis**

*   Selecionar moedas individuais
*   Selecionar Tudo
*   Desmarcar Tudo

💡 Geralmente é recomendado priorizar moedas usadas pelos seus mercados de clientes primários.

---

# **✅ Passo 4: Configurar a Mudança de Moeda**

A aba Geral contém configurações que controlam como os visitantes mudam de moeda.

---

## **🌍 Interruptor de Moeda Automático**

Detecta automaticamente a localização do visitante e muda para a moeda mais relevante.

### **Quando habilitado**

*   Visitantes veem moedas localizadas automaticamente
*   Nenhuma seleção manual é necessária

### **Exemplo**

*   Visitantes da Alemanha ver EUR
*   Visitantes do Japão ver JPY

---

## **🔒 Restringir a mudança de moeda automática**

Esta opção só aparece quando a opção Auto Money Switch estiver activa.

Use-o para limitar a mudança automática para países selecionados em vez de todos os visitantes.

Isto pode ser útil quando se dirige a mercados internacionais específicos.

---

## **💱 Moeda de Conversão Predefinida**

Esta opção aparece quando o Interruptor de Moeda Automático está desativado.

Escolha a moeda que deve ser exibida por padrão até que os clientes mudem manualmente para outra opção.

---

# **✅ Passo 5: Selecione o modo de exibição da moeda**

Localização:

### **Modo de Moeda Seleccionada**

Esta configuração controla como as moedas aparecem no seletor.

### **Opções Disponíveis**

#### **Seletor de País**

Exibe:

*   Bandeiras de países
*   Nomes dos países
*   Nomes das moedas

### **Exemplo**

🇺🇸 Dólar dos Estados Unidos

---

#### **Seletor de moeda**

Exibe:

*   Códigos monetários
*   Nomes das moedas

### **Exemplo**

🇺🇸 USD

Escolha qualquer estilo que melhor corresponda ao design da sua loja e preferências do cliente.

---

# **✅ Passo 6: Configurar posição de exibição**

Abrir:

**Configurações → Exibir**

Esta seção controla onde o conversor de moeda aparece no desktop e dispositivos móveis.

---

## **💻 Posição do Ecrã**

Escolha onde o conversor de moeda deve aparecer em dispositivos desktop.

### **Estilos de Posição**

#### **Flutuante**

Mostra o conversor de moeda em uma posição fixa enquanto os clientes navegam.

Você também pode selecionar onde deseja colocar o Seletor de Moeda Flutuante. As opções disponíveis são:

*   Superior direito
*   Superior esquerdo
*   Inferior direito
*   Fundo esquerdo

---

#### **Cabeçalho**

Coloca o conversor de moeda dentro do cabeçalho storefront.

---

#### **Posição Personalizada**

Coloca o conversor de moeda dentro de um elemento específico do seu Shopify tema.

Configurações adicionais ficam disponíveis:

*   Elemento Personalizado
*   Colocação Personalizada

💡 Posição personalizada é útil quando você quer o conversor de moeda integrado em uma parte específica do seu tema.

---

## **📱 Posição móvel**

O posicionamento móvel funciona independentemente do posicionamento do desktop.

### **Opções Disponíveis**

*   Flutuante
*   Cabeçalho
*   Posição Personalizada

Isso permite que você crie experiências separadas para visitantes desktop e móveis.

---

## **📍 Posição da exibição**

Dependendo do estilo selecionado, você pode ser capaz de escolher posições como:

*   Superior Esquerda
*   Superior Direita
*   Baixo- Esquerda
*   Baixo- Direita

Estas posições controlam onde o conversor de moeda aparece na tela.

---

## **📐 Configuração do Deslocamento**

Configurações de deslocamento permitem que você ajuste o espaçamento das bordas da tela.

Os exemplos incluem:

*   Deslocamento superior
*   Deslocamento inferior
*   Deslocamento Esquerda
*   Deslocamento Direito

Essas configurações ajudam a evitar a sobreposição com outros elementos de storefront.

---

# **✅ Passo 7: Salve sua Configuração**

Uma vez configurado:

*   Moedas apoiadas
*   Comportamento de mudança de moeda
*   Modo de visualização da moeda
*   Colocação da área de trabalho
*   Colocação móvel

Clique em:

→ **Gravar**

Sua configuração do Conversor de Moeda agora está ativa.

---

# **⚠️ Notas Importantes**

### **Os preços são convertidos para exibição**

O Conversor de Moeda atualiza os preços da loja para conveniência do cliente.

Moeda de checkout final depende de sua Shopify configuração e suportada Shopify Configuração dos mercados.

---

### **Widget Não Aparecer?**

Se o conversor de moeda não estiver visível:

*   Verificar a incorporação do aplicativo está habilitada
*   A verificação da integração foi concluída
*   Verificar os formatos monetários foram configurados corretamente
*   Atualizar a frente da loja

---

### **Personalizar a Aparência**

A seção Design permite personalizar:

*   Cores
*   Tipografia
*   Fronteiras
*   Bandeiras
*   Estilo de layout

Isso ajuda o Conversor de Moedas a combinar com sua marca storefront.

---

### **Notificação do Carrinho Disponível**

O recurso de notificação do carrinho pode ser habilitado separadamente para lembrar aos clientes sobre o comportamento da moeda antes do checkout.

---

# **🎉 Resultado Final**

Uma vez configurado com sucesso:

✅ Os clientes podem ver os preços em sua moeda preferida

✅ Visitantes internacionais recebem uma experiência mais localizada

✅ A mudança de moeda funciona automaticamente ou manualmente

✅ Colocações de desktop e móveis são totalmente personalizáveis

✅ O conversor de moeda integra perfeitamente em sua loja

Usando o Conversor de Moedas ajuda a tornar sua loja mais acessível aos clientes globais, criando uma experiência de compras mais suave e confiável. 🌍

---