vellum-ai/followups

Track messages sent on external channels (email, Slack, WhatsApp, etc.) that are awaiting a response.

Lifecycle

Each follow-up moves through these states:

• pending -- waiting for a response
• overdue -- past the expected response deadline with no reply
• nudged -- a reminder was sent after becoming overdue
• resolved -- a response was received or the follow-up was manually closed

Auto-Deadline

When expected_response_hours is set, the follow-up automatically becomes overdue after that window. If a contact_id is provided, the contact's importance score can inform grace period decisions.

Resolution

Follow-ups can be resolved in two ways:

1. By ID -- resolve a specific follow-up directly
2. By conversation -- provide channel + conversation_id to auto-resolve all matching pending follow-ups (useful when a response arrives on a conversation)

Tips

• Use followup_list with overdue_only: true to find conversations that need attention.
• Attach a reminder_schedule_id to link a recurring reminder schedule to a follow-up.
• Filter by channel, status, or contact to narrow results.