Groups
- Updated
Voxie’s Groups is the answer for those multi-location, multi-department organizations, it allows you to manage your Locations from a centralized control panel, determine strategies for your locations pushing them downstream with defined Audiences and Messages, as well as providing liberties to your locations to issue their own messaging strategies
Before we start, we recommend you to get familiarized with the terminology used fir groups.
Terminology
Concept | Description |
---|---|
Group | Represents a Location of a Franchise, or a Department or Phone Line within a multi-unit business. Contacts and Users can be affiliated with one or more Groups. Contacts can have a designated Preferred Group. Groups can send from a corporate phone number (e.g. Short Code) or an individual phone number unique to that Group. |
Corporate User | A user who has access to all Groups. Voxie users can impersonate Corporate users for full access. |
Group Custom Attribute | Custom fields that can be used for Segment filtering (e.g. filter for all Contacts affiliated with a Group that has a Group Custom Attribute of corporate_owned = Y) and as dynamic fields in a Message Body. |
Group Switcher | For Corporate users to switch between Groups, for multi-unit Franchisees to switch between locations. |
Group Collection | Corporate user functionality only. Create a ‘group of Groups’ by using filtering logic. Group Collections can be referenced when creating Segment Templates and Snippet Templates |
Segment Template | Corporate user functionality only. Create a Segment that is selectively shared with all/some Groups. Enables Corporate to tightly control which audiences can be reached be Groups. |
Preferred Group | A Contact can be affiliated with multiple Groups, but may only have one Preferred Group designation. Texts will be sent to the Contact from the Preferred Group phone number. |
Snippet | Templates are now called Snippets. A Snippet is a reusable piece of content, which can be used in places like Message Hub and Quick Blast |
Snippet Template | Corporate user functionality only. Create a Snippet that is selectively shared with all/some Groups. Enables Corporate to provide Groups with recommended Snippets. |
Concept overview & basic quotas
The overall idea behind the Groups Feature is to enable multi-location businesses to manage their Messaging strategy as flexible as they wish. In this section, we will explain all the variations supported by Voxie to fulfill those strategies for your own business layout.
Layout Understanding
Based on the Market Standards, most layouts consist on a Hub and Spoke model, where the Hub is usually identified as Corporate (Voxie Name), HQ or Marketing Department, whereas the Spokes are Locations, business divisions or departments which in Voxie we call them Groups.
Corporate Manages Strategies
Voxie Strategies Automation remain mostly at Corporate level, including Groups as potential recipients of this strategies.
Corporate can choose the desired strategy leveraging the common Voxie Flow Artifacts (Segments, Campaigns and Automations) adding new logic around the Groups that own the Contacts
Voxie provides a set of capabilities that allows Corporate to decide if the Messaging Strategy is going to be triggered from a centralized Brand action, or can create the Messages (Snippet Templates) and define Audiences, so each Group can decide to send those messages when they believe is best.
Furthermore on this subject, as Corporate you can define which Groups are going to be included or excluded of these actions, as well as, if only Groups Preferred Contacts should be part of the Message Strategy or all affiliates are eligible to do so.
Group Quotas
There are certain default limits around this feature, Voxie will be happy to understand your use cases and evaluate exceptions if needed:
Groups | The Max amount of Groups under a Single Account is 5,000 Groups |
Groups Custom Attributes | The Max amount of Custom Attributes per group is 20 |
Groups Contacts | The Max amount of Contacts per group is 50,000 |
Possible Configurations
Voxie allows you to set up your Account Phone strategy in following to variations:
- Each Group (Location) has it’s Phone Number, and therefore Message Hub will be Available in each location. Furthermore, Corporate can send centralized Mass Messaging throughout each individual phone number. In this scenario, is where “Preferred” Contacts are relevant, so Contacts don’t receive the same message issued by Corporate from different Sources
- Single Corporate Phone Number, usually a Shortcode to support throughput correctly, all locations can send their own Quick Blast throughout this Corporate phone Number. In this case Message Hub won’t be available for each location.
Send Messages throughout Individual Locations phones
- Each Group has a phone number, Corporate may as well
- Corporate Issues a Campaign, and decides that Messages will be sent through Individual Group’s Phone Numbers
Send Messages throughout Corporate phones
- Corporate has a single Phone Number
- The Campaign is meant to be a Brand level communication
- Corporate Issues a Campaign from to be sent from Corporate Phone Number
⚙️ When setting up the Voxie Account, the control needed to manage which Use Case you are going to operate under, is located in ⚙️ > Settings > Team Settings > Team Profile
|
Getting Started with Groups
Voxie will help you to set up your Account to leverage the full power of Groups, as a summary the following will need to happen:
- Create Account and Enable Groups
- Define the Phone Number Strategy and issue the needed phone numbers
- Single Shortcode
- A Single Phone Number per Group
- Port your Existing Phone numbers
- Get new ones and register them
- Depending on the Amount of Groups or locations your need, it can be done Manually or Programmatically, we recommend in case there are more than 20 Groups to create a .CSV file with the following information:
External ID
Group Name
-
Description
(Optional) -
Custom Attributes
(One Column per Custom Attribute Key)
- Assign Phone Numbers to your groups if Needed
- Invite Location Users to Voxie
- Once Accepted the Invite, add the Users to the according Groups with the Proper Roles
- You can also create a .CSV file with your users per Group:
- Group
External ID
User email
User First Name
User Last Name
-
User Role
Refer to theAdministrator
Marketer
Blast
Agent
- Group
Groups Lifecycle
Groups is a Feature you need your Voxie Customer Success Manager to enable, please contact support@voxiechat.com to ask for it or directly to your CSM, once enabled, you’ll be able to manage your groups from your Corporate Account
Create a Group
If you need to start creating Groups for your locations, only Owners and Administrator roles can manage lifecycle. You can go to your Settings > Team Settings > Groups, click on New Group
External ID
[Required]
In order to create a Group you’ll need to provide an ID, we call it External ID
, and we do it so, to replicate your Location or Department designation (ID), so you can have an Integrated match between your centralized management and Voxie.
In addition you’ll be able to use API Destinations to update your systems using this reference
Characters | External ID supports up to 40 characters |
Case Sensitivity | IDs are case sensitive |
Special Characters | No Special Characters Supported, only a-zA-Z0-9
|
Name
[Required]
The name will be the main way to identify Groups across the platform, therefore, we recommend you to make them as meaningful as possible for your operation.
Description
[Optional]
Open Text Field, useful to add Metadata around each group, it can be filled with data for disambiguation between similar Groups or described strategies for the given Group.
Characters | Description supports up to 2,000 charactersCustom Attributes |
[Optional]
Custom Attributes
Groups Custom Attributes are a Key feature that will enable you to personalize Messages leveraging this Group unique values, you can also use them in Automations.
Custom Attributes | Each Group supports up to 20 Custom Attributes |
Special Characters | Values support the following characters :.@#$%&'*(),!?-\\=_+[] /
|
Characters | Custom Attributes values can be up to 192 Characters |
Bulk Import of Groups: In case you need to import many Groups, we recommend you to contact your Success Customer Professional |
View, Update or Edit a Group
As a Corporate User you’ll be able to fully EDIT a Group Details with the only exception of the External ID
that cannot be modified.
Bare in mind, Phone Numbers
will appear only if you assigned them from Voxie Corporate section.
In case you are a Group Administrator you’ll only be able to modify Group’s Custom Attributes, any other needed modification please refer to Corporate Level Administrators
Delete a Group
If a group is deleted, then the contacts that have affiliation with the given Group will remain, unless is explicitly removed by a Corporate user in the Contact Edit section.
- Group assigned Phone Number will be released, and available in Corporate for future assignment
- Contacts will remain attached till corporate re-assign them
- Users will lose membership to the group and no-one will access it anymore
- After deletion, it goes back to the setup required state, so the
External ID
will be taken, if needed, the group can be enabled again.
Groups Navigation
Corporate Users perspective
As a Corporate User (Owner or Administrator Roles), you’ll be able to navigate throughout Groups as well as configure them.
Voxie presents a Group Picker in the upper right corner, in which you can:
- ALWAYS Understand where you are operating
- If you are in Corporate, overseeing all Group Instances, you’ll notice the selection will be 👑 Corporate.
- If you are within a Group the upper right pill will be showing the Group Name you are in.
- Navigate across Groups, you can search by
Group Name
orGroup External ID
- Also if needed, you can Manage your created Groups from Corporate space, going to ⚙️ > Settings > Team Settings > Groups, and click on Edit to:
- Edit Group Details
- Edit Users and Roles
- Understand to which Group Collections the Group Belongs to
- Manage Group Resources
- Contacts
- Segments
- Campaigns
- Snippets
💡 The rest of the Roles at Corporate Level won’t notice the or be able to manage groups, only Corporate Owner and Administrators can
Group Users perspective
Group User interaction with Voxie will depend on the assigned Role, Voxie presents 4 Group Level Roles with the following Scopes:
Permission | Description | Administrator | Marketer | Blast | Agent |
---|---|---|---|---|---|
1:1 Messaging | Communicate with individual contacts using the Voxie Message Hub | ✔ | ✔ | ✔ | ✔ |
Snippets | Create & utilize templated snippets to efficiently build messages | ✔ | ✔ | ✔ | ✔ |
Quick Blast | Reach your local audience with a streamlined campaign builder | ✔ | ✔ | ✔ | |
Segments | Build local audiences using customized filters | ✔ | ✔ | ||
Users | Manage user access scoped to your location | ✔ | |||
Group Custom Attributes | Manage location settings like address or hyperlinks to location-specific webpages for use in messages | ✔ |
💡 All complex Voxie Automations, Ad-Hoc Campaigns, All Contact List Segmentations, as well as Account Billing details or Integrations won’t be visible neither accessible by Group Members, unless they belong to Corporate
Contacts in Groups
Contacts will count with ⭐ Preferred Group Attribute that determines which Group is the “Owner” of the given Contact, this is very useful when your business needs to make a distinction between Customers and Leads, where Leads can belong to multiple Locations but Customer if they are under a Subscription will always belong to a single Group.
Some of the Behaviors you need to expect around Preferred Contacts and Affiliated
- A Contact can have only one Group as Preferred
- There can be up to 20 Affiliated Groups
- When Created a Segment or a Campaign, you can specify to Contact only Preferred Contacts or all of them
- When a Group is deleted, Preferred Group remains till Corporate Updates the relationship towards a New Group
- Contacts can be Orphan and have no Preferred Group, in that case Groups can Claim them through 1:1 communications.
- Groups cannot have 1:1 conversations with not Preferred Contacts
Group Details on A Contact View Screen, from Corporate
Contacts Affiliation
A very relevant concept that Groups introduces, is the Contact affiliation with Groups, the idea is to differentiate between those Groups that have a long term relationship with Contacts, because the line of business is based on a Subscription or similar, versus, Contacts that have a brand level interactions with individual Groups based on the locations.
For those Groups with Long term relationship with contacts, and they keep the interactions in a one to one fashion, we introduced the Preferred
Group attribute, each Contact can have a preferred Group from which it can receive Messages.
Once set, only Corporate can change the preference of Group - Contact relationship.
Additional Related Resources: