Integration with CrewHu
This section describes how to set up CodeTwo Email Signatures for Office 365 to add CrewHu one-click surveys to your Microsoft 365 (Office 365) email signatures.
CrewHu is an employee recognition software, which allows measuring customer satisfaction (CSAT) with one-click surveys. The data is collected with each customer’s click and the results can be viewed in the CrewHu dashboard.
Inserting one-click surveys to email signatures added by CodeTwo Email Signatures for Office 365 provides many opportunities:
- simple design and lack of long surveys, which increases the customer response rate;
- rating buttons can be attached to each email, without any actions from users;
- get very accurate data on your customer satisfaction level and use it in an employee recognition software.
Creating new users in CrewHu
The first step is to populate your CrewHu account with users who will have CSAT surveys added to their email signatures.
- To add a new employee, log in to your CrewHu account. Then, use the left menu (Fig. 1.) to go to Settings > Employees.
Fig. 1. CrewHu navigation menu.
- On the Employees List (Fig. 2.) you can create new users. Click the Add button to start.
Fig. 2. CrewHu Employees List settings.
- The Add Employee view is displayed (Fig. 3.). Fill in the user’s details. The required fields are the user’s Name, Email and Profile (Admin, Manager or Employee). You need to pay extra attention to the Email field – CrewHu will send an activation link to the address you specify. Users will need this link to access their CrewHu profiles.
Fig. 3. Adding an employee in CrewHu.
- Each employee has their unique ID number generated. You can get respective users' ID numbers by choosing a particular user on the Employees List screen (Fig. 2.). User's ID is the value which shows in the browser's address bar, just after the last slash (Fig. 4.). Make sure you copy each user's ID, as it will be required in the further part of the integration process.
Fig. 4. Acquiring the CrewHu user's ID.
- Next, go to My Profile page (Fig.5.).
Fig. 5. Accessing the My Profile page.
- When you scroll down the My Profile page, you will see the email signature Snippet (Fig. 6.). Click View/Copy and then </> Source Code to preview your one-click survey in HTML.
Fig. 6. Email Signature Snippet.
- In this HTML source code view (Fig. 7.), copy the HTML code of the one-click survey by clicking Copy to Clipboard. Save this code (for example, to a notepad text file) because you will need to paste it later in the WYSIWYG email signature editor.
Fig. 7. HTML source code view.
Adding CrewHu IDs to a Microsoft 365 tenant
Next step is to add CrewHu IDs to the users in your Microsoft 365 tenant.
- Sign in to the Microsoft 365 admin center of your tenant.
- Click Active users in the left-hand menu, and then choose the user whose CrewHu ID you have (Fig. 8.).
Fig. 8. Accessing the list of active users in Microsoft 365 (Office 365).
- In the pane that opens, go to the Mail tab and click the Edit Exchange properties link (Fig. 9.).
Fig. 9. The Edit Exchange properties link.
- In the new window, click More options (Fig. 10.) and edit your user’s custom attributes.
Fig. 10. Accessing more options in the Edit User Mailbox window.
- Here, paste the User ID taken from your CrewHu account (see Fig. 4.) into one of the custom attribute fields, as shown in Fig. 11. Repeat this for all users – remember to always paste each ID into the same custom attribute field (the same number) for every user.
Fig. 11. Editing custom Exchange attributes.
Learn how to set Microsoft 365 custom attributes with PowerShell
Adding a Crew HU survey to an email signature
This section will show you how to create a new signature rule which will add CrewHu one-click surveys to email signatures sent outside your company.
- Start with creating a new signature rule and naming it (Fig. 12.).
Fig. 12. Adding a new signature rule.
- Then go to the Recipients step and select External recipients in the top list (Fig. 13.).
Fig. 13. Setting email direction to external only.
- Next, switch to the Design step and click Edit signature (Fig. 14.) to edit your signature template.
Fig. 14. Editing email signature template.
- In the opened signature editor, you will need to click the <> HTML snippet button (Fig. 15.) to insert your CrewHu one-click survey.
Fig. 15. Accessing the Insert HTML snippet window.
- Now, paste the HTML code copied from the CrewHu email snippet preview (see Fig. 7.). If you want the graphics to be embedded into the email signature, mark the checkbox at the bottom part of the window. Then, click Insert (Fig. 16.).
Fig. 16. The Insert HTML snippet window.
- Back in the editor, click the </> HTML source button (Fig. 17.) to access the HTML source code view.
Fig. 17. Accessing the HTML source code view.
- In the window, find the user’s id value (Fig. 18.). The value can be found between users_ids= and & phrases.
Fig. 18. User's ID value found in the HTML source code editor.
- Using the placeholder picker (Fig. 19.), replace the values found in the previous step with the custom Exchange attribute you have defined earlier (see Fig. 11.). For example, if you have chosen Custom Attribute 1, replace the user’s id with {CustomAttribute1}. When you substitute all user's ID values with the correct placeholder, save the changes and exit the HTML source code view window.
Fig. 19. Adding the custom Exchange attribute using the placeholder picker.
- For the last step, you can surround the survey with the Remove Text ({rt}) tags (Fig. 20.). This way, only users who have user IDs will get one-click surveys in their email signatures.
Fig. 20. Adding Remove Text tags.
- A basic one-click survey looks as shown in Fig. 21. You can modify it by changing fonts and images so that it fits your design and visual identity.
Fig. 21. A sample signature with a one-click survey.
- CrewHu dashboard lets you track your CSAT survey results in real time (Fig. 22.):