Location: Targets or RTB Targets → Agent Availability Check
Last Updated: October 24, 2025
📝 Overview
Agent Availability Check ensures that calls are routed only to targets with active agents available.
Before a routing decision is made, Moja can perform a lightweight availability “ping” to a configured endpoint. Targets are considered eligible only if the endpoint confirms agent availability, helping prevent missed calls and inefficient routing.
⚙️ How Agent Availability Check Works
When enabled on a target, Moja evaluates agent availability as part of the pre-routing eligibility logic.
Eligibility Rules
Moja sends a request to the configured availability URL
If the response value is greater than 0, the target is eligible
If the response value is 0, or the request times out, the target is excluded
Ping duration and results are logged for reliability tracking
🟦 Execution Timing: The availability check runs before routing, alongside advanced filters and hours-of-operation checks.
🔧 Configuration Options
You’ll find the following settings on each Target or RTB Target configuration page:
🔗 Availability Ping URL
Endpoint used to check current agent availability⏱️ Availability Ping Timeout (ms)
Maximum wait time before marking a target unavailable
(Default: 1000 ms)
🧠 Technical Details
Internally, Agent Availability Check:
Extends the Target schema with:
availability_ping_urlavailability_ping_timeout
Reuses existing RTB ping components
Executes during pre-routing eligibility evaluation
Includes full unit and integration test coverage for:
Successful responses
Timeouts
Error scenarios
🛡️ Reliability: Targets that fail availability checks are safely skipped without interrupting routing.
🎯 Why This Matters
Without availability validation, calls can be routed to endpoints with no live agents — leading to wasted attempts and poor connection rates.
Agent Availability Check ensures:
📞 Calls reach staffed endpoints
⚡ Faster, more efficient routing
📉 Reduced failed or unanswered calls
🎯 Improved partner and buyer performance
💡 Example Use Cases
Skip routing to call centers that are temporarily unmanned
Dynamically disable inactive vendor endpoints
Support load-based or capacity-aware distribution across partner networks
🚀 Getting Started
Open a Target or RTB Target configuration
Enable Check Agent Availability
Enter the Availability Ping URL
(Optional) Adjust the timeout based on your API’s response speed
Save the target
✅ The availability check will now run automatically before each routing decision.