Workspaces

A Brand Mobiliser workspace is a logical grouping of applications, users, and other artifacts. When you install Brand Mobiliser, the default workspace, which you can use for development, is created automatically.

Brand Mobiliser workspaces meet both development and deployment needs. In the development environment, a workspace provides the logical grouping of users who are collaborating on projects or tasks. A workspace can also be used for partitioning development, QA, and production environments.

After you create a workspace, you can assign users to it. You can assign a user to more than one workspace. The default installation of the platform has a predefined workspace called default and a user called admin, who is assigned to the default workspace. The admin user has the SUPER_ADMIN role, and is the platform administrator.

Warning! Do not delete the default workspace or the admin user.

In a deployment environment, you must configure a workspace with at least one unique short or long code. Short codes are special telephone numbers, significantly shorter than full telephone numbers, which you can use to address SMS and MMS messages from some mobile phones and fixed phones, and are limited to national borders. Long codes are longer numbers that you can use for international calls. The processing engine uses unique short codes or long codes to dispatch incoming messages to a corresponding workspace. In the remainder of this topic, code refers to either a short code or a long code.

You can assign more than one code to a workspace, but you cannot use a code in multiple workspaces. If there is more than one code assigned to a workspace, the processing engine uses the code flags, Default and Use for Reply, to determine which code to assign to the Origination MSISDN property in responses (outbound messages). As an example, a workspace has short codes: A, B, and C. When an inbound message is sent to any of these short codes, the processing engine sets the value of the Origination MSISDN property in the response, based on the status of the short code's flags. Mobile operators require Origination MSISDN values.

Short Code	Selected Short-Code Flag	Value Assigned to Origination MSISDN in Responses	Reason for Origination MSISDN Value
A	Default	A	A is the default short code.
B	Use for Reply	B	The Use for Reply flag is selected.
C	None	A	The Use for Reply flag is not selected, so the system selects the default short code.

Each workspace can have only one outbound channel connection. Inbound channels are not workspace specific. An incoming message from any channel is evaluated and routed to its corresponding workspace, based on the destination short or long code in the message.

For best results:

Do not assign any users to the default workspace. Preserve the initial setup of the workspace (assigned to the admin user). Treat the default workspace as a guest workspace, so when users are inadvertently assigned to it, no damage is done.
Do not assign any short codes to the default workspace, because short codes cannot be reused across workspaces.
To prevent unintended traffic flow, do not set up any channels on the default workspace.

Creating Workspaces
A workspace is a logical grouping of applications, users, and, other artifacts. In addition to a unique name, a workspace also has a unique short or long code.
Opening Workspaces
Workspace administrators can assign Brand Mobiliser Web UI (Brand UI) users to multiple workspaces, and users can open their workspaces individually. After logging in to the Brand UI, one of your workspaces opens. The name of the current workspace appears on the Login Status Bar.
Default Menu
A Brand Mobiliser default menu responds to keywords that are sent to a workspace but not assigned to an application. Each workspace must have a default menu. Typically, the workspace administrator sets up the default menu.
Configuring Default Menus
Set up and activate a default menu for each workspace. When a consumer selects an option in the default menu, the associated application starts.
Deleting Workspaces
Before you delete a workspace, remove all applications running in the workspace and unassign all users from the workspace.