TrochaiDocs

Scheduled Follow-ups

Schedule template messages to be automatically sent to your contacts at a future date and time.

Scheduled Follow-ups

Scheduled follow-ups allow you to schedule WhatsApp template messages to be automatically sent to your contacts at a future date and time. This is useful for reminders, visit follow-ups, appointment confirmations, or any planned communication.

Scheduling a follow-up

You can schedule a follow-up directly from a conversation in the inbox:

Open the conversation of the contact you want to send the follow-up to.

In the toolbar, click the More actions button (three horizontal dots icon).

Select Follow-up from the dropdown menu.

Select a template

A dialog opens where you must choose an approved WhatsApp template. If the template has parameters (variables), fill in the values for each one.

Choose date and time

Select when to send the follow-up. You can use one of the quick options or choose a custom date:

Quick optionDescription
Tomorrow 9:00 AMSchedules the send for tomorrow morning
In 2 days 10:00 AMSchedules for the day after tomorrow mid-morning
In 1 week 9:00 AMSchedules for 7 days from now

For a custom date, use the date and time pickers.

Optionally, add a note (maximum 500 characters) explaining the reason for the follow-up. This note is internal and only visible to your team.

Click Schedule to confirm. You'll see a confirmation message indicating the follow-up was scheduled successfully.

The scheduled date must be between 5 and 90 days in the future. You cannot schedule follow-ups for the next few hours.

Follow-ups page

The follow-ups page is available in the sidebar under Follow-ups (calendar with clock icon). Here you can view and manage all scheduled follow-ups for your organization.

Follow-ups table

The table shows the following information for each follow-up:

ColumnDescription
ContactName and phone number of the target contact
TemplateName of the WhatsApp template that will be sent
Scheduled ForDate and time when the message will be sent
Created ByTeam member who scheduled the follow-up
StatusCurrent status of the follow-up
NoteOptional internal note (shown truncated, hover to see full text)
ActionsAction buttons based on status

Filter by status

Use the tabs at the top to filter follow-ups by status:

  • All --- Shows all follow-ups
  • Pending --- Follow-ups waiting to be sent
  • Sent --- Successfully sent follow-ups
  • Failed --- Follow-ups that could not be sent
  • Canceled --- Manually canceled follow-ups

Follow-up statuses

StatusDescription
PendingScheduled and waiting for the send date
ProcessingCurrently being sent (transient state)
SentSuccessfully sent to the contact via WhatsApp
FailedCould not be sent after several retries
CanceledManually canceled by a team member

Available actions

Available actions depend on the follow-up's status:

  • Pending: You can cancel the follow-up before it's sent
  • Failed: You can retry the send (rescheduled for 5 minutes in the future)
  • All statuses: You can click View to open the associated conversation

Only admins can delete canceled or failed follow-ups. Agents can cancel and retry their own follow-ups.

Automatic retries

When a follow-up fails due to a temporary error (such as WhatsApp API rate limits), Trochai automatically retries with incremental intervals:

  • 1st retry: 5 minutes later
  • 2nd retry: 15 minutes later
  • 3rd retry: 60 minutes later

If the send fails after 3 retries, the follow-up is marked as Failed and you can retry it manually from the table.

Automatic processing

Scheduled follow-ups are processed automatically every minute. When the scheduled date and time arrives:

  1. The system sends the template message to the contact via WhatsApp
  2. The message is recorded in the conversation history
  3. The conversation's last message date is updated
  4. A notification is sent to the follow-up creator

On this page