How do I deploy Unthread WhatsApp Bot on Railway?

You can deploy Unthread WhatsApp Bot on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: unthread-whats-app-bot-b508b447, or click "Get template help" for this template for more assistance.

Deploy and Host Unthread WhatsApp Bot on Railway

The Unthread WhatsApp Bot is an official Unthread extension that connects a Twilio WhatsApp number to Unthread's support ticketing system. Incoming customer messages automatically become support tickets in Unthread, while agent replies and ticket status updates are delivered back to customers on WhatsApp.

About Hosting Unthread WhatsApp Bot

Hosting the Unthread WhatsApp Bot on Railway involves deploying the bot service alongside PostgreSQL and two Redis instances. The bot receives inbound WhatsApp messages via Twilio webhooks, creates or updates customer records and conversations in Unthread, and sends outbound replies through Twilio. One Redis instance handles platform caching and storage, while the second serves as a webhook queue consumed from the companion unthread-webhook-server. PostgreSQL provides durable persistence for customer and conversation data. Railway manages service networking and environment variable injection, making the full-stack deployment easy to configure and scale.

Common Use Cases

Run customer support over a WhatsApp Business number while managing all tickets in Unthread
Automatically notify customers on WhatsApp when their ticket is created, closed, placed on hold, or resumed
Give support teams a bidirectional workflow where agents reply in Unthread and messages are instantly delivered to customers on WhatsApp

Dependencies for Unthread WhatsApp Bot Hosting

Twilio account with a WhatsApp-enabled number and an Unthread workspace with an API key
PostgreSQL database and two Redis instances for platform storage and webhook queue processing

Deployment Dependencies

Railway: https://railway.com/
Twilio WhatsApp: https://www.twilio.com/whatsapp
Unthread: https://unthread.com/
Unthread WhatsApp Bot repository: https://github.com/wgtechlabs/unthread-whatsapp-bot
Companion webhook service: https://github.com/wgtechlabs/unthread-webhook-server

Implementation Details

The deployed bot exposes two core endpoints:

POST /webhooks/twilio
GET /health

Why Deploy Unthread WhatsApp Bot on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Unthread WhatsApp Bot on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.