---
sourceDocument: Australia Conversational Interfaces
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/conversational-interfaces

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australia Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Test your Virtual Agent API configuration

# Test your Virtual Agent API configuration {#ariaid-title1}

* Freigeben Version: Australia
* 
* Aktualisiert 12. März 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Test your Virtual Agent API configuration using API testing tool.

## Vorbereitungen

Make sure you've setup Postman or Swagger or any other third-party application environment for API testing.

Role required: admin

## Warum und wann dieser Vorgang ausgeführt wird

API tests are a way to ensure that your API is behaving as you expect it to. To write a test, do the following:

## Prozedur

1. Select the environment that you've setup and navigate to tab where you can send your first API request.
2. Configure the payload.  
   For example, send the below request:

       {
           "requestId": "requestid123",
           "userId": "testuser.1",
           "emailId": "admin@example.com",
           "action": "START_CONVERSATION",
           "message": {
               "text": "",
               "typed": true
           },
           "contextVariables": {
               "app_name": "test"
           }
       }

3. Click Send.  
   You can check the response of your payload and your communication status in the response section.
   * If your instance is on asynchronous mode, you have to check enabling Virtual Agent API logging. See [Common errors in Virtual Agent API](https://servicenow-prod.fluidtopics.net/gWITKZf0qX_a8_d1Utkxxw "This section describes some common errors in Virtual Agent API and how they can be resolved.") for more information.
   * If your instance is on synchronous mode, you have to check the Body of the response.
   {#va-api-test__ul_dc4_yfc_23c}