Estes guias descrevem o Toimii depois que ele estiver no ar. O painel e a cobrança ainda não estão disponíveis — o Toimii será lançado em 2026.

A forma mais simples de adicionar um formulário de contato a uma página HTML simples

Duas linhas em qualquer lugar dentro de <body>. Sem compilação, sem dependências. Se consegues guardar e fazer upload, consegues fazer isto.

<script src="https://cdn.toimii.io/components/your-code.js" async></script>
<toimii-contact></toimii-contact>

Isto funciona mesmo?

Sim — e este é o caso mais simples. O HTML simples não tem sandbox de plugins, sem editores que removem scripts, sem plano necessário. As duas linhas funcionam em qualquer lugar onde possas guardar e fazer upload de um ficheiro .html.

Passo a passo

Abre o teu ficheiro .html

Abre o ficheiro .html que queres editar, em qualquer editor de texto — VS Code, Sublime, Notepad++, até o TextEdit (em modo de texto simples).

Cola o código de incorporação

Cola as duas linhas do teu painel Toimii dentro de <body>, exatamente onde queres que o formulário apareça.

Guarda e faz upload

Guarda o ficheiro e faz upload para o teu alojamento — FTP, S3, Netlify drop, ou o que usares. Abre a página num browser para confirmar.

Problemas comuns

Não coles o código dentro de <head>. O elemento personalizado é uma tag de nível body — tem de estar dentro de <body>.
Não retires o atributo async da tag script. Sem ele, o script bloqueia o carregamento do resto da página.
Se copiares de um editor de texto formatado, podes obter aspas tipográficas (" ") em vez de aspas simples ("). Usa um editor de texto simples — VS Code, Sublime, Notepad, TextEdit em modo de texto simples.
Se a tua página já tiver meta tags Content-Security-Policy, permite cdn.toimii.io em script-src e connect-src. A maioria das páginas HTML simples não tem CSP nenhum.

Perguntas frequentes

Preciso de backend ou PHP?

Não precisas de backend. Os envios vão diretamente do formulário para a API do Toimii — a tua página HTML pode estar alojada em qualquer lado, mesmo num host estático gratuito.

Posso abrir o ficheiro .html diretamente com file://?

Depende do browser. O Chrome e o Safari abrem ficheiros .html via file:// sem problemas; o Firefox bloqueia scripts cross-origin em URLs file://. Para testes fiáveis, corre um servidor local (npx serve, python -m http.server) e abre http://localhost.

Funciona no CodePen, JSFiddle ou numa sandbox?

Sim — cola as duas linhas no painel HTML. O script carrega e o componente aparece no iframe de pré-visualização.

Funciona offline?

A página carrega, mas o formulário precisa de ligação à internet para enviar. Se o visitante estiver offline, a página aparece normalmente — mas não consegue enviar a mensagem até voltar a estar online.

A incorporar noutra plataforma?

As mesmas duas linhas de código, explicadas para cada plataforma.

WordPress

Bloco HTML Personalizado, Block Editor ou Clássico. Sem instalar plugin. Um detalhe — o teu perfil de utilizador precisa da permissão unfiltered_html.

Ler o guia completo

Squarespace

Coloca um Bloco de Código em qualquer página. Requer o plano Core (renomeado Business em 2025) ou superior.

Ler o guia completo

Webflow

O elemento Code Embed suporta até 50 000 caracteres. O código personalizado requer o plano Basic ou superior. Publica para pré-visualizar.

Ler o guia completo

Wix

O Wix coloca o widget Embed numa sandbox, por isso usamos um método dividido — script em Definições → Código Personalizado, tag via Embed a Widget. Guia honesto.

Ler o guia completo

Shopify

Adiciona uma secção Custom Liquid a qualquer tema — sem instalar app. Salta as páginas de checkout a menos que estejas no Shopify Plus.

Ler o guia completo

Sites Estáticos

Astro, Hugo, 11ty, Jekyll — as mesmas duas linhas no teu template de layout. As builds ficam rápidas.

Ler o guia completo

React / Vue / Angular

Usa o elemento personalizado diretamente em JSX, templates Vue ou componentes Angular. Sem componente wrapper, sem pacote extra.

Ler o guia completo

Pronto para experimentar?

30 dias de teste gratuito. Sem cartão de crédito. Pronto em minutos.

Sem cartão de crédito. Pronto em 2 minutos.