> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Criação

Bases de dados, sistemas de início de sessão, notificações por e-mail, funcionalidades de IA, painéis de administração, SEO. O agente cria funcionalidade real, não só páginas.

***

## Base de dados

Diz ao agente o que a tua app precisa de guardar e ele configura a base de dados. Clientes, marcações, produtos, encomendas. Cria o esquema, a lógica para guardar e obter dados, e liga tudo à tua interface.

**Como usar**

Descreve que dados a tua app regista. Menciona os tipos de registo, os campos e como se relacionam entre si.

**Exemplos de prompts:**

```
Configura um sistema de marcações para a minha barbearia com 4
barbeiros. Guarda os dados do cliente (nome, telefone, e-mail),
horários disponíveis por barbeiro, serviços com preços (corte 30€,
barba 15€, tratamento completo 50€) e histórico de marcações.
```

```
Cria o armazenamento para as subscrições de utilizadores na minha
app SaaS. Regista o plano atual (Grátis/Pro/Enterprise), o ciclo
de faturação, a data da próxima faturação, os limites de uso
(chamadas à API, armazenamento, membros da equipa) e o uso atual.
Mostra aos utilizadores um painel de uso com barras de progresso.
```

```
Configura uma base de dados de anúncios imobiliários. Os imóveis
precisam de morada, preço, quartos, casas de banho, área, fotos
(até 20), descrição e estado (ativo/pendente/vendido). Cada imóvel
pertence a um agente. Os visitantes podem enviar mensagens de
interesse por imóvel.
```

***

## Início de sessão sem palavra-passe

Os utilizadores introduzem o e-mail, recebem um código de 6 dígitos e entram. Sem palavras-passe. O agente cria o fluxo completo: campo de e-mail, introdução do código, e-mail de verificação e gestão de sessões.

**Como usar**

Pede início de sessão sem palavra-passe ou por código de e-mail. Especifica o que acontece depois do início de sessão e que conteúdo está protegido.

**Exemplos de prompts:**

```
Adiciona início de sessão sem palavra-passe à minha app de
marcações. Depois de iniciar sessão, os clientes veem as marcações
passadas, as próximas marcações e podem voltar a marcar com o
barbeiro preferido. Os visitantes não autenticados podem ver os
serviços mas não podem marcar.
```

```
Configura início de sessão por código de e-mail para a minha
plataforma de partilha de receitas. Sem palavras-passe. Depois de
iniciar sessão, os utilizadores podem guardar receitas nos
favoritos, submeter as suas próprias e deixar comentários. Mantém
o registo simples, já que a maioria dos utilizadores está no
telemóvel.
```

```
Adiciona início de sessão com verificação por e-mail ao meu painel
SaaS. Página de início de sessão centrada e limpa, com o nosso
logótipo e as cores da marca. Redireciona para o painel do projeto
depois da autenticação. As sessões devem durar 30 dias.
```

***

## Início de sessão com e-mail e palavra-passe

Registo, verificação de e-mail, início de sessão, "esqueci-me da palavra-passe" e reposição da palavra-passe. O agente cria todos os ecrãs e trata dos e-mails de verificação, da encriptação das palavras-passe e das sessões.

**Como usar**

Pede autenticação com e-mail e palavra-passe. Especifica que funcionalidades precisas e que páginas estão protegidas.

**Exemplos de prompts:**

```
Adiciona autenticação completa ao meu site de e-commerce. Os
utilizadores registam-se com e-mail e palavra-passe, verificam o
e-mail antes do checkout e podem repor a palavra-passe. Depois de
iniciarem sessão veem o histórico de encomendas, as moradas
guardadas e a lista de desejos. Mantém o checkout como visitante
para compradores pontuais.
```

```
Configura o registo e o início de sessão para a minha plataforma
de cursos online. Os estudantes registam-se, verificam o e-mail e
acedem aos cursos em que estão inscritos. Inclui reposição de
palavra-passe e "lembrar-me". O painel mostra o progresso do
curso, as lições e os certificados obtidos.
```

```
Cria autenticação para o painel de administração do meu
restaurante. Só eu e os meus dois gerentes iniciamos sessão. Sem
registo público. Depois de iniciar sessão vemos as reservas de
hoje, as encomendas pendentes e a receita diária.
```

***

## Início de sessão com Google

Acrescenta à tua app a opção **Iniciar sessão com o Google**. O agente trata da ligação sem te pedir credenciais do Google, porque é o Macaly que gere tudo por ti. O início de sessão funciona na pré-visualização do chat e também no site publicado, por isso podes experimentá-lo antes de publicar.

Podes usar o início de sessão com o Google ao lado do início de sessão sem palavra-passe ou com e-mail e palavra-passe. Quem se registar com o Google fica com o mesmo tipo de conta que toda a gente.

**Como usar**

Pede início de sessão com o Google, sozinho ou juntamente com outro método. Diz o que deve acontecer depois de alguém entrar pela primeira vez.

**Exemplos de prompts:**

```
Adiciona "Iniciar sessão com o Google" à minha app de receitas.
Depois do primeiro acesso, os novos utilizadores veem uma pequena
página de boas-vindas onde escolhem as preferências e seguem para o
feed de receitas.
```

```
Permite entrar com o Google ou com um código por e-mail. Se o e-mail
for o mesmo, ambos devem levar à mesma conta. Depois do acesso,
mostra o painel de membros.
```

```
Adiciona o início de sessão com o Google ao portal de clientes. Só
podem entrar os utilizadores cujo e-mail esteja na lista aprovada da
base de dados. Aos restantes, mostra uma mensagem de "pedir acesso".
```

***

## E-mails automáticos

A tua app envia e-mails reais. Submissões do formulário de contacto, confirmações de encomenda, e-mails de boas-vindas, lembretes. O Macaly tem e-mail integrado, sem necessidade de serviços externos.

<Note>Limite de 10 e-mails por minuto por app.</Note>

**Como usar**

Descreve o evento (o que despoleta o envio do e-mail) e o conteúdo. Inclui quaisquer dados dinâmicos, como nomes ou detalhes de marcações.

**Exemplos de prompts:**

```
Envia um e-mail de confirmação quando um cliente marca um corte de
cabelo. Inclui a data, a hora, o nome do barbeiro, o serviço e o
preço. Acrescenta "Precisas de remarcar? Responde a este e-mail ou
liga para (21) 123 4567" no fundo. Nome do remetente: "The
Gentleman's Cut."
```

```
Envia-me um e-mail todas as manhãs às 8h com um resumo das
encomendas da noite. Inclui o número de encomendas, a receita
total e uma lista com o nome de cada cliente, o que encomendou e o
total da encomenda.
```

```
Configura três e-mails de onboarding para o meu SaaS: boas-vindas
com uma ligação de início rápido no registo, um seguimento ao dia
3 com uma ligação para a documentação, e um contacto ao dia 7 a
destacar as principais funcionalidades. Trata o utilizador pelo
primeiro nome em cada um.
```

***

## Painel de administração

Cria um painel para atualizares conteúdo, gerires encomendas e utilizadores sem passar pelo agente. Início de sessão, funções, permissões e um fluxo completo de criação/edição/publicação. A funcionalidade de blog gera páginas otimizadas para SEO automaticamente.

**Como usar**

Descreve que conteúdo precisas de gerir e quem deve ter acesso. Menciona funções e permissões, se necessário.

**Exemplos de prompts:**

```
Cria-me um painel para gerir as operações diárias do meu salão.
Vista de calendário das marcações de hoje, marcar clientes como
chegaram ou faltaram, adicionar marcações sem hora marcada e
resumo da receita diária. Acesso total para mim, apenas às
marcações de hoje para a minha rececionista.
```

```
Cria uma página de gestão para o menu do meu restaurante.
Acrescenta pratos com foto, descrição, preço e categoria (entradas,
principais, sobremesas, bebidas). Marca itens como esgotados sem
os eliminar, reordena dentro das categorias. O meu chefe só pode
atualizar os pratos do dia.
```

```
Cria um CMS para a minha equipa de marketing. Precisam de editar o
texto e as imagens do hero da página inicial, publicar artigos de
blog com texto formatado, gerir as FAQ e atualizar a página da
equipa. Inclui estados de rascunho/publicado com pré-visualização.
Só eu posso publicar.
```

***

## Funcionalidades de IA

Adiciona IA à tua app. Chatbots, pesquisa inteligente, geração de conteúdo, recomendações. Descreve o que precisas e o agente integra-o.

**Como usar**

Descreve a funcionalidade de IA e como os utilizadores interagem com ela. Especifica que dados deve usar e como deve ser o resultado.

**Exemplos de prompts:**

```
Adiciona um chatbot de IA ao site da minha clínica dentária que
responde a perguntas sobre serviços, preços, seguros e horários.
Mostra-o como um widget no canto inferior direito. Se um visitante
parecer interessado, propõe marcar uma consulta. Dá-lhe a página
de serviços e as FAQ como contexto.
```

```
Cria pesquisa em linguagem natural para o meu site de receitas. Os
utilizadores escrevem algo como "jantar rápido de frango, sem
lacticínios, menos de 30 min" e recebem resultados ordenados como
cartões de receita com fotos, tempo de confeção e uma pontuação de
relevância.
```

```
Cria um gerador de descrições de anúncios para a minha plataforma
imobiliária. Os agentes colam os detalhes do imóvel (quartos, casas
de banho, área, bairro, características) e a IA escreve uma
descrição de 2 a 3 parágrafos pronta para MLS. Acrescenta um
seletor de tom: profissional, caloroso ou de luxo.
```

***

## Classificação com IA

Organiza, pontua e associa textos pelo significado. A tua app pode encaminhar mensagens de suporte para a equipa certa, etiquetar feedback por tema ou ordenar leads consoante a sua adequação.

**Como usar**

Diz ao agente o que a tua app deve classificar ou avaliar, que categorias ou escala usar e o que fazer com o resultado.

**Exemplos de prompts:**

```
Classifica as mensagens de suporte recebidas em Faturação, Técnico
e Conta. Envia as mensagens que não se encaixem claramente em
nenhuma categoria para uma fila "Para rever".
```

```
Dá a cada lead do meu formulário de contacto uma pontuação de 1 a 5
com base no orçamento, tipo de projeto e prazo. Mostra a pontuação
no painel de administração e ordena a lista por ela.
```

```
Etiqueta cada avaliação de cliente no site do meu café por tema:
comida, serviço, preços e ambiente. Uma avaliação pode ter mais do
que uma etiqueta. Mostra no painel de administração quantas
avaliações tem cada etiqueta.
```

***

## Texto para fala

Transforma texto em áudio falado. Usa isto para acrescentar um botão "Ouvir este artigo" ao teu blog, criar cartões de memorização com áudio, criar um fluxo de onboarding guiado por voz, ou criar apps que falam em voz alta, como um gerador de histórias que as lê às crianças. Escolhe entre 30 vozes que falam mais de 130 idiomas e descreve como deve soar a locução, por exemplo calorosa e calma. As apps que já usam texto para fala mantêm as vozes atuais.

**Como usar**

Descreve o que queres narrado e como deve soar. Menciona o estilo de voz, o ritmo ou a emoção, se tiveres preferência. O agente trata da geração e guarda o áudio no teu projeto.

**Exemplos de prompts:**

```
Adiciona um botão "Ouvir artigo" a cada artigo do blog. Usa uma voz
calorosa e calma, algo como um narrador de rádio pública. Deve
aparecer no topo do artigo e reproduzir o texto completo.
```

```
Cria um fluxo de onboarding em áudio para a minha app. Três
mensagens de boas-vindas curtas, cada uma com menos de 20 segundos.
Simpática e encorajadora, como um treinador a receber um novo
membro pela primeira vez.
```

```
Cria botões de pronúncia em áudio para a minha app de aprendizagem
de línguas. Cada cartão mostra uma palavra e um ícone de altifalante.
Ao tocar, ouve-se a palavra a uma velocidade ligeiramente mais
lenta que o normal, com voz clara e neutra.
```

***

## Transcrição

Adiciona voz para texto a qualquer coisa que criares. Carrega um ficheiro áudio ou aponta o agente para uma ligação e recebe texto preciso. Usa isto para criar um assistente de notas de reuniões, um painel de voz para texto, uma página de transcrições de podcast, ou qualquer funcionalidade que transforme palavras faladas em texto escrito.

**Como usar**

Carrega um ficheiro áudio ou partilha uma ligação. Menciona o idioma, se não for português, ou dá contexto ao agente (útil para termos técnicos ou nomes). O texto transcrito fica pronto a usar em qualquer parte do teu projeto.

**Exemplos de prompts:**

```
Cria uma ferramenta de transcrição de reuniões. Os utilizadores
carregam um MP3 e recebem uma transcrição formatada. Guarda cada
uma na base de dados associada à conta do utilizador para que
possam consultar reuniões anteriores.
```

```
Adiciona uma funcionalidade de notas de voz à minha app de notas.
Os utilizadores mantêm um botão premido para gravar e largam para
transcrever. O texto entra diretamente na nota ativa, rápido e
minimalista.
```

```
Cria uma página de transcrição para cada episódio do podcast. Vou
fornecer as ligações do áudio e quero transcrições completas
geradas e guardadas. Mostra-as por baixo do leitor de áudio em
cada página de episódio.
```

***

## SEO

Cada página recebe automaticamente títulos meta, descrições, estrutura de cabeçalhos, etiquetas open graph e dados estruturados adequados. Também podes definir palavras-chave e localizações específicas.

**Como usar**

Diz ao agente para que pesquisas queres posicionar-te. Menciona o tipo de negócio, a localização e o público.

**Exemplos de prompts:**

```
Otimiza o site da minha barbearia para "melhor barbearia perto de
mim" e "corte de cabelo masculino em Lisboa". Atualiza a etiqueta
de título, a meta descrição e os cabeçalhos. Acrescenta dados
estruturados de negócio local com a nossa morada, horário, número
de telefone e um mapa incorporado do Google Maps.
```

```
Percorre todas as páginas do site da minha agência de marketing
digital e acrescenta títulos meta e descrições adequados. Define
palavras-chave diferentes por página. Usa "agência de marketing
digital em Lisboa" para a página inicial, e serviços específicos
como "consultoria de SEO" para as páginas de serviços.
```

```
Otimiza a landing page do meu SaaS para fundadores à procura de
ferramentas de faturação. Usa "software de faturação para
startups" e "ferramenta de faturação simples". Acrescenta uma
estrutura H1/H2 adequada e dados estruturados de FAQ.
```

***

## Pesquisa de domínio

Verifica se um domínio está disponível, mostra o preço e diz-te se o podes registar através do Macaly. Verifica vários nomes e extensões ao mesmo tempo.

**Como usar**

Diz ao agente o domínio que queres verificar, ou descreve o teu negócio e deixa-o sugerir opções.

**Exemplos de prompts:**

```
Verifica se renly.com está disponível. Estou a lançar um SaaS de
gestão de arrendamentos chamado "Renly." Testa também getrenly.com,
renly.io e renly.co. Prefiro .com mas aceito .io. Mostra os preços
dos que estiverem disponíveis.
```

```
Verifica thelisbonloft.com e lisbon-loft.com para o meu hotel
boutique chamado "The Lisbon Loft." Testa também .pt já que estamos
em Portugal. Se todos estiverem ocupados, sugere 3 a 4 alternativas
que captem a marca.
```

```
Verifica a disponibilidade de domínio para o meu negócio de
coaching de liderança. Chamo-me Sarah Chen. Testa sarahchen.com,
sarahchencoaching.com, chenleadership.com e leadwithchen.com.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.