> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Personalizar Portais de Clientes, Controlos de Acesso e Taxas de Imposto
> Personalize as páginas de início e registo de clientes, controle a visibilidade da barra lateral por função e configure taxas de imposto para faturas e pagamentos no AgencyHandy.
O AgencyHandy oferece-lhe controlo total sobre o que os seus clientes veem e experienciam — desde a primeira página em que acedem ao iniciar sessão, até às secções da plataforma às quais podem navegar após o login. Esta página abrange quatro áreas de configuração interligadas: o **Portal de Início de Sessão**, o **Portal de Registo**, os **Controlos de Barra Lateral & Acesso** e as **Taxas de Imposto**. Em conjunto, estas definições permitem-lhe criar uma experiência polida e adequada à função para cada utilizador no seu workspace.
Todas as definições desta página requerem acesso de **Super Admin** ou **Admin**. Aceda a **Workspace Config** na barra lateral esquerda para aceder a cada secção.
***
## Portal de Início de Sessão
O Portal de Início de Sessão é a página de login que os seus clientes e membros de equipa veem quando acedem ao seu workspace do AgencyHandy. Personalizá-la garante que a primeira impressão que os clientes têm é totalmente alinhada com a sua marca — com as imagens, o título e a mensagem da sua agência.
### O Que Pode Personalizar
| Elemento | Descrição | Limite |
| ------------ | -------------------------------------------------------------- | -------------------------- |
| **Título** | O título principal exibido no topo da página de login | Máx. 120 caracteres |
| **Imagem** | Uma fotografia ou ilustração com a sua marca exibida na página | PNG, JPG, JPEG — máx. 5 MB |
| **Subtexto** | Uma mensagem curta abaixo dos campos de login | Máx. 300 caracteres |
### Passos para Personalizar o Portal de Início de Sessão
Aceda a **Workspace Config** na navegação esquerda e selecione **Portal de Início de Sessão** no submenu.
Escreva o título pretendido no campo **Título**. Mantenha-o conciso e relevante — por exemplo, *"Bem-vindo de volta a \[Nome da Agência]"* ou *"O Seu Portal de Cliente."* O comprimento máximo é 120 caracteres.
Clique na área de carregamento ou arraste e largue um ficheiro de imagem (PNG, JPG ou JPEG, máximo 5 MB) para adicionar um elemento visual à página de início de sessão. Esta imagem aparece tipicamente junto ao formulário de login.
Utilize uma imagem de alta qualidade que represente a sua agência — uma fotografia da sua equipa, uma ilustração limpa da marca ou um fundo profissional. Certifique-se de que o tamanho do ficheiro é inferior a 5 MB para evitar erros de carregamento.
No campo **Subtexto**, escreva uma mensagem breve para aparecer abaixo dos campos de login — por exemplo, uma nota de boas-vindas, contacto de suporte ou um slogan curto. Mantenha-o com menos de 300 caracteres.
Reveja o layout da página de início de sessão através da pré-visualização. Quando estiver satisfeito, clique em **Guardar** (ou **Atualizar**) para aplicar as alterações. As alterações têm efeito imediato.
### Repor as Predefinições
Clique em **Repor Definições Predefinidas** na página do Portal de Início de Sessão para remover todas as personalizações e restaurar a página de início de sessão original do AgencyHandy.
Repor as predefinições é irreversível. Todos os títulos, imagens e subtextos personalizados serão removidos permanentemente. Clique em **Cancelar** se não tiver a certeza — as alterações não guardadas são descartadas e as definições guardadas atuais permanecem intactas.
### Boas Práticas
* Mantenha o título curto e acolhedor — os clientes veem-no antes de iniciarem sessão, por isso torne-o tranquilizador.
* Utilize uma imagem profissional que represente a sua agência. Evite fotografias de stock genéricas que pareçam desconectadas da sua marca.
* Pré-visualize em diferentes tamanhos de ecrã antes de guardar para garantir que o layout da imagem e do texto parece correto.
* Se a imagem não carregar, confirme que cumpre os requisitos de formato (PNG, JPG, JPEG) e tamanho (menos de 5 MB).
## Portal de Registo
O Portal de Registo é a página de registo onde os novos clientes chegam quando criam uma conta no seu workspace. Personalizá-lo cria uma experiência de marca consistente desde a primeira interação que um potencial cliente tem com a plataforma da sua agência.
### O Que Pode Personalizar
| Elemento | Descrição | Limite |
| ------------ | -------------------------------------------------------------- | -------------------------- |
| **Título** | O título principal exibido no topo da página de registo | Máx. 120 caracteres |
| **Imagem** | Uma fotografia ou ilustração com a sua marca exibida na página | PNG, JPG, JPEG — máx. 5 MB |
| **Subtexto** | Uma mensagem curta abaixo dos campos de registo | Máx. 300 caracteres |
### Passos para Personalizar o Portal de Registo
Aceda a **Workspace Config** na navegação esquerda e selecione **Portal de Registo** no submenu.
Escreva um título no campo **Título** que dê as boas-vindas a novos clientes. Por exemplo, *"Comece com \[Nome da Agência]"* ou *"Crie a sua conta de cliente."* Máximo 120 caracteres.
Clique na área de carregamento ou arraste e largue um ficheiro de imagem (PNG, JPG ou JPEG, máximo 5 MB). Esta imagem é exibida na página de registo junto ao formulário de registo.
Utilize o mesmo estilo visual e paleta de cores nas imagens do portal de Início de Sessão e de Registo para criar uma experiência coesa entre as duas páginas.
Escreva uma mensagem de apoio curta no campo **Subtexto** — por exemplo, instruções sobre o que esperar após o registo, ou uma breve proposta de valor. Máximo 300 caracteres.
Reveja a página de registo usando a opção de pré-visualização. Clique em **Guardar** (ou **Atualizar**) para aplicar as alterações imediatamente.
### Repor as Predefinições
Clique em **Repor Definições Predefinidas** na página do Portal de Registo para remover todas as personalizações e restaurar a página de registo original do AgencyHandy.
Esta ação não pode ser desfeita. Todas as configurações personalizadas de título, imagem e subtexto serão apagadas permanentemente.
### Boas Práticas
* Ajuste o tom do título de registo ao seu estilo geral de comunicação com clientes — profissional, amigável ou ambos.
* Mantenha o subtexto focado: informe os novos clientes sobre o que acontece depois de se registarem (por exemplo, *"Após o registo, a nossa equipa enviará um email de boas-vindas nas próximas 24 horas."*).
* Teste o fluxo de registo você mesmo após guardar as alterações para confirmar que a página tem o aspeto e comportamento esperados.
## Controlos de Barra Lateral & Acesso
As definições de Barra Lateral & Acesso permitem-lhe controlar exatamente o que cada função de utilizador pode ver no menu de navegação esquerdo. Pode renomear itens de menu para corresponder à terminologia da sua agência, substituir ícones predefinidos por ícones personalizados e alternar a visibilidade de qualquer secção de menu por função. O resultado é uma interface mais limpa e orientada para cada pessoa que inicia sessão.
### Funções Que Pode Configurar
* Cliente
* Super Admin
* Admin
* Gestor
* Assignee
* Personalizado (quaisquer funções personalizadas que tenha criado em Funções & Permissões)
### Passos para Personalizar os Itens do Menu da Barra Lateral
Aceda a **Workspace Config** e selecione **Barra Lateral & Acesso** no menu de definições.
Clique no botão **Personalizar** no topo do painel. A lista completa dos itens de menu da barra lateral atual aparece sob a categoria **Principal**.
Clique no campo de texto de qualquer item de menu e escreva o novo rótulo. Por exemplo, renomeie "Dashboard" para "Visão Geral" ou "CRM" para "Contactos." Clique em **Guardar** para aplicar o novo nome.
Clique no ícone junto ao nome de um item de menu. Abre-se um popup com um conjunto de opções de ícones — selecione um da biblioteca ou carregue uma imagem personalizada de 32×32 px para usar o seu próprio ícone com a marca. Clique em **Guardar** para aplicar.
### Passos para Configurar a Visibilidade por Função
Clique no botão **Editar Acesso** (junto ao botão **Personalizar**). Verá separadores para cada função disponível.
Clique no separador da função que pretende configurar — por exemplo, **Cliente**.
Para cada item de menu listado, use o interruptor para mostrar ou ocultar para a função selecionada. Por exemplo, pode ocultar **Faturas** e **Subscrições** dos Clientes enquanto as mantém visíveis para Admins e Gestores.
Clique em **Guardar**. As definições de visibilidade atualizadas têm efeito imediato — os utilizadores veem as alterações na próxima navegação de página ou após voltarem a iniciar sessão.
Clique em **Repor para Predefinições** no separador de qualquer função para restaurar as definições de visibilidade originais para essa função.
Uma barra lateral limpa e minimalista melhora a experiência do cliente. Mostrar aos clientes apenas o que precisam — como **Dashboard**, **Encomendas** e **Mensagens** — reduz a confusão e evita que acedam a secções exclusivas para uso interno.
### Exemplos de Configurações por Função
| Função | Secções Visíveis Recomendadas |
| ----------- | --------------------------------------------------------- |
| Cliente | Dashboard, Encomendas, Mensagens, Faturas (se necessário) |
| Gestor | CRM, Projetos, Folha de Ponto, Tarefas |
| Assignee | Dashboard, Tarefas, Projetos, Mensagens |
| Super Admin | Todas as secções (sem restrições) |
### Notas Importantes
* **As alterações são instantâneas:** As atualizações de visibilidade por função refletem-se imediatamente após os utilizadores atualizarem a página ou voltarem a iniciar sessão.
* **A função mais permissiva prevalece:** Se um utilizador tiver várias funções, a função com o acesso mais amplo tem precedência.
* **Ícones personalizados:** Carregue imagens de 32×32 px para corresponder aos visuais da marca da sua agência na barra lateral.
* **Consistência de nomes:** Use convenções de nomenclatura claras e consistentes que toda a equipa entenda — evite abreviações ou jargão interno que os novos membros da equipa não reconhecerão.
## Taxas de Imposto
A funcionalidade de Taxas de Imposto permite-lhe criar, gerir e aplicar configurações de impostos nos seus serviços, subscrições e faturas. Pode configurar vários tipos de imposto — IVA, GST, Imposto sobre Vendas e outros — com taxas específicas por país e estado, suporte para modelos de preços tanto inclusivos como exclusivos, e aplicação automática no checkout com base na localização do cliente.
Apenas **Super Admins** e **Admins** podem criar, editar ou eliminar configurações de impostos.
### Conceitos de Imposto em Resumo
| Conceito | Definição |
| ------------- | ---------------------------------------------------------------------------------------------------- |
| **Exclusivo** | O imposto é adicionado ao preço listado no checkout (por exemplo, 100 € + 10% imposto = 110 € total) |
| **Inclusivo** | O imposto já está incluído no preço apresentado ao cliente (por exemplo, 110 € já incluem o imposto) |
| **ID Fiscal** | O número de identificação fiscal da sua agência, mostrado nas faturas |
### Passo 1: Criar uma Taxa de Imposto
Aceda a **Workspace Config** e clique no separador **Taxas de Imposto**.
Clique no botão **+ Novo Imposto**. Aparece um formulário.
Complete os seguintes campos:
* **Título / Tipo de Imposto** *(obrigatório)*: Introduza um nome descritivo, por exemplo, IVA Standard, GST Reduzido ou Imposto sobre Vendas EUA. Máximo 255 caracteres.
* **ID Fiscal** *(opcional)*: O número de identificação fiscal da sua agência. Máximo 20 caracteres.
* **País de Origem**: Selecione o país principal ao qual este imposto se aplica.
* **Taxa de Imposto Geral do País de Origem %** *(opcional)*: A taxa predefinida para o seu país de origem.
* **Taxas por País** *(opcional)*: Adicione taxas por país com estado, código postal e percentagem opcionais. Isto é útil para agências que servem clientes em múltiplas jurisdições fiscais.
Coloque o imposto como **Ativo** para o tornar imediatamente disponível para uso em serviços e faturas. Defina-o como **Inativo** para guardar a configuração sem o aplicar a novas compras ainda.
Clique em **Guardar**. O imposto aparece na sua lista de Taxas de Imposto e está agora disponível para associar a serviços.
Pode suportar até 4 casas decimais nas percentagens de taxa de imposto. Uma taxa de 0% é válida — use-a para artigos com taxa zero ou cenários de conformidade onde o imposto deve ser listado mas totaliza zero.
### Passo 2: Associar Impostos a Serviços
Navegue até **Serviços** e crie um novo serviço ou edite um existente.
Avance para o Passo 3 (Informação Adicional) do assistente de configuração do serviço.
Clique em **Adicionar Imposto** e selecione um ou mais tipos de imposto da sua lista configurada. Escolha se os impostos se aplicam como **inclusivos** ou **exclusivos** para este serviço. Esta definição aplica-se a todos os impostos associados no serviço, incluindo taxas de configuração e add-ons.
### Passo 3: Como os Impostos São Aplicados
Os impostos podem ser aplicados **automaticamente durante o checkout** ou **manualmente nas faturas**:
**Automático (Checkout)**
* Os impostos associados a um serviço são calculados automaticamente com base na localização de faturação do cliente.
* O cliente deve fornecer o seu país, estado e código postal no checkout para que o imposto baseado em localização seja aplicado.
* Para contas Stripe Índia, as informações completas de localização (país, estado, código postal) são obrigatórias.
**Manual (Fatura)**
* Ao criar uma fatura manualmente, clique em **Adicionar Impostos** para escolher quais impostos aplicar.
* Os campos de endereço de faturação são preenchidos automaticamente.
* **Apenas impostos exclusivos** podem ser aplicados a faturas manuais — os impostos inclusivos não são suportados neste fluxo.
### Apresentação do Imposto na Fatura
Cada fatura que inclui um imposto mostra os seguintes detalhes:
* **Nome do Imposto** — o rótulo que introduziu (por exemplo, IVA, GST)
* **Percentagem do Imposto** — a taxa aplicada (por exemplo, 15%)
* **Valor do Imposto** — o valor calculado cobrado
### Gerir Taxas de Imposto Existentes
* **Editar um imposto:** Clique na entrada do imposto na lista para atualizar o seu título, taxa ou regras por país. As atualizações aplicam-se apenas a faturas e compras futuras.
* **Eliminar um imposto:** Os impostos eliminados deixam de se aplicar a novas compras ou subscrições, mas as faturas existentes que os incluíam não são afetadas.
* **Desativar um imposto:** Defina um imposto como **Inativo** para parar de o aplicar a novas compras sem eliminar a configuração.
### Notas Importantes
* **Os descontos de cupões aplicam-se antes do imposto:** Quando um cliente usa um cupão de desconto, o imposto é calculado sobre o preço com desconto, não sobre o preço original.
* **Múltiplos impostos por serviço:** Pode associar mais de um imposto a um único serviço (por exemplo, IVA + GST em simultâneo).
* **O imposto aplica-se a add-ons e taxas de configuração:** Se o seu serviço tiver uma taxa de configuração ou add-ons, o imposto é também aplicado a esses valores.
* **A localização do cliente é pré-preenchida:** Se um cliente tiver um país e estado de faturação guardados no seu perfil, esses campos são pré-preenchidos no checkout. No entanto, editar a localização durante o checkout **não** atualiza o perfil do cliente.
* **Deteção de estado por código postal:** Para clientes nos EUA, o sistema pode detetar automaticamente o estado a partir do código postal e aplicar o imposto regional correto, se configurado.