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

 Release :

    - australia

ft:locale :

    - pt-BR

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}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

Test your Virtual Agent API configuration using API testing tool.

## Antes de Iniciar

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

Role required: admin

## Por Que e Quando Desempenhar Esta Tarefa

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

## Procedimento

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/bfS_YNvPYehaq1T0yfxZGQ "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}