Genesys Cloud - Developer Community!

 View Only

Sign Up

  • 1.  Callback API for preferred agent

    Posted 20 days ago

    I've been experimenting with the POST /api/v2/conversations/callbacks REST API to create a preferred‑agent / agent‑owned callback.

    Scenario:
    After an outbound call attempt, we send a post‑call SMS informing the end user that we tried to contact them. The SMS instructs them to reply with CALLBACK, which then creates a callback in the original queue.

    This flow works perfectly when using a standard queue callback.

    What we're trying to improve is the routing logic:

    • The callback should be assigned to the original agent who made the outbound call.
    • If that agent is not available (not in queue, logged out, etc.), the callback should time out and be reassigned to the next available agent in the queue.

    At the moment, the callback works if the preferred agent is in queue, but I can't get it to fall back to another agent after a timeout. I've tried multiple combinations using agentOwnedCallback, scoredAgents, and preferred‑agent settings, but without success.

    Below is a screenshot from my latest test.

    Has anyone implemented this successfully, or can point me in the right direction on how to make the fallback to the queue work?




    #DataActions
    #PlatformAPI

    ------------------------------
    Jasper Donovan
    na
    ------------------------------


  • 2.  RE: Callback API for preferred agent

    Posted 19 days ago

    Hi Jasper,

    From the screenshots, it looks like you may be mixing a few different callback/routing options together , AGENT_OWNED_CALLBACK in the API, scoredAgents, queue routing set to Preferred Agent Routing, and the callback type set to Agent First. I wonder if that combination is preventing the timeout behaviour you're expecting. Have you already tried removing AGENT_OWNED_CALLBACK and testing with scoredAgents only, so the queue's Preferred Agent Routing / timeout settings can do the work?

    Hope this helps, someone else may have tested this combination more deeply.



    ------------------------------
    Phaneendra
    Technical Solutions Consultant
    ------------------------------



  • 3.  RE: Callback API for preferred agent

    Posted 14 days ago

    Thanks for feedback, i have been trying with all the different combinations i can think of to get it to work, so far either the Callback never gets assign to even to primary agent or only the primary agent get the callback. the other agents never get the call. I even had an agent in queue for 90 minutes   which never got the callback. As soon as the primary was in queue it got the callback.



    ------------------------------
    Jasper Donovan
    na
    ------------------------------



  • 4.  RE: Callback API for preferred agent

    Posted 14 days ago
    Edited by Phaneendra Avatapalli 14 days ago

    Hi Jasper,

    Thank you for letting me know.

    From my understanding, if the callback already works when the preferred agent is available, but the timeout fallback is the part that does not work, then Trigger + Workflow may be worth looking at for the timeout logic rather than relying on native preferred-agent callback behavior alone.

    The Resource Center FAQ below may also help, as it explains that for callbacks, Preferred Agent Routing does not behave the way many expect:

    Hopefully someone from the community might also have a workaround they can share.



    ------------------------------
    Phaneendra
    Technical Solutions Consultant
    ------------------------------



  • 5.  RE: Callback API for preferred agent

    Posted 14 days ago

    Thank you for this information that you share.  I will also review these for my own knowledge.



    ------------------------------
    Nicolas Quermia
    Technical Account Manager
    ------------------------------



  • 6.  RE: Callback API for preferred agent

    Posted 13 days ago

    Hi Jasper,

    Also sharing these related threads in case they help, as they discuss similar timeout / fallback patterns for preferred-agent interactions, although the design there is more about moving to another queue after a wait period:

    https://community.genesys.com/discussion/how-can-we-transfer-the-call-from-preferred-routing-method-queue-to-another-queue-not-to-another-routing-method

    https://community.genesys.com/discussion/preferred-agent-callback-reassignment-after-timeout



    ------------------------------
    Phaneendra
    Technical Solutions Consultant
    ------------------------------