Recommend the best messaging channel for a contact
Rank the messaging channels a contact is actually reachable on and return the best one to send on next, with a fallback chain, a predicted engagement score (0-1), the estimated per-message cost in cents and a short human-readable reason. The recommendation blends the contact’s addressable channels, historical per-channel engagement and the smart-router scoring rules. Tune it with the messageType, urgency and costOptimize query parameters. Use it to power the campaign-builder “why this channel?” hint.
Authorizations
Dashboard JWT token from Clerk
Path Parameters
Query Parameters
Kind of message being sent; biases the ranking. Defaults to transactional.
transactional, marketing, otp Delivery urgency; high urgency favours fast channels. Defaults to medium.
low, medium, high Pass "true" or "1" to prefer the cheapest channel that still meets the quality bar.