Skip to main content
Back to Actions Integrations Connect the XO Platform to Here to find locations by text. See Here documentation for details.

​
Supported Authorization Types

The platform supports API key authentication for Here integration. See App Authorization Overview for details.
Authorization TypeSupported
Pre-Authorize the IntegrationYes
Allow Users to Authorize the IntegrationYes

​
Prerequisites

Before enabling the Here action:
  • Create a Here Developer account.
  • Create a custom app on the Here admin page.
  • Copy your Here personal access token.

​
Enable the Here Action

Go to App Settings > Integrations > Actions and select Here from the Available actions list.

​
Pre-authorize the Integration (Basic Auth)

  1. In the Configurations dialog, select the Authorization tab.
  2. Set Authorization Type to Pre-authorize the Integration > Basic Auth. Auth type
  3. Enter your API Key. API key
  4. Click Save. On first configuration, the Integration Successful pop-up appears. Save integration
The Here action moves from Available to Configured.
  1. Click Skip for Now to install templates later. Skip for now

​
Allow End Users to Authorize (Basic Auth)

  1. In the Configurations dialog, select the Authorization tab.
  2. Set Authorization Type to Allow Users to Authorize the Integration > Basic Auth.
  3. Click Select Authorization > Create New. Create new auth
  4. Select the authorization mechanism (e.g., API Key). Auth mechanism See App Authorization Overview for creating Basic Auth profiles.
  5. Enter the following credentials:
    FieldDescription
    NameName for the Basic Auth profile
    Tenancy URLsSelect Yes if tasks require tenancy URLs
    Base URLBase tenant URL for the Here instance
    Authorization Check URLAuth check URL
    DescriptionDescription of the auth profile
    Auth credentials
  6. Click Save Auth, then select the new profile.
  7. Click Save. The Integration Successful pop-up appears.

​
Install Here Action Templates

  1. On the Integration Successful dialog, click Explore Templates. Explore templates
  2. Click Install for the desired template. Install
  3. Click Go to Dialog to view the dialog task.
  4. A dialog task is auto-created for each installed template.
  5. Alternatively, create a new dialog task, select the Here integration, choose a template (e.g., Get Location), and click Proceed. Create new dialog task
  6. The canvas opens with all required entity nodes, service nodes, and message scripts. Dialog task canvas