> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Configure and use the ServiceNow app

## Overview\[#UUID-ceef6edd-0bf3-2082-53d2-d8e246f984ad_id_4412452532115_id_h_01FPZHB0YBGBZYGK1W1F63SJHV]

The ServiceNow app connects your chatbot to your ServiceNow account.
Once connected, your bot can create ServiceNow incidents in your system
within any Answer you choose.

## Connect the ServiceNow app\[#UUID-ceef6edd-0bf3-2082-53d2-d8e246f984ad_id_4412452532115_id_h_01FPZHB6NARPNV1TXQH7M1ZWDP]

Before you can use the ServiceNow block, you must connect Ada with your
ServiceNow account. Before you start, have your ServiceNow subdomain,
username, and password ready.

1. On the Ada dashboard, go to **Settings** > **Integrations**.

2. In the Integrations view, scroll down to App Integrations. Find the
   ServiceNow integration card in the list, then click **Connect**. The
   ServiceNow configuration dialog opens.

3. In the ServiceNow configuration dialog, complete the three fields
   with your ServiceNow account credentials:

   * **Subdomain**

     > **Note**
     >
     > The subdomain is the portion of your ServiceNow account URL unique
     > to your account, found just in front of *service-now\.com*
     > (`https://SUBDOMAIN.service-now.com`).

   * **Username**

   * **Password**

4. Click **Save**.

## The ServiceNow Answer\[#UUID-ceef6edd-0bf3-2082-53d2-d8e246f984ad_id_4412452532115_id_h_01FQMTRV5BDWWY018AX34VAZC9]

The ServiceNow block connects your bot to your ServiceNow account,
creates a ticket, and attaches the incident information. Since block
itself simply transfers the information, how do we get the information
in the first place? The answer is in how you build the Answer. Let's
look at how to build an ServiceNow Answer.

There are two fields you need to complete for the ServiceNow block:

* **Email** – Capture the email variable directly from the chatter using
  the Capture block. It can also be passed to your bot as a
  [metavariable](/scripted/docs/build-and-maintain-your-bot/personalize-conversations/get-started-with-variables)
  from your database.

* **Short Description** – This field contains the issue your chatter is
  reporting. Use a [Capture block](/scripted/docs/build-and-maintain-your-bot/work-with-blocks-and-apps/save-chatter-information-using-the-capture-block)
  to ask the chatter to describe their issue directly and save it in a
  variable. You then add that variable to the short description field.
  You can also use the [Fetch Chat Metadata](/scripted/docs/build-and-maintain-your-bot/work-with-blocks-and-apps/generate-a-chat-transcript-using-the-fetch-chat-metadata-block)
  block to export the entire chat transcript to another variable.

Your ServiceNow Answer must include blocks positioned to capture this
information before the ServiceNow block. A typical setup serves the
blocks in this order:

1. Capture block (email)

2. Capture block (chatter's issue)

3. Fetch Chat Transcript block (chat transcript)

4. ServiceNow block

![](/_fern-files/_img/f8f5a26667e2a2b5f50336ff51b922528d35c43aa71f8003c2bfeacbd43ed7f4.webp)

Now that we've seen how to organize a ServiceNow Answer, let's look at
how to configure the ServiceNow app and set up the Answer block.

## Configure the ServiceNow block\[#UUID-ceef6edd-0bf3-2082-53d2-d8e246f984ad_id_4412452532115_id_h_01FPZHBB3E2RG5THDP8J7MHKG0]

Once you've connected your bot with your ServiceNow account, you're
ready to configure the ServiceNow block.

1. Go to **Build** > **Answers**, open an Answer or create a new one,
   then drag and drop the **ServiceNow** block into your Answer.

2. In the ServiceNow block, click the **Select Action** drop-down menu,
   then select **Create an Incident**. The Select Variables for Inputs
   and Save Response as Variables sections appear.

3. Under Select Variables for Inputs, complete the two mandatory
   fields:

   * **Email ID** – Add the email variable to this field to attach the
     chatter's email address to the incident.

   * **Short Description** – Add the chat transcript variable captured
     by the Fetch Chat Metadata block.

4. Click the **Select Optional Inputs** drop-down menu, then select any
   of the following optional input fields you'd like to include with
   your ServiceNow incident:

   | Field                | Description                                                                                 |
   | -------------------- | ------------------------------------------------------------------------------------------- |
   | **Assignment Group** | Add the team to which this incident should be assigned.                                     |
   | **Category**         | Add the incident category.                                                                  |
   | **Subcategory**      | Add the incident subcategory.                                                               |
   | **Urgency**          | Use a number from 1 to 3 to indicate the urgency of the incident, with 1 being most urgent. |

5. \[Optional] Under Save Response as Variables, click the **Select
   Optional Variables** drop-down menu, then select **Incident
   Number**.

6. Click the **Choose a Variable** drop-down menu, then choose an
   existing variable or create a new variable to capture the Incident
   Numbers.

7. Under Fallback Answer, click the **Choose an Answer** drop-down
   menu, then select a fallback Answer with messaging for your chatters
   should something prevent the block connecting to the ServiceNow API.

8. \[Optional] Under [Track Event](/scripted/docs/measure-success/plan-and-collect-feedback/create-and-track-chatter-actions),
   click the **Select or Create an Event** drop-down menu, then select
   an Event from the list, or create a new one. Doing this records the
   event in the Event Performance report.

9. Click **Save**.

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).