Skip to content
Moja AI Help
Migrated — not yet rewrittenCarried over from the previous help center on 28 August 2026. Content is accurate as published but has not been rewritten to the current article template.

‍💼 Agent Availability Check

Location: Targets or RTB Targets → Agent Availability Check
​Last Updated: October 24, 2025

📝 Overview

Section titled “📝 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

Section titled “⚙️ How Agent Availability Check Works”

When enabled on a target, Moja evaluates agent availability as part of the pre-routing eligibility logic.

Eligibility Rules

Section titled “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

Section titled “🔧 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

Section titled “🧠 Technical Details”

Internally, Agent Availability Check:

  • Extends the Target schema with:

    • availability_ping_url

    • availability_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

Section titled “🎯 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

Section titled “💡 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

Section titled “🚀 Getting Started”

  1. Open a Target or RTB Target configuration

  2. Enable Check Agent Availability

  3. Enter the Availability Ping URL

  4. (Optional) Adjust the timeout based on your API’s response speed

  5. Save the target

✅ The availability check will now run automatically before each routing decision.