Skip to main content

🧑‍💼 Agent Availability Check

agent check, availability ping, check for agents, target availability, agent availability check

Written by Moja Bot
Updated over 3 months ago

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_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

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

  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.

Did this answer your question?