Skip to content

Knowledge Base

Knowledge Base

Adding a New User

Create a new user for sending messages and viewing reports.

This guide covers creating a new user and editing an existing user. Depending on configuration settings, users can send messages via the Dashboard, email tools (Email-to-SMS), and APIs.

 

Creating a New User

  1. Log into the Web Dashboard at my.bestsms.au
  2. Select [Users] from the menu.
  3. Click [Create] to add a new user.
  4. Enter the [User Email Address]:
    • Insert the user’s email address.
  5. Configure SubAccount, Department, etc., as necessary (see the information below for explanations).
  6. If the user requires a dashboard login, click the [Dashboard] tab.
  7. Click [Save].

user-configuration

 

Granting an Existing User Access to the Dashboard

  1. Log into the Web Dashboard at my.bestsms.au.
  2. Select [Users] from the menu.
  3. Click on the User in the list.
  4. Click [Edit/Modify].
  5. Click the [Dashboard] tab.
  6. Configure as necessary (see the bullet points below for explanations).
  7. Click [Update].

 

Enabling API Access for an Existing User

Refer to the Managing API Users guide for API-user specific settings.

Note: Enabling API access will disable Email-to-SMS for the user.

  1. Log into the Web Dashboard at my.bestsms.au.
  2. Select [Users] from the menu.
  3. Click on the User in the list.
  4. Click [Edit/Modify].
  5. Click the [API] tab.
  6. Configure as necessary (see the information below for explanations).
  7. Click [Update].

 

Configuration Options

Main Tab:

  • Friendly Name: Optional friendly name.
  • User Email Address: Email address to be authorised for sending messages. Can be listed in [email protected] format, or for wildcard domain access, set this to the domain name, e.g., domain.com.
  • User Status: Setting a user to 'Inactive' will disable their ability to send messages.
  • Domain Account: If you wish to allow all users at a particular domain to use the service, toggle this to 'Yes' and ensure the 'User Email Address' field specifies a domain, e.g., domain.com.
  • Enable Dashboard Access: Toggles dashboard access on/off.
  • Enable API: Toggles API access on/off.

 

General Tab:

  • SubAccount: Used for billing, reporting and privilege purposes.
  • Department: Used for billing, reporting and privilege purposes.
  • Origin Code: Defines the user’s local area code so that the system can interpret their number formatting.
  • Timezone: The user’s local timezone (specified in reporting).

 

Dashboard Tab:

  • Login Level: The rights of this login (see the Login Level Explanation section below).
  • Default Page: When logging in, this page is displayed first.
  • Send Welcome Email: Sends an email notification to the new user with their dashboard login credentials.
  • New Password: Sets a new password for the login user.

 

API Tab:

  • Sender: The API 'Sender' value.
  • API Key: The API 'APIKEY' value.
  • Auth Token: JWT Web token generated if you decide to use Auth Tokens for Rest API.
  • Webhook Callback URL: Default URL to receive webhooks (contact the team to enable webhooks).
  • Webhook Callback Format: Default formatting of webhooks.
  • X Report Method: Sets the reporting method for each message type.

 

SMS Tab:

  • SMS Reply Email: Hardcode SMS Replies to be emailed to this email address.
  • SMS Send Updates: If the SMS RESULT code is updated after delivery, send the user an update (e.g., where initially the delivery is 'delivered-to-network' and is later updated to 'delivered').
  • SMS Parts Length: The number of message-parts able to be sent per SMS message (default is 1, equalling 160 GSM characters).
  • SMS Merge Subject: For Email-to-SMS users, this field merges both the Subject and Email Body into the message.
  • SMS Template: Setting this to 'Yes' wraps the user’s SMS messages with the below Header and Footer.
  • SMS Header: Sets the 'SMS Header' when SMS Template=Yes.
  • SMS Footer: Sets the 'SMS Footer' when SMS Template=Yes.
  • Custom Template: Sets the user’s default Custom Page (when using the [[CustomPage]] command).
  • SMS Report Method: Sets the reporting method for SMS Success and SMS Failed notifications.
  • SMS Reply Report Method: Sets the reporting method for SMS Reply notifications.

 

Login Level Explanation

  • Account: Admin level login - can view and edit all users, messages, contacts.
  • SubAccount: Second tier login - can view and edit information owned by their SubAccount and levels below.
  • Department: Third tier login - can view and edit information owned by their Department and associated users.
  • End User: Lowest tier login - can view and edit information owned by their login only.