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