Typebot: Resolva Erros Comuns e Otimize o Deploy

Typebot: Resolva Erros Comuns e Otimize o Deploy

Resposta Rápida / TL;DR

Para resolver erros comuns no Typebot, como 'typebot não publica o fluxo' ou 'erro ao salvar', é crucial verificar os logs da aplicação e do servidor, garantir que os recursos do VPS (RAM, CPU) são suficientes e que a configuração do banco de dados e do proxy reverso está correta. Problemas de 'typebot webhook não dispara' geralmente indicam falhas na configuração da URL do webhook ou restrições de rede. A solução envolve debugging dos logs e testes de conectividade. A implantação do Typebot em um VPS com Docker é a forma recomendada para garantir estabilidade e performance, evitando travamentos na build.

Pontos principais

  • Erros comuns no Typebot (não publica, erro ao salvar, webhook não dispara) são frequentemente causados por recursos insuficientes do VPS ou configurações incorretas.
  • A implantação via Docker Compose em um VPS com Linux/Ubuntu é a abordagem recomendada para estabilidade e facilidade de gerenciamento.
  • Para produção, um VPS com no mínimo 4GB de RAM e 4 vCPUs é essencial para garantir o bom funcionamento do Typebot, banco de dados e proxy reverso.
  • Um proxy reverso (Nginx/Caddy) com HTTPS é fundamental para a segurança e o funcionamento correto dos webhooks.
Índice do artigo

    Se você está encontrando dificuldades com seu Typebot, como typebot não publica o fluxo, erro ao salvar fluxo no typebot, ou typebot webhook não dispara, este guia é para você. Vamos abordar os problemas mais comuns e fornecer um passo a passo prático para implantar o Typebot em um VPS Linux, garantindo que suas automações funcionem sem interrupções. O Typebot é uma ferramenta poderosa para criar chatbots conversacionais, e quando ele não publica ou trava, pode impactar diretamente suas operações. Vamos focar na solução desses impasses e na otimização do seu deploy em um ambiente auto-hospedado.

    O Que Causa Erros Comuns no Typebot?

    Erros no Typebot, como falhas ao publicar ou salvar fluxos, e webhooks que não disparam, geralmente derivam de questões relacionadas à infraestrutura, configuração ou recursos limitados do servidor. Entender a causa raiz é o primeiro passo para uma solução eficaz.

    Recursos Insuficientes do Servidor

    O Typebot, especialmente em produção com um banco de dados e possivelmente um proxy reverso configurado, pode demandar uma quantidade considerável de recursos. Uma build do typebot travando ou lentidão geral pode ser um sintoma direto de falta de RAM ou CPU. Em um ambiente de produção, especialmente se você estiver rodando outros serviços no mesmo VPS, é recomendado um mínimo de 4GB de RAM. A falta de memória pode levar a processos sendo encerrados pelo sistema operacional (OOM Killer) ou a instabilidade geral da aplicação.

    Configurações Incorretas de Banco de Dados e Proxy Reverso

    O Typebot utiliza um banco de dados (geralmente PostgreSQL) para armazenar fluxos e dados. Se a conexão com o banco de dados falhar ou a configuração estiver incorreta, o Typebot não conseguirá salvar ou publicar fluxos. Da mesma forma, se você estiver usando um proxy reverso (como Nginx ou Caddy) para expor o Typebot na internet, configurações erradas de SSL, portas ou reescrita de URL podem impedir que os webhooks sejam disparados corretamente ou que o frontend do Typebot se comunique com o backend.

    Problemas na Configuração de Webhook

    Quando um typebot webhook não dispara, as causas mais comuns são:

    • URL do webhook incorreta ou inacessível pelo Typebot.
    • Restrições de firewall no servidor que impedem a comunicação externa.
    • O próprio serviço de destino do webhook está indisponível ou retornando erros.
    • Configurações de autenticação ou headers incorretos.

    É fundamental verificar os logs do Typebot e do serviço de destino para identificar onde a comunicação falha.

    Passo a Passo: Implantando Typebot em um VPS com Docker

    A maneira mais robusta e recomendada de rodar o Typebot em produção é utilizando Docker. Isso encapsula a aplicação e suas dependências, facilitando o gerenciamento e a resolução de problemas de compatibilidade. Para este tutorial, assumimos que você tem um VPS com Ubuntu 22.04 LTS ou superior e o Docker e Docker Compose já instalados. Se você ainda não tem o Docker configurado, pode consultar um guia sobre Docker no VPS.

    Pré-requisitos de Servidor

    Para uma operação estável do Typebot em produção, recomendamos um VPS com:

    • Mínimo Recomendado para Produção: 4GB de RAM, 4 vCPUs.
    • Armazenamento: 20GB SSD (pode variar dependendo do volume de fluxos e logs).
    • Sistema Operacional: Ubuntu 22.04 LTS ou superior.
    • Software: Docker e Docker Compose (v2).

    Estes requisitos garantem que tanto o Typebot quanto o PostgreSQL e o proxy reverso rodem sem problemas de recursos, evitando travamentos e otimizando a performance geral.

    Configurando o Arquivo docker-compose.yml

    Crie um diretório para o seu projeto Typebot (ex: ~/typebot) e dentro dele, crie um arquivo chamado docker-compose.yml com o seguinte conteúdo. Este arquivo define os serviços do Typebot (backend e frontend) e o banco de dados PostgreSQL.

    
    version: '3.8'
    
    services:
      typebot:
        image: hub.getdrone.io/janpom/typebot:latest
        container_name: typebot_app
        ports:
          - "3000:3000"
        environment:
          DATABASE_URL: postgresql://user:password@db:5432/typebot
          NODE_ENV: production
          PORT: 3000
          NEXTAUTH_SECRET: your_super_secret_nextauth_secret
          NEXTAUTH_URL: http://localhost:3000
          ENABLE_WEBHOOKS: "true"
          PUBLIC_APP_URL: "http://localhost:3000"
        depends_on:
          - db
        networks:
          - typebot-net
        restart: unless-stopped
    
      db:
        image: postgres:15
        container_name: typebot_db
        environment:
          POSTGRES_USER: user
          POSTGRES_PASSWORD: password
          POSTGRES_DB: typebot
        volumes:
          - typebot_db_data:/var/lib/postgresql/data
        networks:
          - typebot-net
        restart: unless-stopped
    
    networks:
      typebot-net:
        driver: bridge
    
    volumes:
      typebot_db_data:
    
    

    Observações Importantes:

    • Substitua user, password e typebot no DATABASE_URL por suas credenciais.
    • É crucial gerar um NEXTAUTH_SECRET forte e único. Você pode gerar um com comandos como openssl rand -base64 32.
    • A NEXTAUTH_URL deve ser o endereço público do seu Typebot quando ele estiver acessível externamente (usaremos um proxy reverso para isso).
    • A porta 3000 é a porta interna do container do Typebot.
    • O volume typebot_db_data garante que seus dados do banco de dados persistam mesmo que o container seja reiniciado.

    Instalando e Executando com Docker Compose

    Navegue até o diretório onde você salvou o docker-compose.yml e execute os seguintes comandos:

    
    # Crie o diretório do projeto (se ainda não fez)
    mkdir ~/typebot
    cd ~/typebot
    
    # Crie o arquivo docker-compose.yml (cole o conteúdo acima)
    # nano docker-compose.yml
    
    # Crie um arquivo .env para segredos (opcional, mas recomendado para NEXTAUTH_SECRET)
    # echo "NEXTAUTH_SECRET=$(openssl rand -base64 32)" > .env
    # echo "NEXTAUTH_URL=http://seu-dominio.com" >> .env # Use seu domínio real
    
    # Inicie os containers em background
    docker compose up -d
    
    # Verifique se os containers estão rodando
    docker compose ps
    
    # Veja os logs (útil para debug)
    docker compose logs -f typebot
    docker compose logs -f db
    

    Após executar docker compose up -d, o Docker fará o download das imagens necessárias e iniciará os containers. O comando docker compose ps deve mostrar os serviços typebot_app e typebot_db rodando. Os logs (docker compose logs -f typebot) serão seus melhores amigos para diagnosticar qualquer problema de inicialização ou de operação. Se a build do typebot travando for um problema, analisar esses logs é o primeiro passo.

    Configurando o Proxy Reverso (Nginx)

    Para acessar seu Typebot de forma segura e configurar corretamente os webhooks, é essencial um proxy reverso. Vamos usar o Nginx como exemplo. Primeiro, instale o Nginx se ainda não o tiver:

    
    sudo apt update
    sudo apt install nginx -y
    

    Agora, crie um arquivo de configuração para o seu Typebot em /etc/nginx/sites-available/typebot:

    
    server {
        listen 80;
        server_name seu-dominio.com;
    
        location / {
            proxy_pass http://localhost:3000;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection 'upgrade';
            proxy_set_header Host $host;
            proxy_cache_bypass $http_upgrade;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    
        # Opcional: Redirecionamento HTTP para HTTPS (se você configurar SSL depois)
        # location / {
        #     return 301 https://$host$request_uri;
        # }
    }
    

    Substitua seu-dominio.com pelo seu domínio real. Em seguida, habilite o site e teste a configuração do Nginx:

    
    sudo ln -s /etc/nginx/sites-available/typebot /etc/nginx/sites-enabled/
    sudo nginx -t
    
    # Se o teste for bem-sucedido, recarregue o Nginx
    sudo systemctl reload nginx
    

    Agora, atualize a variável de ambiente NEXTAUTH_URL e PUBLIC_APP_URL no seu arquivo docker-compose.yml para usar o seu domínio (ex: http://seu-dominio.com) e reinicie os containers do Typebot:

    
    cd ~/typebot
    docker compose down
    docker compose up -d
    

    Com o Nginx configurado, seu Typebot estará acessível pelo seu domínio, e os webhooks deverão ser capazes de enviar requisições corretamente.

    Comparativo: Requisitos de Servidor para Typebot

    Escolher o plano de VPS correto é fundamental para evitar problemas de performance e estabilidade. Abaixo, comparamos os requisitos mínimos e recomendados para diferentes cenários de uso do Typebot.

    Recurso Desenvolvimento/Teste (Não Prod.) Produção Leve/Média Produção Intensa/Muitos Fluxos
    RAM 2GB 4GB - 6GB 8GB+
    vCPUs 2 4 4 - 6+
    Armazenamento (SSD) 10GB 20GB+ 50GB+
    Banco de Dados (PostgreSQL) Compartilhado/Integrado Integrado ou Dedicado Leve Dedicado Otimizado
    Proxy Reverso (Nginx/Caddy) Opcional Recomendado Recomendado
    Exemplo de Plano Host You Secure - VPS Brasil Básico (R$ 99/mês, 4GB RAM, 4 vCPUs) VPS Brasil Intermediário (R$ 149/mês, 8GB RAM, 6 vCPUs)

    Erros Comuns e Soluções Específicas

    Vamos detalhar alguns problemas recorrentes e como resolvê-los com base na experiência real.

    typebot não publica o fluxo ou erro ao salvar fluxo no typebot

    Se você está recebendo essas mensagens, siga estes passos:

    1. Verifique os Logs: Execute docker compose logs typebot e docker compose logs db. Procure por mensagens de erro relacionadas à conexão com o banco de dados, autenticação ou permissões.
    2. Credenciais do Banco de Dados: Confirme se o DATABASE_URL no seu docker-compose.yml (ou arquivo .env se usar) está correto, com usuário, senha e nome do banco de dados batendo com as definições do serviço db.
    3. Recursos do VPS: Monitore o uso de RAM e CPU do seu servidor com htop. Se estiver próximo do limite, pode ser a causa do travamento ou falha ao salvar. Considere um upgrade.
    4. Versionamento do Docker Compose: Certifique-se de estar usando a sintaxe v2 do Docker Compose (docker compose, com espaço) e que as imagens estão atualizadas.

    typebot webhook não dispara

    Para este problema:

    1. URL do Webhook: Confirme se a URL está digitada corretamente no Typebot e se ela é acessível publicamente (sem bloqueios de firewall ou DNS). Se você usa um domínio com HTTPS, certifique-se de que o certificado SSL esteja válido.
    2. Logs do Receptor: Verifique os logs do serviço que deveria receber o webhook. Ele está recebendo a requisição? Está respondendo com um código de sucesso (2xx)?
    3. Logs do Typebot: Os logs do Typebot podem indicar se a tentativa de envio do webhook ocorreu e se houve algum erro na conexão.
    4. Firewall: Verifique se o firewall do seu VPS (ufw, iptables) não está bloqueando as conexões de saída na porta 80 ou 443 para o serviço de destino.

    build do typebot travando

    Se o processo de build (seja ao iniciar o container ou ao tentar atualizar a imagem) está travando:

    1. Recursos: Builds podem ser intensivas em CPU e RAM. Verifique se o seu VPS tem recursos suficientes. Uma máquina com menos de 4GB de RAM pode ter dificuldades.
    2. Espaço em Disco: Certifique-se de que há espaço livre suficiente em disco para downloads de imagens e para o processo de build.
    3. Conexão com a Internet: Uma conexão instável ou lenta pode fazer o download de pacotes demorar ou falhar.
    4. Logs do Docker: Use docker compose logs typebot para ver o progresso e identificar em qual etapa o travamento ocorre. Às vezes, é um problema na própria imagem base ou uma dependência que não está sendo instalada corretamente.

    Perguntas Relacionadas

    O Typebot precisa de um servidor dedicado?

    Não necessariamente um servidor dedicado. Um VPS (Servidor Privado Virtual) com recursos adequados, como os planos da Host You Secure, é mais do que suficiente para rodar o Typebot em produção de forma estável e com bom desempenho. O importante é que o servidor tenha RAM, CPU e armazenamento suficientes para a aplicação e suas dependências.

    Qual o consumo de RAM do Typebot em produção?

    Em um cenário de produção com o PostgreSQL rodando no mesmo VPS, o Typebot (aplicação + banco de dados + proxy reverso) pode consumir entre 2GB a 4GB de RAM em repouso. Sob carga intensa de usuários ou processamento de fluxos complexos, esse consumo pode aumentar significativamente. Por isso, um VPS com 4GB de RAM é o mínimo recomendado para produção, com 6GB ou 8GB sendo ideais para maior folga e performance.

    Posso rodar o Typebot em um plano de hospedagem compartilhada?

    Geralmente, não. A hospedagem compartilhada não oferece o ambiente isolado e os recursos (acesso root, Docker, RAM dedicada) necessários para rodar o Typebot de forma confiável. O Typebot requer instalação via Docker e configuração de banco de dados, o que não é possível em planos compartilhados típicos.

    O que fazer se o Typebot não envia e-mails?

    Se o Typebot não está enviando e-mails, verifique a configuração do seu serviço de envio de e-mails (SMTP) dentro das configurações do Typebot. Certifique-se de que as credenciais (servidor, porta, usuário, senha) estão corretas e que o serviço de e-mail não está bloqueando a conexão. Logs do Typebot e do serviço SMTP podem ajudar a diagnosticar o problema.

    Como faço backup do Typebot?

    O backup do Typebot envolve duas partes principais: os dados do banco de dados PostgreSQL e os arquivos de configuração. Utilize os volumes do Docker para persistir os dados do banco de dados. Você pode fazer backup do volume do PostgreSQL (docker volume inspect typebot_db_data para encontrar o local no host) ou configurar um dump regular do banco de dados. Os arquivos de configuração, como o docker-compose.yml, devem ser versionados em um sistema de controle de código (ex: Git).

    O Typebot é compatível com Node.js v20?

    O Typebot utiliza a imagem oficial do Docker com a versão mais recente disponível em hub.getdrone.io/janpom/typebot:latest. As versões do Node.js dentro dessas imagens são gerenciadas pelo mantenedor do projeto. Geralmente, as imagens oficiais já vêm com versões estáveis e compatíveis do Node.js. Se você tiver um requisito específico de versão, pode ser necessário construir sua própria imagem Docker customizada.

    Como resetar a senha do admin no Typebot?

    Se você esqueceu a senha do admin, a forma mais direta de resetar é remover o container do Typebot e o volume do banco de dados, e então iniciar novamente com o docker-compose.yml. Isso irá redefinir o Typebot para o estado inicial, permitindo que você crie um novo usuário administrador. Atenção: Isso apagará todos os seus fluxos e configurações anteriores. Certifique-se de ter um backup se precisar recuperar dados.

    O que são os logs de 'Rate Limit Exceeded' no Typebot?

    Mensagens de 'Rate Limit Exceeded' nos logs do Typebot geralmente indicam que você está excedendo os limites de requisições impostos por um serviço externo (como um provedor de SMTP, uma API de terceiros que o webhook está chamando, ou até mesmo o próprio Typebot se configurado com limites de uso) ou pelo seu próprio servidor/provedor de hospedagem. Para resolver, você pode precisar ajustar a frequência dos seus webhooks, otimizar o processamento dos fluxos ou aumentar os limites do serviço externo/VPS.

    Conclusão e Próximos Passos

    Resolver problemas como typebot não publica o fluxo ou typebot webhook não dispara é uma parte essencial da gestão de qualquer ferramenta auto-hospedada. Com a implantação correta via Docker e um VPS com recursos adequados, você garante a estabilidade e a performance do seu Typebot. Lembre-se de monitorar os logs e os recursos do seu servidor para identificar e corrigir problemas proativamente.

    Recomendação de VPS para Typebot

    Para rodar o Typebot em produção com confiança, nossa recomendação é o VPS Brasil Básico. Nossos clientes rodam essa mesma stack em uma VPS Brasil Básico, que oferece 4GB de RAM e 4 vCPUs, proporcionando a performance necessária para o Typebot, seu banco de dados PostgreSQL e o proxy reverso funcionarem sem gargalos. Comece hoje mesmo a automatizar seus processos com um Typebot estável e confiável.

    Escolha seu VPS Brasil Básico e implante seu Typebot!

    FAQ: perguntas frequentes

    Como resolver o erro 'typebot não publica o fluxo'?

    Para solucionar o erro 'typebot não publica o fluxo', o primeiro passo é verificar os logs do container do Typebot e do banco de dados PostgreSQL usando `docker compose logs typebot` e `docker compose logs db`. Erros comuns incluem credenciais de banco de dados incorretas, problemas de conexão com o servidor de banco de dados, ou recursos insuficientes no VPS (RAM e CPU). Certifique-se de que o `DATABASE_URL` esteja configurado corretamente e que o servidor tenha pelo menos 4GB de RAM para produção.

    O que causa o erro 'erro ao salvar fluxo no typebot'?

    O 'erro ao salvar fluxo no typebot' geralmente está associado a problemas de comunicação com o banco de dados. Verifique se o serviço do PostgreSQL está rodando corretamente (`docker compose ps`) e se as credenciais de acesso no `DATABASE_URL` estão corretas. Além disso, a falta de espaço em disco ou recursos de RAM/CPU limitados no VPS podem impedir que o Typebot conclua a operação de salvamento. Analise os logs para detalhes específicos.

    Por que meu 'typebot webhook não dispara'?

    Um 'typebot webhook não dispara' pode ocorrer por várias razões: a URL do webhook pode estar incorreta, o servidor de destino pode estar inacessível, ou há restrições de firewall bloqueando a comunicação. Verifique se a URL está correta no Typebot e se o domínio é acessível publicamente. Teste a conectividade do seu VPS para o endpoint do webhook. Verifique também os logs do Typebot e do servidor que deveria receber o webhook para identificar falhas na requisição ou na resposta.

    Como resolver o problema de 'build do typebot travando'?

    Quando a 'build do typebot travando' ocorre, é provável que o VPS não tenha recursos suficientes, como RAM ou CPU, para concluir o processo. Recomendamos um mínimo de 4GB de RAM para ambientes de produção. Verifique também o espaço em disco livre. Conexões de internet instáveis podem causar falhas no download de dependências. Use `docker compose logs typebot` para acompanhar o progresso e identificar onde o processo está parando.

    Quais são os requisitos mínimos de RAM e CPU para rodar Typebot em produção?

    Para rodar o Typebot em produção de forma estável, incluindo o banco de dados PostgreSQL e um proxy reverso, recomendamos um mínimo de 4GB de RAM e 4 vCPUs. Essa configuração oferece uma margem segura para lidar com o tráfego, processamento de fluxos e evitar problemas como travamentos ou reinícios inesperados devido à falta de recursos. Para cenários de alto tráfego, 8GB de RAM e 6 vCPUs são ideais.

    É seguro usar um plano de hospedagem compartilhada para o Typebot?

    Não é recomendado rodar o Typebot em hospedagem compartilhada. O Typebot requer um ambiente isolado com acesso root e a capacidade de executar containers Docker, o que não é oferecido por planos compartilhados. Além disso, a instabilidade e os recursos limitados de um ambiente compartilhado podem levar a problemas constantes de performance e disponibilidade.

    Como configurar o proxy reverso para o Typebot?

    A configuração de um proxy reverso, como Nginx ou Caddy, é crucial para acessar o Typebot via HTTPS e garantir que os webhooks funcionem corretamente. Você precisará configurar o servidor web para encaminhar as requisições para a porta 3000 do container do Typebot e configurar o seu domínio para apontar para o IP do seu VPS. Certifique-se de que as configurações de `proxy_pass` e `upgrade` estejam corretas no arquivo de configuração do Nginx.

    Qual a diferença entre rodar Typebot em desenvolvimento e em produção?

    Em desenvolvimento, você pode rodar o Typebot localmente ou em um VPS com poucos recursos apenas para testar fluxos, pois o consumo é baixo. Em produção, o Typebot precisa ser executado em um ambiente estável e robusto (como um VPS com Docker), com recursos adequados (4GB+ RAM), banco de dados persistente, proxy reverso para segurança e HTTPS, e monitoramento constante para garantir que ele esteja sempre disponível e operando corretamente, suportando múltiplos usuários e fluxos simultâneos.

    ← Voltar para o blog