v4.0.0 : Pre-release

[sojan-official]

We’re thrilled to introduce the first pre-release candidate for Chatwoot v4.0.0, packed with innovative features and enhancements.

ChangeLog

🤖 Introducing Captain: Your AI-Powered Assistant

We’re proud to present Captain, our AI-powered assistant seamlessly integrated into Chatwoot. Captain is designed to enhance customer support efficiency with four key features:

• Captain Assistant: A customer-facing AI that provides real-time, context-aware responses.
• Captain Co-pilot: Helps agents with response preparation, translations, data retrieval, and more.
• Captain FAQs: Detects common unanswered questions to grow your knowledge base.
• Captain Memories: Logs key memories from conversations into the CRM for personalized, proactive support.

A Fresh, Revamped UI

We’ve also made significant updates to the Chatwoot interface, including:

• Inbox View: A whole new way to keep up with notifications and conversations relevant to you in Chatwoot without distractions.
• Better Email Previews: Improved formatting for faster response times.
• Redesigned Contacts Section: Cleaner layout and intuitive filtering for managing customer details.
• Streamlined Conversation Flow: Faster, more intuitive workflows for managing conversations.
• Reimagined Help Center Portal: Modern design and improved admin tools.
• New Sidebar Navigation: Easier access to key sections.
• Numerous other bug fixes and improvements.

⚠️ Important Note for Upgrading:

This release is a pre-release and is not recommended for production use. It is intended for testing and evaluation purposes only. Please wait for the stable releases if you intend to update production.

The v4.0.0 release requires the pgvector extension to be installed in the database. Please refer to the Chatwoot v4 migration guide for more details on how to prepare your database for this release.

🖍 What’s Next?

Stay tuned for updates, patches, and a closer look at what's in store for 4.0 updates. We value your feedback and contributions, so please feel free to engage with our team and community.

Thank you for being an integral part of the Chatwoot journey. Happy coding!

---

Thanks to @danieljimeneznz for the contributions

---

This discussion was created from the release v4.0.0 : Pre-release.

[pedromvf]

It is Amazing!!!!!!!!!!!!!!!!!

[Crease29]

Umm was it intended to push the latest docker tag with this pre-release, if it's not fully released yet? My instance updated to 4.0.0 and Chatwoot doesn't fetch emails via IMAP anymore.

[sojan-official]

We have added a new tag 4.0.1 ,which should fix this issue.

[Crease29]

We have added a new tag 4.0.1 ,which should fix this issue.

How can I downgrade?

[deivisonrpg]

Great job, but make the layout more responsive, use on mobile is very important and your mobile app still lacks a lot to be usable. A PWA would already help a lot.

[sojan-official]

• The desktop version is designed with just larger screens in mind.
• We are working on the v4 mobile app to be in parity with the desktop app at the moment.

[muhsin-k]

@deivisonrpg We welcome your feedback on how to make the mobile app more usable. Are there any additional features you'd like to see supported?

[deivisonrpg]

@muhsin-k You guys are doing a great job with v4, now what we are missing is the ability to start a conversation.

[casualmatt]

I was testing the new v4 on Kube, but I couldn't find where to add the OpenAI API key and the model to use; it would be nice if we could also use a custom model that we had fine-tuned.

[sojan-official]

• We will be adding support for custom models in upcoming releases.
• If you are in the ee edition of Chatwoot and under a paid plan, you will be able to configure captain from the super admin.

[davbrau]

It's awesome to see such cool updates in this new release. A few questions: As @casualmatt mentioned, it would be great to be able to plug in our own models (e.g., via OpenRouter), as our use case handles sensitive medical data, and we would need to use an on-prem open-source model.
Also, is the sidebar now collapsible? this made it impossible to use on mobile, as the sidebar took up almost all the screen space and made the chat section inaccessible.

[casualmatt]

@davbrau I think that the API key can be set using the envar: CAPTAIN_OPEN_AI_API_KEY, but even if I have set it up is not working.

chatwoot/enterprise/app/services/captain/copilot/chat_service.rb

Line 28 in 5046dc5

OPENAI_API_KEY: InstallationConfig.find_by!(name: 'CAPTAIN_OPEN_AI_API_KEY').value

[sojan-official]

• We will be adding support for choosing your own models in the upcoming releases.
• The redesigned sidebar is not collapsible. We direct users to use the mobile apps as the desktop app is not developed for smaller screens.

[edumaciel10]

Hey @sojan-official the captain features won't be free for self hosted?

[sojan-official]

The captain features will be under enterprise license. We are still working out the pricing. Currently its only accessible under a paid plan.

[iammattmartin]

Pretty poor choice given it's hard to justify enterprise when you're just ignoring community requests and promises for things that are now at least 4 years oustanding!

[mv-developer]

Hi @sojan-official ,

After updating to v4.0.1, I’ve encountered an issue where I’m unable to send videos to WhatsApp or receive them.

[sojan-official]

could you share the error log ?

[mv-developer]

"errors"=>[{"code"=>131053, "title"=>"Media upload error", "message"=>"Media upload error", "error_data"=>{"details"=>"Video file uploaded with mimetype as video/mp4, however on processing it is of type application/octet-stream, videoCodec=h264, audioCodec=NONE. Please choose a different file."}}]}]}

[ossplus]

Fail to migrate the DB(docker latest3.16 to latest4.0.1)
#10721

[jochenstu]

Can cwctl currently be used to upgrade from 3.x to 4.x? The migration guide is not touching on this

[sojan-official]

The linux section , should cover this.

[hexclann]

The commands mentioned in that section does not work for postgresql-14:
apt install postgresql-14-pgvector
E: Unable to locate package postgresql-14-pgvector

[ahmedsasker]

The commands mentioned in that section does not work for postgresql-14:
apt install postgresql-14-pgvector
E: Unable to locate package postgresql-14-pgvector

Add the PostgreSQL repository, search on google how to add it on linux and you'll be able to apt install it.

[mv-developer]

WhatsApp audio messages in OGG format are not playing in the iOS app.

[muhsin-k]

@mv-developer We are working on this issue and will add audio recorder support in the next update.

[henriquelemos0]

Failed to install a new one, version 4.0.1, ubuntu 24.04, using install.sh

> husky install

husky - Git hooks installed
Done in 1.7s
Building with Vite ⚡️
vite v5.4.8 building for production...
transforming...
✓ 4365 modules transformed.
rendering chunks...
undefined
 ERR_PNPM_RECURSIVE_EXEC_FIRST_FAIL  Command was killed with SIGKILL (Forced termination): vite build --mode production
 
 .... many DEPRECATION WARNINGS ...
 
 pid 31597 exit 1
Build with Vite failed! ❌

In the tutorial, says **Ubuntu 24.04: https://www.chatwoot.com/docs/self-hosted/deployment/linux-vm/
Most part of the docs says Ubuntu 20.04.

Could the ubuntu version cause it ? Are you guys using the Ubuntu 20 version ?

[iammattmartin]

Works 24 LTS here.

[henriquelemos0]

Thanks, good to know.
Using the migration, or fresh installation ?

[ariel-lambrecht]

Small bug report: Those options (Channels, Folders, Teams etc) on the sidebar are visible even when disabling the feature in superAdmin.

[sanjayws]

Hi, do you plan to maintain 3x branch? I tried v4 and my users insisted to keep the old design. Or is there a way to switch on v4? Thanks for all you do.

PS> A little sad captain is only for enterprise, maybe you can add a one time purchase for open source jockeys like me :-)