Question 1

Can I change the terminology/rename FAQs and/or Workflows?

Accepted Answer

Within Malcolm! you can choose the title of your FAQs and Workflows, but you may want to use Malcolm! in a way where the terminology "FAQs" and "Workflows" doesn't make sense. For example you might want to rename FAQs "Policies" or "Help Articles". You might want to rename Workflows "Requests" or "Tasks".

This is no problem - you can rename both things in the Brand section of MyMalcolm.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/QlfRt4MTdW/screenshot-my.malcolm.app-2019.08.06-17_22_37.png (Renaming FAQs in MyMalcolm)

Edit your chosen theme, then navigate to the "FAQ" and "Workflow" section in the vertical side navigation.

MyMalcolm will still refer to FAQs and Workflows but any references your users see will be updated to the value you set above.

Question 2

How do I set up my Hosted Hub?

Accepted Answer

Every instance of Malcolm! comes complete with a Hosted Hub that you can configure and customise.

You can find out more about the Hosted Hub here and if you want to turn if off you can find out how to do that here.

In MyMalcolm if you click "View Live" towards the top the screen you'll see what your Hosted Hub currently looks like.

The two things you are probably most likely to want to change are the URL the Hub is on and the Hub's look, feel and content. Here is how to configure each of those areas.

1. Configure the URL

In MyMalcolm, go to the Settings section, then select "Custom Domains" from the vertical left hand menu. In this area you can change the URL your Hosted Hub will use. It's possible (and no extra charge) to use your own external domain or sub-domain.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/VKQ7z1JBXW/screenshot-my.malcolm.app-2019.08.12-17_01_54.png (Customise your domains in MyMalcolm)

2. Change your Hub's look, feel and content

You can extensively customise your Hosted Hub to suit your own requirements. To do this, go to the Brand section of MyMalcolm, clone an existing theme, then choose the edit icon on your cloned theme.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/cO3r3O1RbL/screenshot-my.malcolm.app-2019.08.12-17_03_00.png (Theme management in MyMalcolm)

In the edit theme area use the left hand vertical navigation to see all the custom options you have.

Question 3

How can I password-protect my hub with Memberstack?

Accepted Answer

Malcolm supports using Memberstack to password-protect your content.

This guide will help you set up Memberstack.

First go to MyMalcolm > Settings > Instance > Visibility and toggle the option to use a third party service for Hosted Hub password protection. This automatically enables the built-in password protection.

Activating third party Single Sign On (SSO)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/M5riHygBgk/screenshot-my.malcolm.app-2022.10.03-05_58_09.png (Choose Memberstack from the dropdown)

Next, from the Memberstack Dashboard, go to Dev Tools > Add Integration.

Add a new custom SSO Integration

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/9pIEqPe6kK/Screenshot%202022-10-03%20at%2007.00.53.png (Add a new custom SSO Integration)

Copy the Redirect URI from MyMalcolm and paste it into Memberstack.

Redirect URI in MyMalcolm

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/IHbM8Ppu1v/screenshot-my.malcolm.app-2022.10.03-05_58_32.png (Cut and paste this into Memberstack)

Then, in Memberstack, press Add Integration.

Once created, in Memberstack click the Edit button next to the Integration and copy the Client ID and Secret Key.

Your Custom SSO Integration

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/I1TfM7CL3a/Screenshot%202022-10-03%20at%2007.01.12.png (Obtaining the Client ID and Secret Key from Memberstack)

Paste these values into the boxes in MyMalcolm.

Client Credentials in MyMalcolm

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Oq33GMwLTG/screenshot-my.malcolm.app-2022.10.03-05_58_32%202.png (Add your credentials from Memberstack here)

Save the settings on both sides and you should see your Memberstack login page appear in your Hub.

Login to Hosted Hub

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/DkMgxR3Mti/Screenshot%202022-10-03%20at%2007.01.36.png (Hosted Hub login using Memberstack SSO)

Attributes from your Memberstack users can be pre-populated in Malcolm! Workflows. To enable this feature choose a suitable field on a Workflow, edit the field settings and enable "Allow a value to be set in the URL query". Enter one of the two attributes name or email to pre-populate those values directly into your Workflow.

Question 4

How do I delete data submitted to a Workflow?

Accepted Answer

You can delete some or all of the submitted data (including uploaded files) associated with a Workflow by selecting "Delete Data" in the Analyse tab of the relevant Workflow.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/tRaFrYJwoo/resources/lcSsh5w64C/Screenshot%202020-11-20%20at%2023.06.05.png (Delete Data dialogue in MyMalcolm)

You can choose to delete all data or selected data between two dates. Note that as well as removing data the delete process will also remove any exports you previously generated that contain the data plus any files uploaded via the Workflow and MyMalcolm activity logs. Please therefore export and download to your local system any data you wish to keep before starting the delete process in MyMalcolm.

Ratings, analytics and feedback associated with deleted Workflow completions will be kept and can still be reviewed via MyMalcolm post delete.

Question 5

How do I review the feedback on my FAQs or Workflows?

Accepted Answer

You can choose whether to allow your customers to feedback on your FAQs or Workflows. They can say whether the content was helpful or not and optionally leave comments.

This information is only seen by you and other team members on your instance - it isn't viewable by other customers.

The feedback feature can be very useful as your customers may highlight things that are confusing or information/items you have left out.

When feedback is left a notification will be created. You can see feedback across all content in the Feedback area within the FAQ or Workflow sections. You can also see feedback on an individual FAQ or Workflow when navigating to that FAQ or Workflow via the Library.

Question 6

What are Integrations?

Accepted Answer

Integrations are a way of passing data you collect in a Malcolm! Workflow into other third party software or systems.

We currently offer integrations with:

Plus over 1,500 over apps via Zapier (more info here) and Make (formerly Integromat) (more info here).

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/v5lAa3NjkY/zapier-fb%402x.png (Malcolm! Integrations)

Configuring Integrations

Once you have created your Workflow, go to the Configure section and select Integrations. There you can link your third party accounts at our integration partners to your Malcolm! Instance by providing your credentials. Once your accounts are linked you can configure integrations with that partner and choose the data from your Workflow that is passed across. You can configure whether data is passed on every Workflow completion or only when certain conditions are met. It is possible to have multiple integrations so, for example, you could create a form which collected details from a new customer including a copy of their ID. You could then subscribe that new customer to a Mailchimp mailing list and store their uploaded ID documents in your Dropbox account by creating two integrations.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/5KmZGb3Q9Q/screenshot-my.malcolm.app-2019.08.06-19_50_53.png (Integrations in MyMalcolm)

Customer Consent

A reminder that it is good practice - and in certain territories a legal requirement - to ensure that your customers actively consent to their data being passed to third party companies who, like Malcolm!, act as data processors on your behalf. You act as the data controller. Most companies handle this consent via provisions in their Privacy Policy which their customers agree to. It is good practice therefore to include a check box in your Workflows that reminds customers of your Privacy Policy and their continuing agreement of it.

Integration Failures

Sometimes integrations may fail. This could be for a variety of reasons, for example the integration partner's API's may be down and/or there may be a problem with your account at the third party provider (for example your Dropbox account may be over quota).

Firstly don't worry re losing customer data - Malcolm! will always store any user submitted data so if there is a problem with an integration

When a problem occurs we'll create a notification to let you know and periodically retry the integration. You can review the Integration logs and retry a failed integration event manually via MyMalcolm (navigate to the Workflow via Library then select Integration logs).

More Integrations coming soon!

We will be adding more and more integrations to Malcolm! in the coming months. If there is a particular integration you'd like us to add please let us know.

Question 7

Can I use two-factor (2FA) / multi-factor authentication (MFA) to secure my MyMalcolm account?

Accepted Answer

You can secure your MyMalcolm user account using two-factor authentication (2FA). To use this feature you will need a native MyMalcolm user account, that is you are not using Sign In with Google.

To turn 2FA on click the "Enable two-factor authentication" button in the Security tab of your profile. To access your profile click your name at the top of the screen where it says "Logged in as".

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/iermJcbNuB/screenshot-my.malcolm.app-2023.04.14-15_38_30.png (Enabling two-factor authentication in MyMalcolm)

You will then be shown a QR code you can scan in your choice of authenticator app. Alternatively there is also an option to be given a text code to enter into your authenticator app.

On the next screen, having added Malcolm! to your authenticator app, you will be asked to type in the current code. Once that code is accepted, as the final step of the process, you will be given some recovery codes which you should store safely and can be used to access your Malcolm! account if you are ever unable to use your authenticator app.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/6pXAu1iddP/screenshot-my.malcolm.app-2023.04.14-15_54_29.png (Recovery codes in MyMalcolm two-factor authentication setup)

Please note that if you lose access to your authenticator app and your recovery codes we will be unable to restore access to your account!

Question 8

How do I surface my Workflow into a floating widget?

Accepted Answer

It's quick and easy to surface your Workflow as a floating widget. You can find out more about Malcolm! widgets here.

In the Library screen of the Workflow section of MyMalcolm click the three dots on the right hand side of the screen and select "Embed" -

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/bk1dEegpoU/screenshot-my.malcolm.app-2019.08.18-17_01_27.png (Quick link to Embed from the Workflow Library in MyMalcolm)

This will take you into the Share section of MyMalcolm! Here you can choose the type of embed you want to create.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/N17DhjfW2Z/Screenshot%202021-12-30%20at%2013.57.57.png (Choose your embed type in MyMalcolm)

Choose "Widget" and work through the screens. You can configure various options here including whether in the pre-expand state the widget is a button or a drawer. You can also configure where on the screen you want the pre-expand to appear. Other options include colour schemes, the option to add your own logo to the widget and also whether you want the footer and search bar to appear. See this FAQ for more detail on this.

At the end of the process you will be supplied with the code that you should add to your webpage HTML - we recommend you add this to very page of your website. You can also embed via Google Tag Manager. See here for more details.

Question 9

Can users save Workflow progress and complete later?

Accepted Answer

It can be very useful to give your users the option to save progress on a Workflow and come back to complete the rest later. It's especially helpful if a you have built a long multi-stage Workflow like an application form.

You turn this feature on in MyMalcolm - go to the Configure screen of each individual Workflow.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/r3sEcA2Ugh/screenshot-my.malcolm.app-2019.08.18-16_09_11.png (Turn Resume Workflow on in MyMalcolm)

When turned on users will see an option to "Finish Later" at the bottom of each Workflow screen. When clicked this will bring up an overlay asking them to enter their email address. A unique link will then be emailed that when clicked will take the user back to the same stage of the Workflow they were previously at.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/R3FxUMpkNL/screenshot-support.malcolm.support-2019.08.18-16_41_46.png (Finish Later option on a Workflow)

If you need to retrieve these links (for example someone completing the form didn't receive or has lost the email with the resume link in) you can also get to the link via the Completions area of the Workflow section of MyMalcolm - click the link under "Resume link" to copy the URL your clipboard.

Question 10

Can I receive an email every time a new FAQ or Workflow is published?

Accepted Answer

Sometimes it can be useful to receive an email when a new FAQ or Workflow is published on your instance. This feature is turned off by default - to turn it on follow these steps.

From the MyMalcolm control panel area, click your name at the top of the screen where it says "Logged in as"

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/LgmiVqgthh/screenshot-my.malcolm.app-2020.01.16-10_57_39.png (MyMalcolm navigation bar)

You'll then be taken to your personal preferences. If you select the "Notifications" tab on the left you'll be able to edit the notifications you receive. Remember to hit "Save" once you are done!

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/FVf5EupLg4/screenshot-my.malcolm.app-2020.03.03-17_26_08.png (Your notification settings in MyMalcolm)

Note that your notifications are based on an instance. If you are a user on more than one instance you should first switch to the instance you wish to adjust notifications for. You can do this using the drop down selector at the top right of the screen. You can therefore have different notification preferences for different instances. The notification preferences you choose are personal to you and will not affect the notifications of other team members on an instance.