Typebot

Typebot is a Fair Source chatbot builder. It allows you to create advanced chatbots visually, embed them anywhere on your web/mobile apps, and collect results in real-time.

Features

• Chat builder with 34+ building blocks: Text, Image, Video, Buttons, Date picker, Payment (Stripe), File upload, and more
• Logic blocks: Conditional branching, URL redirections, JavaScript scripting, A/B testing
• Integrations: Webhook, OpenAI, Google Sheets, Google Analytics, Meta Pixel, Zapier, Make.com, Chatwoot
• Theme customization: Fonts, backgrounds, colors, roundness, shadows, and custom CSS
• Share anywhere: Custom domain, embed as container/popup/chat bubble
• Analytics: Drop-off rates, completion rates, export to CSV

Default Credentials

• Admin Email: The email you set in ADMIN_EMAIL will have unlimited access
• Database: PostgreSQL with auto-generated password

Email Authentication Setup (Required)

You need to configure SMTP for email authentication. Common providers:

Gmail:

• Host: smtp.gmail.com
• Port: 587
• Username: Your Gmail address
• Password: App Password

SendGrid:

• Host: smtp.sendgrid.net
• Port: 587
• Username: apikey
• Password: Your API key

Quick Start

1. After deployment, wait for all services to be ready (especially PostgreSQL)
2. If you see database errors, restart the typebot-builder service to re-run database migrations
3. Visit your Builder Domain to access the Typebot editor
4. Click "Sign up for free" and enter your email
5. Check your email for the magic link to sign in
6. Create your first chatbot using the visual builder
7. Publish and share via your Viewer Domain

Troubleshooting

"The table 'public.User' does not exist" error:

• This means database migrations haven't run yet
• Go to Zeabur Dashboard → typebot-builder service → Click Restart
• The migration will run automatically on restart

Environment Variables

• SMTP_*: SMTP configuration for email authentication (required)
• ADMIN_EMAIL: Set this to your email to get unlimited plan access
• ENCRYPTION_SECRET: Auto-generated 256-bit key for encrypting sensitive data
• NEXTAUTH_URL: Builder URL (auto-configured)
• NEXT_PUBLIC_VIEWER_URL: Viewer URL (auto-configured)

Custom Domain Setup

If you want to use custom domains, update the following environment variables:

Domain Changed	Service	Variable to Update	Example
Builder Domain	typebot-builder	NEXTAUTH_URL	https://builder.yourdomain.com
Viewer Domain	typebot-viewer	NEXT_PUBLIC_VIEWER_URL	https://bot.yourdomain.com

Note: URLs must NOT have a trailing slash. Use https://example.com not https://example.com/

Documentation

• Official Documentation
• Self-hosting Guide
• API Reference