temporal_heatmap
Visualize messaging activity patterns by generating a weekly heatmap showing message counts across days and hours. Filter by contact, date range, or message type to analyze conversation frequency trends.
Instructions
Generate a 7x24 activity heatmap (day-of-week x hour-of-day). Returns message counts for each of the 168 weekly time slots. By default excludes contacts you've never replied to.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "temporal_heatmap"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contact | No | Filter by contact handle | |
| date_from | No | Start date | |
| date_to | No | End date | |
| sent_only | No | Only your messages | |
| include_all | No | Include messages from all contacts, even those you've never replied to (default: false) |