Personal Message Scheduling

Message Scheduling

Create automated scheduled messages for WhatsApp groups/contacts or Slack channels.

Quick Start

1. Determine the API base URL based on environment:

   • Local/Development: http://localhost:4098
   • Production: https://ai.proph.bet/dashboard

2. Use curl to create a scheduled job:

# Set API base (local or production)
API_BASE="http://localhost:4098"  # or https://ai.proph.bet/dashboard

curl -X POST "${API_BASE}/api/schedules" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily Standup Reminder",
    "scheduleType": "cron",
    "cronExpression": "0 9 * * 1-5",
    "timezone": "Asia/Jerusalem",
    "provider": "whatsapp",
    "target": "120363406740668957@g.us",
    "messageTemplate": "🔔 Standup in 10 minutes!\n\nDate: {{date}}\nDay: {{day}}",
    "enabled": true
  }'

Schedule Types

Cron (most flexible)

Use for complex schedules. See references/cron-reference.md for presets and syntax.

{
  "scheduleType": "cron",
  "cronExpression": "0 9 * * 1-5"
}

Recurring (interval-based)

Run at fixed intervals (in minutes):

{
  "scheduleType": "recurring",
  "intervalMinutes": 60
}

One-Time

Run once at a specific ISO 8601 timestamp, then auto-disable:

{
  "scheduleType": "once",
  "runAt": "2026-01-15T09:00:00.000Z"
}

Required Fields

Target Lookup

• WhatsApp groups: Use JID format XXXXXXXXX@g.us
• WhatsApp contacts: Use 9725XXXXXXXX@s.whatsapp.net
• Slack channels: Use channel ID (e.g., C01234567)

See references/known-targets.md for common targets.

Template Variables

API Endpoints

All endpoints require Bearer token auth when applicable.

Common Examples

Daily Standup Reminder (Weekdays 9 AM)

curl -X POST "${API_BASE}/api/schedules" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily Standup",
    "scheduleType": "cron",
    "cronExpression": "0 9 * * 1-5",
    "timezone": "Asia/Jerusalem",
    "provider": "whatsapp",
    "target": "120363406740668957@g.us",
    "messageTemplate": "🔔 **Daily Standup**\n\n📅 {{date}} ({{day}})\n\nTime for our daily sync!",
    "enabled": true
  }'

Friday Weekly Summary (Friday 5 PM)

curl -X POST "${API_BASE}/api/schedules" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Weekly Summary",
    "scheduleType": "cron",
    "cronExpression": "0 17 * * 5",
    "timezone": "Asia/Jerusalem",
    "provider": "whatsapp",
    "target": "120363406740668957@g.us",
    "messageTemplate": "📊 **Weekly Summary**\n\nHappy Friday! {{date}}\n\n✅ Review sprint progress\n✅ Update time tracking\n\nHave a great weekend! 🎉",
    "enabled": true
  }'

One-Time Meeting Reminder

curl -X POST "${API_BASE}/api/schedules" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Project Kickoff Reminder",
    "scheduleType": "once",
    "runAt": "2026-01-15T08:45:00.000Z",
    "provider": "whatsapp",
    "target": "120363406740668957@g.us",
    "messageTemplate": "⚡ Project Kickoff in 15 minutes!\n\n📅 {{date}} at {{time}}",
    "enabled": true
  }'

Manage Existing Jobs

# List all jobs
curl "${API_BASE}/api/schedules"

# Disable a job
curl -X POST "${API_BASE}/api/schedules/1/toggle" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

# Run job now (test)
curl -X POST "${API_BASE}/api/schedules/1/run"

# Delete a job
curl -X DELETE "${API_BASE}/api/schedules/1"

Timezones

Supported values: UTC, Asia/Jerusalem (default), America/New_York, America/Los_Angeles, Europe/London, Europe/Paris, Asia/Tokyo, Australia/Sydney

Error Handling

Jobs that fail are logged with errors in the run history. Check status via:

curl "${API_BASE}/api/schedules/1/runs?limit=10"