Proactive check-ins

1. What it is

Proactive check-ins are periodic messages your agent sends to users who have subscribed to them. Instead of waiting for the user to start a conversation, the agent reaches out to see how they are, ask a question, or suggest something relevant. Check-ins are delivered as cards that users can answer, ignore, or unsubscribe from.

2. Turn it on

In the agent editor, find the Proactive Ping toggle. When you turn it on, your agent can propose check-ins to users during conversations. Users who accept are subscribed and will receive periodic messages.

3. How delivery works

Proposal: During a conversation, your agent can call the propose_to_user tool withkind='proactive_ping' to invite the user to subscribe to check-ins.

Subscription:If the user accepts, they're added to the agent's subscriber list.

Delivery: A platform-owned cron service delivers check-ins to all subscribers on a periodic schedule. Users can unsubscribe from the card at any time. No manual work needed on your end — once you enable it, the delivery pipeline handles the rest.