Configuration Builder Configuration Builder

Configuration Builder

Chandra Bergmann Chandra Bergmann

The Configuration Builder dictates the paths through which your Airkit apps interact with external sources. This allows you to do everything from configure the URLs that launch your web apps to authenticate external systems of record. The Configuration Builder is also where can create different Profiles with access to different resources and app-level configurations, which can be used when deploying the app under different circumstances. Most commonly, different Profiles will be made to ensure that an app deployed for testing and development purposes cannot interact with the outside world in the same way as when deployed to production.

This article will cover the following:

Profiles

A Profile is a group of configuration settings. When working in the Configuration Builder, you are making changes to a Profile, and you can select which Profile you are working with by selecting a Profile from the drop-down menu at the top of the Configuration Builder. By default, every Airkit app comes out of the box with three Profiles: Dev, QA, and Production:

2021-06-29_13-03-54__1_.gif

Whenever you deploy your app, you'll have the option of using any of the available Profiles. This allows different deployments of your app to incorporate themselves differently with the outside world. For instance, depending on your needs, different deployments of you application might send text messages from different phone numbers, be accessed through different URLs, or integrate with different systems of record. Each of your Airkit apps might have any number of different Profiles, and you can add new Profiles by clicking on the '+' icon on the upper right of the Configuration Builder.

2021-06-29_13-07-11__1_.gif

When previewing your application, your emulated app will behave as though using whatever Profile is currently selected in the Configuration Builder.

Global Settings

Every Profile has its own global settings, which define fundamental information regarding how your application will behave.

2021-06-29_13-10-09.png

  • Locale - Dictates the default language and timezone of your application. Changes to either can be made by selecting a new language or timezone from the dropdown menus.
  • Session Expiration Time - Defines how long a Journey through the app will last before expiring. 
  • App Authentication Type - Designates the authentication type that you would designate your app if you were creating an authenticated app experience.
  • Delete Profile - Deletes the profile you are working within. 

Voice Bot

This section is used to define how your app will make and handle phone calls when deployed. You will need to add the relevant resources to your organization in order to have access to them in the Configuration Builder. For more on how to add phone resources to your organization, check out Connecting your Twilio Numbers to Airkit.

2021-06-29_13-11-44.png

  • Voice Resource - The voice resource (selected from the the voice resources available within your organization) that the application will take and send calls from.
  • Voice Locked Behavior - How the application behaves when the voice resource cannot be reached.
  • Voice Bot Behavior When Launched - How launching a Voice Bot impacts a user's Journey.

Chat Bot

This section is used to define how your app will make and handle text messages when deployed. You will need to add the relevant resources to your organization in order to have access to them in the Configuration Builder. The dropdown menu under SMS Resource will allow you to select from all relevant resources within your organization:

2021-06-29_13-36-05.png

For more on how to add SMS resources to your organization, check out Connecting your Twilio Numbers to Airkit.

Integrations

Integrations represent connections to external systems of record. Once your Airkit app is integrated with an external system of record, data can flow easily between them.

Integrations are created through adapters, and you define which Data Source your app uses for each configuration. This can be useful when using different sources of record for production or development.

You will need to add the relevant resources to your organization in order to have access to them in the Configuration Builder. When adding a new integration (by selecting the '+ New' icon on the bottom left), you will only be able to select options from relevant resources within your organization:

 

2021-06-29_13-39-44__1_.gif

For more on how to integrate external systems of record to your organization, check out Connecting Airkit to Your Systems.

Email

This section is used to configure email addresses and email domain addresses that can be used to send emails from within Airkit: 

2021-06-29_13-42-23__1_.gif

You will need to add the relevant resources to your organization in order to have access to them in the Configuration Builder. For more check out Setting up email domains and addresses in Console and Configuring a Domain for Sending Email

API Key Filtering

Airkit apps can be associated with their own APIs, to use when you need to interact with your apps or the data within them outside of Airkit. The API Key Filtering section is used to permission your App API based on API Keys:

2021-06-29_13-44-27__1_.gif

You will need to have a relavant web resource to your organization in order to configure your API in this way. For more on how to set this up, see Creating an API for your Airkit App.

Canvas Links

This section is used to define the web resources that your app will use when deployed. (By default, this app resource is app.airkit.com.) This differs from the web resources defined under Web URLs, because these links are associated with individual user Journeys; going a canvas link allows a user to continue an existing Journey, rather than start a new one.

You will need to add the relevant URL resource to your organization in order to have access to it in the Configuration Builder. For more on how to add these resources to your organization, check out Connecting Your Domain to Airkit.

2021-06-29_13-47-15.png

  • Web Resource - The domain that will be associated with the web component of your app. 
  • Canvas Link Length - The length the path of URL that links to a particular user's Journey; this will be automatically generated so that it is unique for each Journey.
  • Expired Session HTML - Defines what a users sees should they try to open a link that leads to an expired Journey.

Web URLs

The web URL is the URL that will launch your app's web experience. This differs from the web resources defined under Canvas Links, because the URL defined here will start a new Journey through the application, rather than direct the user to an existing one.

You will need to add the relevant URL resource to your organization in order to have access to it in the Configuration Builder. For more on how to add these resources to your organization, check out Connecting Your Domain to Airkit.

2021-06-29_13-48-51__1_.gif

  • Name - The name to associate with this launch URL.
  • SAML Auth - How users will be authenticated, if necessary. 
  • Web Resource - The domain to associate with launching a web component of your application. 

Portal Link

This section is used to configure the URL leading to any Portals associated with your application. You will need to add the relevant URL resource to your organization in order to have access to it in the Configuration Builder. For more on how to add these resources to your organization, check out Connecting Your Domain to Airkit.

2021-06-29_13-52-59.png

Data Store

This section is used to select the primary Datastore associated with your current Profile. This is where data will be stored to and queried from once your app is deployed.

2021-06-29_13-53-28.png

Analytics

This section is used to integrate your app with with third-party data analytics providers by associating each provider with an app ID. You will need to add the relevant analytics providers to your organization in order to have access to them in the Configuration Builder.

2021-06-29_13-53-47.png

Further Resources