What you can do:
Before you start
- A Vercel account (sign up for free)
- An existing Vercel project, or use our template
How to install the integration
Install Chatbase from the Vercel Marketplace
- Log into your Vercel Dashboard.
- Click the Marketplace tab in the top navigation.
- Search for Chatbase and click the integration in the results.
- Click Install.
Choose an AI agent preset and model
- AI Agent: a general-purpose intelligent assistant
- Customer Support Agent: optimized for answering customer questions and providing support
- Sales Agent: guides customers through product selection and purchase decisions
Choose your subscription plan
- An invoice is sent to your registered email address.
- Follow the payment link in the invoice to complete your subscription.
- Your plan becomes active once the invoice is paid.
Name your AI agent
Customize in the Chatbase dashboard (optional)
- Customize the appearance
- Add training data sources. The more relevant data you provide, the better your AI agent responds
- Configure Actions such as lead collection, calendar booking, Stripe payments, Custom Actions, and web search
- Set up integrations with Slack, Zapier, webhooks, and CRM systems
Connect the integration to your Vercel project
- Go back to your Vercel dashboard.
- In the Chatbase integration settings, click Connect Project.
- Select the project or projects where you want the AI agent.
- Click Connect to finalize. Vercel automatically injects the environment variables into the selected projects.
Add the Chat Bubble script to your app
- In your Chatbase dashboard, open the AI agent and click Channels, then Manage on the Chat Bubble card.
- Click Deploy, select Website widget, and copy the script.
- Add it to a layout or template shared by every page of your app, such as the root layout, so it loads before the closing
</body>tag.
Redeploy your project
- Go to your project in the Vercel dashboard.
- Click the Deployments tab.
- Click the three-dot menu (⋯) on your latest deployment.
- Select Redeploy.
Managing your integration
Updating your AI agent
Changes made in your Chatbase dashboard apply instantly without a redeployment, including appearance customization, training data updates, response behavior, and Actions.Multiple projects
To connect the same Chatbase AI agent to more Vercel projects:- Go to your Vercel dashboard.
- Navigate to Integrations → Chatbase.
- Click Manage on your Chatbase integration.
- Click Add Project.
Different AI agents per environment
To use different AI agents for production, preview, and development:- Create separate AI agents in Chatbase for each environment.
- In Vercel, go to Settings → Environment Variables and set different
NEXT_PUBLIC_CHATBOT_IDvalues for Production, Preview, and Development.
Managing your subscription plan
Go to Integrations → Chatbase → Settings in your Vercel dashboard and click Change Plan. Through Vercel you can choose Free, Basic, or Business, billed monthly or yearly, at the same prices as on chatbase.co. Enterprise can’t be bought through Vercel. Add-ons aren’t available for workspaces billed through Vercel: the Chatbase billing page shows “Addons currently unavailable for vercel managed workspaces”.Uninstalling the integration
- Go to your Vercel dashboard.
- Navigate to Integrations → Chatbase.
- Click Manage → Remove Integration.
- Confirm removal.
Troubleshooting
Chat Bubble not appearing after installation
Chat Bubble not appearing after installation
- The Chat Bubble embed script was never added to your app. The integration doesn’t add it for you
- The project hasn’t been redeployed since you added the script
- A JavaScript error is preventing the embed script from loading
- A cached version of the page is being served
- Add the Website widget script to your root layout (see Add the Chat Bubble script to your app)
- Redeploy: go to Deployments, select the latest, and click Redeploy
- Open DevTools (F12) and look for Chatbase-related errors, confirming the embed script loads
- Hard refresh (Ctrl+Shift+R / Cmd+Shift+R) or try an incognito window
Integration installation failed
Integration installation failed
- A partial or corrupted install
- Insufficient permissions on the Vercel team or project
- Remove and reinstall: Integrations → Chatbase → Manage → Remove Integration, then reinstall from the Marketplace
- Ensure you have admin access to the Vercel team or project, and that your Vercel account is properly authenticated
- If issues persist, contact Chatbase Support with your Vercel project ID and integration details
Environment variables not taking effect
Environment variables not taking effect
- Make your environment variable changes
- Trigger a new deployment, either by pushing a commit or redeploying manually from the Vercel dashboard
- Clear your browser cache and test again
Plan or billing issues
Plan or billing issues
- The invoice never arrived, or went to spam
- Payment is still processing
- The change was a downgrade or cancellation, which doesn’t apply immediately
- Check your email spam folder and verify the email address in your Vercel account settings; contact Vercel support for a resend
- Check payment status in the Vercel billing dashboard. Vercel shows “Your billing plan will be updated once the invoice is paid”, and the plan changes when Vercel reports the invoice as paid
- Remember that upgrades activate immediately after payment, while downgrades and cancellations take effect at the end of the current billing period
Frequently asked questions
Does the Vercel integration add the chat widget to my site automatically?
Does the Vercel integration add the chat widget to my site automatically?
Do paid Chatbase plans cost the same on Vercel as on chatbase.co?
Do paid Chatbase plans cost the same on Vercel as on chatbase.co?
Can I buy add-ons like removing "Powered by Chatbase" through Vercel?
Can I buy add-ons like removing "Powered by Chatbase" through Vercel?
Can I move my billing from Vercel to Chatbase, or the other way?
Can I move my billing from Vercel to Chatbase, or the other way?
When does a downgrade or cancellation on Vercel take effect?
When does a downgrade or cancellation on Vercel take effect?