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

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.

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.