O que é
O Typebot é um construtor de chatbots conversacionais: formulários e fluxos de conversa que você embute em sites ou conecta a APIs de WhatsApp como a Evolution API. No GW Server roda em Docker, instalável pelo menu Aplicações, com dois contêineres (builder e viewer) atrás do mesmo domínio.
Requisitos
O Typebot é a aplicação Docker mais pesada do catálogo. O painel não bloqueia a instalação em servidor pequeno (diferente do Chatwoot, que tem mínimo obrigatório de 4 GB/2 núcleos) — mas em 1 núcleo e 2 GB de RAM ele fica travado entre 80% e 100% de uso de CPU e derruba o servidor inteiro. O mínimo real recomendado é 2 núcleos e 2 GB de RAM para instalar, e 4 GB de RAM para rodar sem travar. Ver Pré-requisitos.
Armazenamento externo (S3/Backblaze)
Só é obrigatório se o fluxo enviar mídia (imagem, vídeo) pelo chat ao vivo — sem isso configurado, esses arquivos não têm onde ser hospedados. A recomendação é o Backblaze B2, o mesmo serviço usado nos backups (ver Configurando o destino S3).
- Crie um bucket dedicado (nome sem pontos) marcado como arquivos públicos — o chat ao vivo precisa servir essa mídia.
- Crie uma Application Key nova (não a Master Key), restrita a esse bucket, com permissão de leitura e escrita.
- Na instalação, informe o Access Key, o Secret Key, o Bucket e o Endpoint
completo (
https://s3.<região>...) — região e endpoint aparecem na própria URL do bucket no painel do Backblaze.
Se o S3 não for configurado na instalação, dá para configurar depois — a aba Ambiente tem os
mesmos campos (S3_ACCESS_KEY, S3_SECRET_KEY, S3_BUCKET, S3_ENDPOINT, S3_REGION).
SMTP obrigatório
Diferente de outras aplicações, o Typebot não funciona sem SMTP: é o mecanismo do próprio login, que manda um código de confirmação por e-mail em vez de usar senha (veja a seguir). Use o SMTP global do painel ou informe credenciais próprias — mas deixe algum configurado antes de instalar.
Instalando
Siga o fluxo comum de instalação: domínio (a administração e o chat público usam URLs separadas), e-mail do administrador, SSL e os campos de S3/SMTP acima.
Espaço em disco
Aplicações Docker consomem bastante disco durante a instalação (baixa a imagem, descompacta, só depois limpa as sobras) — um disco de 25 GB pode não bastar, mesmo sobrando RAM e CPU. O log mostra claramente quando a instalação falha por falta de espaço. A solução é redimensionar o disco no provedor; cuidado com a opção “permitir reduzir depois”, que alguns provedores tornam irreversível se desmarcada.
Primeiro acesso e login mágico
O Typebot não tem tela de senha tradicional. No primeiro acesso você se registra com um e-mail; nos acessos seguintes, você informa o e-mail e recebe um código de confirmação por SMTP — é por isso que o SMTP é obrigatório desde a instalação.
Controle de cadastro
Por padrão, qualquer visitante da sua interface pode clicar em “Registre-se gratuitamente” e criar uma conta — o Typebot não tem gestão nativa de usuários, nem no plano gratuito. Feche isso logo depois do seu próprio primeiro acesso.
O painel simplifica com um botão dedicado (typebot_signup), equivalente a alterar a variável de
ambiente DISABLE_SIGNUP para true:
- Instale e crie a sua conta de administrador.
- Na gestão da aplicação, clique em Fechar cadastro.
- O painel aplica a variável e reinicia os contêineres — o deploy leva alguns instantes.
Depois de fechado, uma tentativa de registro de terceiro é recusada pelo próprio Typebot.
Banco de dados
O Typebot usa um único banco PostgreSQL. Ver Gerenciando uma aplicação
para a ressalva do Adminer (troque o driver para PostgreSQL, servidor 127.0.0.1).
A demais gestão (logs, variáveis, atualização, backup, segurança) segue o mesmo padrão comum, ver Gerenciando uma aplicação.
Veja também
Em vídeo: Aula 30 · Instalação do Typebot · Aula 31 · Gestão do Typebot · Aula 32 · Um exemplo real: Typebot, n8n e Evolution GO juntos
