Skip to content

Configuring Gallery URLs

Configuring gallery selection for subscribers.

By default, every Gallery defined with Direqt is accessible at the url:

https://chatbot.gallery?operator=<operator-code>&gallery=<gallery-code>

where <operator-code> is a value assigned to your operator account, and <gallery-code> is the code you associate with a gallery using the gallery editor.

You may also elect to have your operator account configured with a custom hostname, which allows you to use URLs like:

https://example-telco.chatbot.gallery

The above example, for an operator with hostname 'example-telco', omits both the <operator-code> and <gallery-code> parameters. The operator code is omitted because the hostname uniquely identifies the operator account, and and the gallery code may be omitted if the operator account is configured with a default gallery.

Read below for additional information and considerations for selecting the Gallery to display to each subscriber.

Operators may define any number of galleries using Galleries by Direqt. For example, different galleries may be built for the various languages supported by the operator, or there may be a combination of "live" galleries together with "staging" or "test" galleries.

Direqt selects the Gallery to display to a user based on parameters used in the Gallery URL visited by the subscriber's user agent, and configuration made in the Direqt Console.

In general, we recommend that operators always configure a default Gallery for each country (or HNI/ho) in which they operate.

  1. Every URL is associated with a specific operator account.

    a. If a custom hostname is used, that hostname determines the operator.

    b. Otherwise, the operator is specified with the operator query string parameter.

    c. If no associated operator account can be determined, no Gallery will be served.

  2. URLs may be associated with a home network identifier (HNI/ho)

    a. The HNI may be specified with an hni or ho query string parameter.

    b. If multiple ho or hni parameters are given, only the last one will be considered.

  3. URLs may be associated with a specific gallery

    a. A specific Gallery may be specified using the gallery query string parameter.

    b. Only Galleries owned by the URLs operator account may be specified;

    c. If an HNI is specified in the URL, only Galleries configured for that HNI may be specified;

    d. Any gallery specified using the gallery query string that is not owned by the URLs operator account, or is not configured for a specified HNI, will be ignored.

  4. Each HNI may be configured with a default Gallery

    a. The default Gallery for an HNI will be served if no gallery was specified in the URL

    b. It will also be served if a Gallery specified in the URL is not eligible.

Example URLs

  • Serve the default gallery configured for account "example-telco":

    https://chatbot.gallery?operator=example-telco

    https://example-telco.chatbot.gallery

  • Serve the default gallery for HNI 123456 configured in 'example-telco'

    https://chatbot.gallery?operator=example-telco&ho=123456

    https://example-telco.chatbot.gallery?ho=123456

  • Serve a specific gallery (with code "my-gallery")

    https://example-telco.chatbot.gallery?gallery=my-gallery