Temporal Triggers
Automating asynchronous message dispatch.
Broadcast Architecture
The Task Engine supports high-precision execution. Tasks are stored in a priority queue sorted by `nextRunAt`.
taskType: "send_message", // see Task Types below
nextRunAt: 1735689000000, // Epoch ms
status: "scheduled",
payload: { text: "Hello!", recipients: [...] }
Task Types
send_message
Send a pre-composed text or media message to one or more recipients.
ai_broadcast
AI-powered broadcast. The agent generates personalized content for each recipient based on natural-language instructions.
agent_run
Trigger a full agent reasoning loop at a scheduled time. The agent executes with its full tool set and can take autonomous actions.
follow_up
Schedule a follow-up message to a specific user. Typically created by the AI during a conversation to check back later.
heartbeat
Periodic health-check task (Phase 4 placeholder). Reserved for future proactive agent behaviors.
Recurrence Models
Single Shot
Executes exactly once. Ideal for strict appointment reminders or manual announcements.
Status Flow: `scheduled` → `completed`
Interval / Cron
Reschedules itself after execution based on `intervalMs`.
Status Flow: `scheduled` → `completed` (execution) → `scheduled` (next run)
Timezone Handling
The server runs on UTC (Coordinated Universal Time).
⚠️ ALWAYS verify your organizational timezone setting in `Settings` before scheduling campaigns.