Question 1

How do I create a Frequently Asked Question (FAQ)?

Accepted Answer

Within MyMalcolm go the FAQ Section and click "Create a FAQ" towards to the top right of the screen.

This will bring up the "compose your question and answer" dialogue. Here you can input the question, an optional brief summary answer (used in search and browse results) and your full answer. For tips on how to write a good FAQ click here.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/FrnZFuskaf/screenshot-my.malcolm.app-2019.07.29-21_44_58.png (Compose FAQ in MyMalcolm)

When composing your FAQ you can use the formating controls in the "full answer" box or directly enter Markdown. Markdown is a great way of quickly adding formatting to textual content. If you've not used it before it can take a minute or two to get used to it but it's very fast to work with once you have got the hang of it. You can click the "Need help with Markdown?" button bottom left anytime for a quick reference Markdown guide.

You can see what your FAQ will look like to your users by pressing the "Preview" button top right. When you have written your content press "Next: Configure" to move onto the configuration options for your FAQ.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/vDpsP666Gj/screenshot-my.malcolm.app-2019.07.29-22_20_03.png (Configure FAQ in MyMalcolm)

In this area you can control various things about your FAQ such as whether an author is shown, what the URL is, your choice of tags, whether the feedback form is enabled and the category or categories the FAQ lives in. You also have various options around whether the FAQ can be seen by search engines, is password protected or not and can be found or not via the Malcolm! search/browse capability. You can even set the FAQ (or versions of it) to publish and un-publish automatically at certain dates and time in the future.

Watch a video guide to creating an FAQ below.

Question 2

How do I change my rating elements from percentages (%) to stars?

Accepted Answer

In addition to the default "Did this help you? Yes/No" percentages style of rating you can now alternatively switch to a star rating system where your users can rate content from 1 to 5 stars.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/13xLIdBegJ/screenshot-homelender.malcolm.support-2021.01.15-16_19_22-2.png (Star ratings in Malcolm!)

The system used is set in the Settings section of MyMalcolm under FAQ or Workflows - look for the "Feedback ratings" area. You can switch between the two methods of rating whenever you wish and you can also use different rating systems for FAQs and Workflows.

Because rating content 1 to 5 stars is a bit more linear than a simple yes/no in response to "Did this help you?" we apply some logic behind the scenes when switching between rating styles. A "Did this help you? - No" is equivilent to 2 stars and a "Did this help you? - Yes" is equivilent to 5 stars, which slightly upweights positive feedback.

Don't forget you can change the colours of your rating elements too. See here for more details on how to do this.

Question 3

Can I collect the email address of a user when they leave feedback on an FAQ or Workflow?

Accepted Answer

It can be very useful to offer the ability for a user to leave their email when giving feedback on an FAQ or Workflows so you can follow up with them.

You can turn this feature on for FAQ's and/or Workflows via Settings --> FAQ --> General or Settings --> Workflow --> General respectively.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Z202OQgYA3/Screenshot%202021-03-11%20at%2008.25.02.png (Leave Feedback email address option in MyMalcolm)

You can enable it for all feedback or just for negative feedback. The default wording shown to the user is "If you'd like a follow up to this comment please leave your email address" but you can change this wording via the language file - see here for more details.

If the user has left an email address, there will be a "click to email" icon displayed next to the feedback in MyMalcolm.

If you'd prefer a user to complete a Workflow when they rate content see this FAQ.

Question 4

Can I link to a Workflow when a user rates content?

Accepted Answer

When a user rates your FAQ or Workflow you may wish to link to a Workflow from the rating area to collect more detailed, specific information. That Workflow could in turn pass data to your other systems (eg ticketing systems or CRM) via an Integration or Webhook.

This feature can be used in combination with, or as an alternative to, the feedback comments feature.

You can enable this functionality for FAQs and/or Workflows via Settings --> FAQ --> General or Settings --> Workflow --> General respectively.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/VMGzMXACpu/Screenshot%202021-03-11%20at%2008.25.31.png (Post feedback Workflow configuration in MyMalcolm)

Here you can choose the Workflow linked to when the user gives feedback.

The default copy for the link text is "Submit additional feedback" but you can change that via the language file - details on how to do this here.

If you are going to enable this feature it may make sense to turn feedback comments off so all comments are captured in your Workflow. We also recommend you turn off the feedback on the individual Workflow you use for the post Workflow feedback (via the configure tag of the individual Workflow in question). This will avoid the user being asked for feedback on the feedback!

Question 5

How can I use Stripe with Malcolm! to collect payment from my customers?

Accepted Answer

Malcolm! now integrates with Stripe. Stripe is a payment service provider that enables business owners to collect payment from their customers.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/UDbFKeLChy/stripe%402x.png (Stripe and Malcolm!)

With our Stripe integration you can create Workflows in Malcolm! that include fields for your customers to enter their card details and pay for things like products, services, memberships etc or perhaps make a donation towards something.

Here is how to set things up:

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/aioqQzmd4C/screenshot-connect.stripe.com-2021.05.28-17_36_24.png (Connecting Stripe to Malcolm!)

Once you have linked your Stripe account you can create Workflows via the Workflow section as usual and place payment related elements onto those Workflows. Two particular elements to pay attention to are Currency and Payments

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/SlnkSg4slf/screenshot-my.malcolm.app-2021.05.28-18_08_18.png (Currency and Payment elements in MyMalcolm)

Payments is the element where your customer will provider their card details. You can configure the amount your customer is charged via the Payment element settings, or you can optionally ask the customer to enter their own amount via the Currency field - this can be useful in scenarios like donations or account payments where you may wish to offer the customer the choice of the amount to pay.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/tJtuV3NgUY/screenshot-my.malcolm.app-2021.05.28-18_12_35.png (Settings for the Payment element in MyMalcolm)

If you also collect your customers email (and Name) in the Workflow you can optionally use that information to send them a payment confirmation email. You can configre and customise this via the Payment element settings.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/sZjKbFViLz/screenshot-my.malcolm.app-2021.05.28-18_11_48.png (Configuring payment confirmation emails in MyMalcolm)

You can place the Payment element on any page of your Workflow, but the actual payment transaction will not be attempted until the final submit of your Workflow. If there is a problem with the payment details your customer will be returned to the page with Payment element on it and given a chance to update their details and proceed back through the Workflow.

You can see a video walkthrough below.

And there you have it! Taking payments via Stripe is a really powerful and quick to implement feature of Malcolm! Workflows. Taking payments will also work when the Workflow is surfaced via our embeds, widgets and overlays too! If you have questions or need a hand setting things up just contact us and we'll be happy to help.

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

How do I use your Wordpress plugin?

Accepted Answer

First download the Malcolm! Wordpress Plugin here.

In MyMalcolm! create your embeds as normal - instructions here.

At the end of the Embed creation process when your embed code is generated there is some text which says "Embedding in a Wordpress site?" - if you click that text you will be shown your instance ID and for some embed types you will be shown a shortcode. There is also an option to have this information emailed to you.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Lglywov3F9/Screenshot%202020-05-24%2022.00.27.png (Embedding in a Wordpress site?)

In Wordpress, install the Malcolm! plugin then goto Settings --> Malcolm! and add your instance ID. Currently on some versions of Wordpress when you add the instance ID and press Save there is no acknowledgement of this but you can verify the instance ID has indeed been saved by navigating away and then back to Settings --> Malcolm!

You can see your instance ID in your URL when you are in MyMalcolm eg, https://my.malcolm.app/instances/XXXXXXXXXX/dashboard. The instance ID is the 10 digit code code shown where the X's are above.

For Widget and Full page embeds this is all you have to do - you can then configure on which pages your embeds appear via MyMalcolm (via the URL rules section of the respective embed).

For inline embeds and overlays you need to position where you would like the embed or the overlay launcher in your content. You do this using the Shortcode. Go to the page or post in Wordpress, make sure you are in code editor (not visual editor) and put the Shortcode where you wish the embed to appear / or the overlay be launched from.

If you have any issues with you embeds not appearing first check these things.

Question 8

Do I need to pay VAT?

Accepted Answer

Value Added Tax (VAT) is the sales tax in the United Kingdom where Malcolm! trades from. The current UK VAT rate is 20%. Our pricing is quoted excluding VAT.

The UK is no longer a member of the European Union (EU) however the VAT rules around UK companies trading with EU based businesses and EU based individuals continue to apply.

Whether VAT is applicable to your purchase of Malcolm! and how we apply it can be summarised as follows:

If you are a UK customer (individual or business): we charge VAT at 20%
If you are an EU Business and supply a valid VAT number (we check it): we will not charge you any VAT
If you are an individual in the EU: we will charge you VAT at your local country VAT - details here (PDF)
If you are a company or an individual not in the UK or in the EU (eg you are in the USA or Australia): we will not charge you any VAT

Question 9

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 10

Can I remove the Malcolm! branding?

Accepted Answer

It is quick and easy to remove the Malcolm! branding and - if you want - replace it with your own. Here is how:

Hosted Hub

By default your Hosted Hub is Malcolm! branded. To change that:

In MyMalcolm go to the Brand section.
Click "Themes" on the black sub navigation.
The default Malcolm! theme will be selected. Click the "duplicate" icon (two squares overlapping). This will create a copy of the default theme called "Default copy".
Select the Default copy theme by clicking on it. Then click the "edit" icon (a pencil).
This brings up the edit theme interface. There are a huge amount of things you can change here. Use the left hand vertical navigation to browse all the possibilities.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/6ACEG5RrGl/screenshot-my.malcolm.app-2019.08.05-10_46_38.png (MyMalcolm Theme Editing Options)

Footer

Be default a "powered by Malcolm!" badge appears at the bottom of content. You can turn this off (and also add other footer content such as copyright notices etc) in the "Footer" section of the edit theme interface referenced above.

Embeds

You can turn off the "powered by Malcolm!" badge in your embeds by turning off the footer. You do this via the style section of your embed configuration.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/m6Pb8R7IbC/screenshot-my.malcolm.app-2020.05.26-11_42_48.png (Style controls in an Embed in MyMalcolm)

Emails

Malcolm! can send emails to your customers/users in the following situations:

Email this answer functionality on an FAQ
Sending the resume later Workflow link
Payment confirmation email

To change the branding of these emails see this article.

To change the sender name and email address see this article.

Domain

Finally don't forget you can easily configure Malcolm! to use your own domain or sub-domain. For further details see this article.