How do I override Messenger branding and configuration for a customer?

Stephen Boss Updated by Stephen Boss

Introduction

Sometimes there are scenarios where you need to deploy Messenger with settings that are specific to a customer. Not only is this possible with Thread, but it is also very easy to accomplish.

Thread uses an App ID as an identifier that is unique to each company.

  • Each partner is assigned an App ID, this App ID inherits the Messenger settings, design and hours defined at the parent level of your configuration, e.g. Admin Panel -> Messenger
  • All clients are also assigned App IDs, each company App ID inherits any Messenger settings, design and hours defined at the client level where an override is in effect, e.g. Admin Panel -> Clients -> Customer -> Settings/Design/Hours. If no override is set at the client-level, any instance of Messenger deployed with this App ID will inherit the settings, design and hours defined at the parent-level (partner-level).
    If no override is set at the client-level, any instance of Messenger deployed with this App ID will inherit the settings, design and hours defined at the parent-level (partner-level).

How to set client-level overrides

  1. Navigate to Admin Panel -> Clients
  2. Use the Magnifying Glass to search for the client you want to override the settings, design or hours for. Open that client.

How to override board, status and other settings

  1. From the client page in the Admin Panel, navigate to the Settings tab.
  2. Check Override parent settings.
  3. Change the applicable settings:
    1. Service Board - You can override what service board or service queue your service Chats flow to in your ticketing system.
    2. Sales Board - You can override what sales board or service queue your sales Chats flow to in your ticketing system.
    3. Reopen Service Status - You can override the reopened ticket status for your boards (this should be the same status on both Sales and Service boards).
    4. New Contacts - This setting can only be overridden at the client-level. It allows new contacts to open service chats. When Messenger is deployed under a client-level App ID and this override is set:
      1. Messenger will allow any user to authenticate with any email.
      2. Thread will create a contact under the company.
      3. Messenger will allow the contact to raise a service chat.
    5. Proactive Messages - Checking this will disable proactive messages being sent. These are messages through the Teams and Slack bots designed to bring end users back into the chat even if they have abandoned the chat.
  4. When done, click Save.

How to override design

Overriding design will allow you to define a custom messenger design unique to that client.

  1. From the client page in the Admin Panel, navigate to the Design tab.
  2. Check Override parent settings.
  3. Change the applicable design configuration.
  4. When done, click Save.

How to override hours

Overriding hours will allow you to set custom hours for a clint where Messenger will be available to accept live chats.

  1. From the client page in the Admin Panel, navigate to the Hours tab.
  2. Check Override parent settings.
  3. Change the applicable hours configuration and Custom Message.
  4. When done, click Save.

How to get the Client App ID and Deploy

The client's App ID can be found in the Admin Panel on the Client page under the installation tab.

  1. Navigate to Admin Panel -> Clients
  2. Use the Magnifying Glass to search for the client you want to override the settings, design or hours for. Open that client.
  3. From the client page in the Admin Panel, navigate to the Installation tab.
  4. Copy the App ID, you will use this for your deployment.
  5. Follow the deploying messenger guide to deploy to the customer using this App ID.

How did we do?

Messenger Internationalization (English & French)

Contact