Cron & Health
Cron & Health (System → Cron & Health) tells you whether Threadline's background work is running and whether your server can run the app.
The problem it solves
Sending messages, processing documents, running campaigns, renewing subscriptions and sending reminder emails all happen in the background. They depend on one line in your hosting's cron table that runs every minute. If that line is missing, Threadline looks fine but quietly stops doing its work. This page shows you right away.
The cron line
The page shows the exact cron line for your server, with a Copy the cron line button. It should run every minute. Add it in your hosting control panel (cPanel → Cron Jobs). Step-by-step help is in Cron Setup.
Is it running?
The page shows the last time the scheduler ran, with a status badge:
- Green — it ran in the last few minutes. Cron is set up correctly.
- Amber warning — it has been longer than that, or it has never run. Check that the cron job is exactly as shown.
If it has not run for over 10 minutes, a red banner also appears on every Owner page.
This is what the Troubleshooting page sends you to check when messages arrive but nothing replies, or a document is stuck on "Processing".
Scheduled tasks
A list of the tasks the scheduler runs, how often each runs, and when it is next due. They include renewing subscriptions (hourly), starting scheduled campaigns, publishing scheduled social posts, syncing WhatsApp template status and number health, reading email inboxes for replies, waking snoozed conversations, resuming automations, sending weekly reports and cleaning up old data. If tasks never run, the cron line is the usual cause.
Server requirements
A checklist of what the server needs: PHP 8.3 or newer, the required PHP extensions (pdo, mbstring, openssl, curl, zip, fileinfo, tokenizer, xml, ctype, json and bcmath), the PHP functions the scheduler and the queue worker need (proc_open, and on a VPS pcntl_signal and pcntl_alarm), writable storage and bootstrap/cache folders, and the application key. Anything not OK is marked, so you can ask your host to fix it. See also Requirements.
Common questions
The badge is amber right after I added the cron. Wait two or three minutes and reload.
Messages arrive but nothing replies. Fix the cron first. Then check the Queue Monitor.