> ## Documentation Index
> Fetch the complete documentation index at: https://flywheel.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Smart Message
> Send context-aware messages across email and Slack from a single agent tool
## How Smart Message works
Smart Message lets an agent choose communication paths using a unified message tool. It can work across configured contact methods and use runtime context to decide the right delivery behavior. Rather than requiring separate email and Slack tools, Smart Message consolidates outreach into a single step where the agent selects the optimal channel based on available contact information, urgency, and your configured strategy.
## Configuration
Guidance for when this tool should run and how the agent should compose or route the message.
The target user to contact.
The internal sender identity used for message context.
Communication channels this tool can use.
How Flywheel should choose among available contacts for enabled methods.
Final result for send routing and delivery (e.g. sent, failed, skipped).
Channel chosen for the message attempt (e.g. email, slack).
User ID the message was delivered to.
Sender identity used for the message.
Unique identifier for the sent message when delivery succeeds.
Whether a fallback channel was used when the preferred channel was unavailable.
## Use Cases
**Channel-Aware Urgent Outreach**
```
Condition: User has Slack identifier and email
Strategy: Prefer Slack for urgent updates, fall back to email
Use: Reach users on their most responsive channel for time-sensitive messages
```
**Email Fallback Routing**
```
Condition: No valid Slack identifier available
Strategy: Automatically route to email
Use: Ensure delivery even when the preferred channel is unavailable
```
**Lifecycle Event Follow-Up**
```
Condition: Proactive outreach after key lifecycle events
Strategy: Use contact selection strategy to pick the best channel
Use: Deliver timely, personalized messages without hardcoding a channel per workflow
```
**Multi-Touch Engagement**
```
Condition: User completed onboarding but has not activated a key feature
Strategy: Send via Slack if available, email otherwise
Use: Drive feature adoption with a single flexible outreach tool
```
## Best Practices
**Channel Policy**
* Define allowed methods explicitly so routing remains predictable and auditable.
* Reserve Smart Message for scenarios where channel flexibility is genuinely helpful — use dedicated email or Slack tools when the channel is always the same.
* Test fallback behavior to confirm messages still deliver when the primary channel is missing contact data.
**Sender Context**
* Ensure sender identities are valid and intentional for the outreach type.
* Match the sender to the user's assigned CSM or account owner for personal-feeling messages.
* Avoid generic sender identities for high-touch outreach where relationship context matters.
**Message Quality**
* Use the agent prompt to guide tone and length based on the delivery channel — Slack messages should be concise, emails can be more detailed.
* Pair Smart Message with Find Event or Set Custom Property to ground the message in real user activity.
* Monitor `message_status` and `fallback_used` outputs to identify users with incomplete contact data.