Subdomain naming requirements and best practices

Overview

IMPORTANT   Please note that changing your subdomain name is a one-time decision that cannot be reversed.

Calabrio ONE has added subdomains, often referred to as vanity URLs, for all Calabrio ONE Cloud tenants, including New WFM-only Cloud tenants. Subdomain-based URLs are not available to on-premises tenants and Teleopti WFM tenants. One decision-maker from your organization (e.g. an administrator, manager, or director) must decide on a unique subdomain name for your entire organization.

EXAMPLE   Your organization's unique URL appears as, https://[uniquename].calabrio.one, where [uniquename] is the subdomain a decision-maker selected for your organization's entire tenant account.

If you choose to change your organization's subdomain, please note the following considerations.

  • Your organization can only have one active subdomain at a time.
  • When establishing a new subdomain, your organization may experience downtime for approximately twenty-four hours before your new subdomain URL is available due to worldwide DNS propagation limitations.
  • Changes to your subdomain name may also affect your single-sign configuration.
  • Custom built API solutions with Calabrio ONE are not affected by subdomain changes.

Process

  1. Your tenant is assigned a default subdomain.
    • If you are satisfied with the assigned subdomain, then no further action is required.
  2. If you are the assigned decision-maker for your organization's tenant(s), you have the one-time option to change the subdomain. To change your tenant's default subdomain, follow this link to submit a support ticket.

  3. Your submission is reviewed and a support technician fulfills your one-time request if it adheres to the requirements detailed below.

Requirements

  • Follow Domain Name system (DNS) rules.

    • Allowed: Lowercase letters (a-z), numbers (0-9), and hyphens (-)

    • Not allowed: Spaces, underscores (_), special characters (such as @, #, !, and more)

    • Subdomains cannot start or end with a hyphen

  • No uppercase characters
  • Minimum of three characters
  • Maximum of twenty characters
  • No profanity
  • Cannot be Calabrio, names trademarked by other organizations and people, or Reserved subdomains
  • Name squatting (using a name not related to your company/organization) is not permitted
  • Must be a unique name

  • A subdomain name is required for each tenant.

    EXAMPLE   I'm the decision-maker for my company, named Salabrio. We have two tenants for our Salabrio account, one tenant is for our sales team, and the other tenant is for our support team. Therefore, as the decision-maker, I must come up with two subdomain names. One name for Salabrio's sales team. The other name for Salabrio's support team.

Best practices

  • If you have multiple tenant accounts then each of them must have a different tenant subdomain. As a best practice, you should use the organization's name and possibly something else such as a lab, a language, or other characteristic.

    • Subdomain names should primarily reflect your organization.

      NOTE   If your organization has a common name, or if your organization has multiple tenants then you might have to get creative. For example, you work at Sales Co., but Sales Co. is often confused with a different company named Sales Corp.

  • Secondarily, your subdomain should reflect your tenant in any of the following ways.

    • Function-based domains that reflect the tenant's purpose or team. Examples include Support, Sales, IT, HR.

    • Environment-based domain examples include development, QA/testing, and staging.

    • Region or language-based domain examples include French language content, Spanish language content, or regions such as Canada or Italy.

    • Product or service-based subdomain examples include mobile apps, partner, analytics.

    • Audience-specific subdomain examples include internal, customers, and vendors.

    General best practices that you should consider are,

    • Be concise

    • Be consistent - {language}.{function}.{calabrio.one} is an example of a naming convention you can use if your organization has multiple tenants. Use a naming convention that works for your business.

Examples

A mid-sized consulting company named Stratus Partners has a single Calabrio ONE tenant. Their default tenant name is stratus-partners.calabrio.one. A high-level decision maker at Status Partners submits a support ticket. Support changes the subdomain name to stratus.calabrio.one.

A large retail company named Trendora has multiple tenants for different regions, products, audiences, and functions.

The table below details the changes Trendora requested to their subdomains.

Characteristic Default subdomain New subdomain
Trendora's internal team based at their headquarters trendora.calabrio.one No change
Trendora's UK-based sales team eng-trendora.calabrio.one uk-trendora.calabrio.one
Trendora's vendor relations team external-service-trendora.calabrio.one vendor-trendora.calabrio.one
Trendora's Spanish support team spanish-trendora.calabrio.one esp-trendora.calabrio.one

Reserved subdomains

Names trademarked by Calabrio, other organizations, or individuals are not allowed.

Core infrastructure and systems

  • www
  • admin
  • root
  • system
  • config
  • setup
  • console
  • control
  • internal

Networking and routing

  • gateway
  • proxy
  • edge
  • router
  • cdn
  • assets

APIs and developer tools

  • api
  • dev
  • developer
  • docs
  • doc
  • openapi
  • swagger
  • graphql
  • sandbox
  • cli
  • sdk
  • test
  • testing
  • staging
  • debug
  • mock
  • webhook
  • events
  • integration

Product and application areas

  • portal
  • dashboard
  • home
  • insights
  • coaching
  • analytics
  • reporting
  • reports
  • performance
  • management
  • manage
  • wfm
  • qm
  • recording
  • ivr
  • bot
  • chat
  • voice
  • survey
  • training
  • data
  • billing
  • subscriptions

Authentication and identity

  • login
  • logout
  • auth
  • oauth
  • sso
  • identity
  • accounts
  • user
  • users
  • session

Support and help

  • help
  • support
  • status
  • health
  • faq
  • knowledge
  • incident

Environment labels

  • prod
  • production
  • uat
  • qa
  • dev
  • stage

Security and monitoring

  • security
  • monitor
  • metrics
  • telemetry
  • logging
  • logs
  • audit
  • alert
  • alerts

Reserved for Calabrio ONE

  • calabrio
  • demo
  • trial
  • preview
  • beta
  • alpha
  • earlyaccess
  • Names trademarked by Calabrio such as Calabrio One, Teleopti, Echo.ai, and more