1. Primeiros passos
O Fittle tem dois lados: o configurador, que os seus clientes usam no seu site (ou na página alojada app.getfittle.com/s/o-seu-nome), e a conta do carpinteiro em app.getfittle.com/carpenter/, onde vê os pedidos e as pré-visualizações 3D, configura a integração e escreve ao suporte.
- A conta é criada ao escolher um plano na tabela de preços (Pro até 1 000 pedidos por mês, Business até 10 000) – após o registo, a verificação do e-mail e o pagamento com cartão, o configurador fica ativo.
- Inicie sessão em
app.getfittle.com/login/– por e-mail (ligação), código SMS ou palavra-passe, se a tiver definido. - Na conta encontra a sua chave de incorporação (
FITT-XXXX-XXXX-XXXX) e um excerto de código pronto. A integração no site (WordPress, Wix, Shopify, HTML próprio) está descrita no guia de instalação. - Não tem site? Envie aos clientes a ligação da página alojada – funciona da mesma forma.
2. Utilização do configurador
Cena e botões
Rato: arrastar roda, a roda aproxima, o botão direito desloca. Toque: um dedo roda, dois dedos aproximam. Ao clicar num móvel ou módulo seleciona-o – no painel abrem-se as suas definições e na cena recebe uma moldura azul. O clique não abre as portas, para isso existem botões.
A linha superior de botões controla a vista:
- Abrir portas abre as portas e gavetas do móvel selecionado, Abrir tudo as de todo o conjunto.
- Transparente – as frentes ficam transparentes, veem-se as prateleiras e gavetas no interior.
- Rotação automática, Centrar (retorno da câmara), Dimensões (cotas na cena).
- Passear – percurso na primeira pessoa (capítulo 8); no telemóvel também Ver na minha divisão (AR).
A coluna esquerda são as ações: Cozinha / parede / tudo aleatório, Esvaziar, Exportar 3D, Plano de corte, Descrição de imagem IA, Guardar projeto, Carregar projeto. No telemóvel os botões estão em duas linhas deslizáveis por cima da cena.
Painel esquerdo
O painel é retrátil – cada secção abre ao clicar no seu nome. No início está o bloco de ferramentas, depois a forma do conjunto, a divisão, as dimensões, o conteúdo do módulo selecionado, portas e puxadores, decores. No telemóvel o painel desliza de baixo: arraste a pega «Definições» para cima.
Por baixo dos deslizadores das dimensões há um resumo laranja das dimensões totais (na cozinha também a altura da bancada e a aresta inferior dos armários superiores) – são os números que o cliente deve medir em casa.
Divisão
Ative Colocar na divisão e indique a largura, profundidade e altura; a forma em L tem um recorte no canto. Nas paredes podem adicionar-se janelas e portas (parede, posição, largura, altura, peitoril) – os móveis evitam-nas e avisam em caso de colisão. O pavimento escolhe-se do catálogo, as luzes de teto têm número, cor e intensidade. Com um conjunto reto na divisão pode definir-se a distância à parede esquerda; em L e U o conjunto vai de parede a parede e a largura é determinada pela divisão.
Decores e materiais
O seletor por cima dos decores determina o que colore: portas, gavetas, corpo, interior, bancada, painel de parede ou prateleiras. Mais decores abre o catálogo com pesquisa, categorias e escolha do fornecedor; uma cor própria introduz-se por código. A espessura da placa (0,8–4 cm) recalcula todas as medidas interiores, o fundo pode ter 3 / 5 / 8 mm ou ser placa maciça – influencia o plano de corte.
Objetos 3D
A secção Objetos 3D coloca na divisão um móvel ou eletrodoméstico pronto – um ficheiro próprio .glb / .kmz / .dae / .obj até 8 MB (do SketchUp: Ficheiro → Exportar → Modelo 3D). O objeto tem afastamento da parede, rotação, escala e tamanho; não entra no plano de corte. Os fornecedores podem oferecer os seus próprios modelos, que são ativados ao carpinteiro no catálogo.
3. Cozinha
Forma reta / L / U; em L escolhe para que lado vai o braço lateral. No canto há sempre um verdadeiro armário de canto (inferior e superior 95 × 95 cm) com duas portas retas – os braços começam só depois dele, pelo que as portas nunca se sobrepõem.
A cozinha é uma fila de colunas. Cada uma tem um armário inferior (portas, gavetas, lava-loiça, placa, forno, fogão, máquina de lavar loiça), um superior (portas, vitrine, prateleira, micro-ondas, exaustor, nenhum) ou é um armário alto (frigorífico, forno + micro-ondas, despensa, configurável). As larguras vêm das séries de fabrico; os eletrodomésticos têm larguras fixas. Na secção Armário define prateleiras e gavetas (número e alturas), lado de abertura, vidro com moldura, altura do forno, largura do lava-loiça.
A ilha ativa-se na forma da cozinha e arrasta-se na cena com o rato; tem módulos próprios, lava-loiça, tampo, máquina de lavar loiça e balcão saliente. Alturas e profundidades: inferiores 72 cm, superiores 72, painel 60, profundidade 60/35, rodapé 10, tampo 4 – tudo com deslizadores.
A fita LED por baixo dos armários superiores ativa-se marcando a opção na secção da cozinha e escolhendo o tom da luz (quente / neutra / fria). Ilumina a bancada por baixo de cada armário superior, está na exportação 3D e não aparece no plano de corte.
4. Roupeiro embutido
O roupeiro é uma fila de módulos (50–90 cm); cada um tem secções de cima para baixo: varão, prateleiras, gavetas – com alturas ajustáveis. As portas são de todo o roupeiro: de correr, de abrir ou nenhumas; o número de portas e o lado de abertura estão na secção Portas. Um módulo pode ser aberto (sapateira com cabides à entrada) ou módulo de cama.
Cama embutida: marque no módulo, defina a largura (90–160), o comprimento e o espaço acima da cabeça; a arrumação por cima da cama é aberta ou com portas. A cama sobressai para a divisão, por isso não pode ficar mesmo no canto em L/U.
A forma L / U funciona como na cozinha – no canto há uma peça de canto com decor e puxador próprios, os braços laterais têm módulos próprios.
Sótão – teto inclinado: na secção Divisão ative o sótão, escolha a parede inclinada (traseira ou lateral), a altura da parede vertical (joelho) e a inclinação do telhado. O roupeiro adapta-se sozinho à inclinação: laterais, tampo, portas e prateleiras são cortados segundo a inclinação; as portas de correr com aresta superior inclinada passam a portas de abrir. As placas cortadas encontram-se no plano de corte como contorno com medidas. As peças de canto L/U não são cortadas sob a inclinação.
5. Móvel de sala
Os módulos compõem-se em altura a partir de armários: portas, gavetas, vitrine, prateleira aberta, televisor (nicho com TV, exatamente um por parede) e espaço livre – ar sem corpo. É precisamente com o espaço livre que surgem os móveis baixos com armários suspensos ou os móveis de TV flutuantes. Cada armário tem altura e prateleiras próprias.
O botão Parede aleatória escolhe entre 30 modelos para cada forma (clássica com vitrines, flutuante, até ao teto, loft, biblioteca…). A parede predefinida é «Clássica com vitrines».
6. Armário e móvel de lavatório
Armário: largura, altura, profundidade, rodapé ou pés, secções (portas, gavetas, aberto, vitrine) com compartimentos ajustáveis. Móvel de lavatório: montagem na parede ou sobre pés, frente (gavetas, portas), lavatório de pousar / de encastrar / integrado, forma e tamanho do lavatório, torneira, espelho, lavatório duplo a partir de 110 cm.
7. Casa de banho, azulejos e ladrilhos
A casa de banho não tem forma linear – cada módulo (móvel de lavatório, armário alto, espelho, armário com espelho, máquina de lavar roupa em armário, máquina de secar sobre a de lavar) e cada equipamento (banheira reta / de canto / assimétrica, cabina de duche quadrada / de quarto de círculo / walk-in, sanita suspensa ou de chão, máquina de lavar roupa) fica na parede que escolher, na posição a partir da margem esquerda da parede indicada (vista de dentro); as peças de canto mantêm-se no canto. Os módulos têm profundidade própria (lavatório 40–50 cm, altos 30–35, armários com espelho 12–16), frentes com portas ou gavetas e portas que abrem. Casa de banho aleatória escolhe entre 50 disposições prontas para casa de banho reta, de canto e em U.
Azulejos e ladrilhos (secção Azulejos, disponível em todos os produtos): ladrilhos no chão e azulejos nas paredes até à altura escolhida; padrão em grelha / desencontrado / diagonal / espinha de peixe, tamanho da peça, junta e a sua cor, peças do catálogo dos fornecedores. As peças assentam-se a partir do canto esquerdo, portas e janelas são descontadas. Resultado separado para chão e paredes: m², número de peças a comprar, peças cortadas e desperdício em percentagem – segundo a regra do ladrilhador: as paredes assentam-se com peças inteiras a partir de cima (a fiada cortada no chão), uma peça cortada só vai com o lado cortado contra parede, chão ou vão e uma sobra reutiliza-se onde couber ou recorta-se com um corte direito.
8. Passeio, VR e AR
Passear coloca a câmara à altura dos olhos. No computador WASD ou setas, o rato roda (um clique na cena bloqueia o cursor, Esc liberta-o). No telemóvel há um joystick e o botão Giroscópio – roda o telefone. Deslizador Altura dos olhos 100–200 cm. Paredes e móveis são obstáculos.
Ver na minha divisão (AR) no iPhone/iPad abre o modelo na divisão real através da câmara (Safari), no Android através do Chrome. Com óculos VR (p. ex. Meta Quest) aparece no passeio o botão VR.
9. Guardar, carregar, aleatório
- Guardar projeto transfere um ficheiro JSON com todo o estado (também divisão, decores, espessuras). Carregar projeto devolve-o ao 3D – mesmo noutro navegador ou daqui a um mês.
- Cozinha / parede / tudo aleatório constrói um novo projeto a partir de modelos de conjuntos reais; na secção do módulo há também um único módulo aleatório ou o esvaziamento.
- O seletor de idioma no cabeçalho muda todos os textos (24 idiomas), o tema claro/escuro muda-se com um botão.
10. Envio do pedido
O botão Enviar para orçamento abre um formulário: nome, e-mail, telefone, requisitos especiais (até 4 000 caracteres) e fotos do espaço (até 5, do telemóvel mesmo com 8 MB – são reduzidas no navegador). O cliente também pode transferir o projeto como JSON. Após o envio, o carpinteiro recebe um e-mail com o resumo e o pedido fica na conta com pré-visualização 3D e fotos.
11. Plano de corte e exportação PRO
Plano de corte abre a lista de todas as placas do projeto: medidas de corte (comprimento × largura × espessura, medidas líquidas sem acréscimo para orla), número de peças, onde estão no projeto, desenho no decor escolhido. As placas iguais são agrupadas (30 × 60 = 60 × 30). No resumo está o número de placas, a área por espessura, o material a comprar por decor (m²) e o vidro à parte. Transferir CSV dá uma tabela para a serra.
Marcar placas no modelo 3D mostra a letra de cada grupo diretamente nas placas na cena – um plano de montagem. Exportar 3D transfere o modelo como .dae (SketchUp, Blender, ArchiCAD) ou .kmz com as texturas dos decores; as medidas no CAD coincidem com o plano de corte.
12. Conta do carpinteiro
Em app.getfittle.com/carpenter/:
- Perfil e dados de faturação – nome, região, e-mail para pedidos, idioma, produtos no seletor, dados de faturação (edita-os você mesmo); chave, página alojada e excerto para incorporar.
- Subscrição – plano, período e número de pedidos deste mês face ao limite do plano (Pro 1 000 / Business 10 000). Esgotado o limite, os pedidos seguintes não são aceites até ao fim do mês e o cliente vê a indicação para o contactar diretamente – aos 90 % avisamos por e-mail.
- Pedidos – lista com contacto, nota e miniaturas das fotos; Abrir 3D carrega o projeto no configurador em modo de visualização; Ligação para a oficina copia uma ligação que funciona sem conta durante 30 dias; estado do pedido (novo → visto → contactado → orçamentado → ganho / perdido).
- Integração – webhook e chave API (capítulo 13).
- Suporte – chat ao vivo connosco; a resposta chega também por e-mail.
- Palavra-passe – opcional, além da ligação por e-mail e do código SMS.
13. Portais: webhook e API
Para portais e empresas com sistema próprio: na conta defina o URL do webhook e uma chave secreta – em cada pedido enviamos um POST assinado com o JSON do projeto (assinatura HMAC-SHA256, repetição 10 s / 1 min / 5 min). Gere uma chave API e transfira pedidos e fotos, altere o estado ou gere ligações para a pré-visualização 3D. No seu próprio site também estão disponíveis HNL.prefill(...) (pré-preenchimento do contacto) e o evento HNL.on('quote', ...). Detalhes: PORTAL.md.
<script src="https://app.getfittle.com/embed.js" data-key="FITT-…"></script>
<script>
HNL.mount('#konfigurator', { product:'kitchen', prefill:{ name:'João Silva', email:'joao@…' } });
HNL.on('quote', e => console.log('pedido', e.id));
</script>
14. Fornecedores de decores
Os fabricantes e revendedores de decores têm conta própria em app.getfittle.com/supplier/: carregam decores e pavimentos (imagem, código, categoria, acabamento), enviam para aprovação e, depois de aprovados, ficam no catálogo que todos os clientes de todos os carpinteiros veem – com o nome do fornecedor na lista pendente.
15. Perguntas frequentes
O configurador não aparece no meu site.
Verifique se a chave está correta e se o domínio do site está adicionado na conta. Em «Versão de teste» o envio está bloqueado – a chave expirou ou não está ativa.
O cliente enviou um pedido, mas o e-mail não chegou.
O pedido está sempre também na conta, na secção Pedidos. Verifique o e-mail para pedidos no perfil e a pasta de spam.
As medidas no plano de corte são sem acréscimo para orla?
Sim – são as medidas líquidas das peças tal como o 3D as constrói. O acréscimo para a orla ABS é adicionado pela oficina segundo a sua tecnologia.
É possível carregar um pedido antigo em 3D?
Os pedidos enviados desde setembro de 2026 sim (têm o estado guardado). Os mais antigos aparecem apenas como texto.
Funciona em tablet e telemóvel?
Sim, no Safari e no Chrome. A AR requer iOS (Safari) ou Android (Chrome); o passeio com giroscópio pede permissão para os sensores de movimento.