Customize the bot configuration in Alloy Navigator

Introduced in 8.7.3

The Alloy Navigator bot configuration is an XML document that controls some aspects of the bot's interaction with Alloy Navigator. The configuration must be stored in the database, so first you need to import it to Alloy Navigator using the Settings App. Then you need to customize it there.

NOTE: You will be able to download the XML configuration using the download link in the instruction below.

Import the configuration to Alloy Navigator and customize it there

  1. Click here to download a zip archive containing an XML configuration file for the Alloy Navigator Teams bot.

  2. Unzip the archive.

  3. Launch your Alloy Navigator Settings App. For example, open the Alloy Control Panel and click Settings.

  4. In Settings, click Import Settings on the toolbar and import the XML bot configuration file. For detailed instructions, see Help: Importing configuration settings.

    NOTE: Once the import is complete, the imported configuration will be available under Services > Mobile Applications. Its name is TeamsBot.

  5. Go to Services > Mobile Applications and double-click TeamsBot. The Mobile Application [TeamsBot] dialog box opens.

  6. The configuration is available in the Configuration field. It is an XML document, where all configuration entries are wrapped inside the <Data> and </Data> tag pair.

    INFO: For detailed information on every configuration entry, see What does the configuration include?

    Element Description
    <Portal URL="SSP URL"/>

    The URL of your Self Service Portal. For details, see Self Service Portal URL.

    TIP: You can view the Self Service Portal URL in the Settings App. Go to Workflow and Business Logic > Advanced > System Macros and copy the contents of the Self Service Portal Link field. For details, see Settings App Help: Customizing links to Alloy web applications.

    <Tickets>
    	<CreateAction ID="CreateActionID"/>
    	<UpdateAction ID="UpdateActionID"/>
    </Tickets>

    This section specifies which workflow actions the bot uses for creating and updating tickets.

    For details, see Workflow action for creating tickets and Workflow action for updating tickets.

    <ApprovalRequests>
    	<ApproveAction ID="ApproveActionID"/>
    	<RejectAction ID="RejectActionID"/>
    </ApprovalRequests>

    This section specifies which workflow actions the bot uses for approving and rejecting approval requests.

    For details, see Workflow actions for approving and rejecting requests.

What does the configuration include?

The XML bot configuration in Alloy Navigator specifies the address of your Self Service Portal and defines which workflow actions the bot uses for creating and updating tickets and working with approval requests.

What's next?

NEXT STEP: Obtain credentials from Alloy Navigator to allow the bot to access Alloy Navigator.