Genesys Cloud - Developer Community!

 View Only

Sign Up

  • 1.  Create Agent Auto-Evaluation Form via API

    Posted 2 days ago
      |   view attached

    Hi, 

    I attempted to create an agent auto‑evaluation form using the
    /api/v2/quality/forms/evaluations endpoint, based on the request body provided in the attached example. The request succeeds and the form is created; however, I noticed that the question is not configured as expected.

    Specifically, the "AI Scoring" / "Evaluation Assistant" option is not enabled for the question.

    After reviewing the schema in the API Explorer, it looks like the missing piece might be the aiScoring object, which requires both questionGroupContextId and questionContextId. Based on this, it seems that AI scoring cannot be fully configured during form creation and may instead require a follow‑up API call to update the evaluation after the form has been created.

    Has anyone encountered this before or can confirm whether a separate update request is required to configure aiScoring? Any guidance would be appreciated.


    #PlatformAPI

    ------------------------------
    Siang Chuen Phoo
    Senior Principal Software Engineer
    ------------------------------

    Attachment(s)

    txt
    example.txt   1 KB 1 version


  • 2.  RE: Create Agent Auto-Evaluation Form via API

    Posted yesterday
    Edited by Phaneendra Avatapalli yesterday

    Hi Siang,

    I have not implemented this specific API flow yet myself, but from what I have seen, your understanding seems reasonable.

    The help content confirms that AI Scoring / Evaluation Assistance is configured at the question level in evaluation forms, including Agent Auto-Complete forms:
    https://help.mypurecloud.com/articles/create-publish-evaluation-form/
    https://help.mypurecloud.com/articles/automated-scoring-options-in-evaluation-forms/
    https://help.mypurecloud.com/articles/agent-auto-complete-form-type/

    From what you described, it does look like a create first, then update scenario, since the aiScoring object appears to require questionGroupContextId and questionContextId, which may only be available after the form and questions are created. 

    I have not seen an official example confirming that sequence, but based on the schema and the behavior you are seeing, a follow-up update request seems the most likely approach.

    Hope this helps and someone who implemented this might add more.



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

    Original Message


Related Content