Question 1

Can I set Workflow values in a URL?

Accepted Answer

A very powerful feature of Malcolm! is the ability to populate one or more values within a Workflow via the URL to the Workflow itself.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/4pDguyLGuN/Set%20Workflow%20Values%20via%20URL.png (Set Workflow Values via URL)

This is extremely powerful if - for example - you want to pass into a Workflow information that lets you identify who has completed it - such as a customer ID or perhaps some other form of unique reference that lets you know what the information relates to (eg an order or transaction id)

For example, let's say a customer has created an order with order ID 12345 and you need some further information to fulfil the order. Rather than send them a Workflow which asks them for their order ID as one of the questions (or relies on you manually linking the submitted Workflow with a completed order your side) you could send them a link in the format https://url.com/workflows/order-info-needed?orderid=12345

You can put values for multiple fields in the URL too eg https://url.com/workflows/order-info-needed?orderid=12345&anotherfield=abcde

You can choose whether the user filling in the Workflow will see the Order ID repeated on their Workflow or not. If they can see it you can choose whether they can edit it or not. You can also choose what the descriptors in the URL (in the example above the "orderid" part) actually are. All these configurations are made by clicking on the individual element in the Workflow builder in MyMalcolm and scrolling to the "Settings" area.

When the Workflow is submitted you will receive the Order ID (and any other fields you have completed via the URL) as part of the submitted information.

When you combine the ability to populate fields by variables in the URL with the integration functionality of Malcolm! it becomes even more powerful as you could programmatically send out Workflows for completion (with some identifying information inserted via an auto generated URL) and then combine them with your other systems on submission via an integration or a webhook using the identifying information to link things together.

This becomes a great way to send out surveys, create follow ups to marketing campaigns, extend the functionality you offer to "logged in" users etc etc - the possibilities are endless!

Question 2

How do I change the colour of my links?

Accepted Answer

You can change the colour of your links via your theme. Themes live in the Brand section of MyMalcolm.

In your main theme settings you'll see link colour options under Primary, Secondary, Tertiary and Body.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/PapJB2lyc6/Screenshot%202021-02-23%20at%2011.22.50.png (Link colour management in Themes)

In embed themes, the link colour is managed from the other colours section.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Ox2zsXtjRW/Screenshot%202021-02-23%20at%2011.23.15.png (Link colour management in Embed Themes)

In Workflow themes, the link colour defaults to the colour selected in the main theme but can be overridden.

Question 3

How do I delete feedback on an FAQ or Workflow?

Accepted Answer

Feedback collected via Malcolm! can only be seen by suitability authorised team members on your instance but there may be situations where you want to delete it, for example if it contains personally identifiable information and your organisation has a policy that you only want to store this for a certain period of time.

To delete feedback for an individual FAQ select the "Delete data" option in the Analyse section of the FAQ.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/IK3fsFzNON/Delete%20FAQ%20Data%20in%20MyMalcolm.png (Delete FAQ Data in MyMalcolm)

To delete feedback for an individual Workflow select the "Delete data" option in the Analyse section of the Workflow and then select either "Delete feedback data" or "Delete all data" (which will also delete all your completion data)

Question 4

Can I enable reCAPTCHA on my Workflows or FAQs?

Accepted Answer

We now support using Google reCAPTCHA on your Workflows and FAQs/Articles.

When enabled, this will offer protection against spam completions of your Workflows and (if you are using them) the submit feedback and send FAQ/Article by email functionality within Malcolm!

You can find out more about Google reCAPTCHA here.

We support:

reCAPTCHA v3
reCAPTCHA v2 - Invisible
reCAPTCHA v2 - Tickbox

You can enable and configure reCAPTCHA for Workflows and/or FAQs independently. So, for example, you could enable reCAPTCHA protection for Workflows but not FAQs. You could also use a different version of reCAPTCHA for Workflows and FAQs.

You can turn reCAPTCHA on via:

Settings --> FAQs --> reCAPTCHA
Settings --> Workflows --> re CAPTCHA

Start by registering your instance with Google which you can do here.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/xynNm0rZqV/screenshot-my.malcolm.app-2023.04.16-22_02_50.png (Setting up reCAPTCHA in MyMalcolm)

Our dialog will show you the information you need to add to Google's interface. You can then paste the credentials you receive back from Google into MyMalcolm.

When enabled, ReCAPTCHA will work across all formats (ie content on your hosted hub, widgets, overlays and embeds).

Question 5

What is MyMalcolm?

Accepted Answer

MyMalcolm is comprehensive control panel area of Malcolm! where you can manage your instances. It is accessed at https://my.malcolm.app.

Question 6

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 7

How is the removal of Company Personal Data handled?

Accepted Answer

What is personal data?

Personal data only includes information relating to natural persons who:

can be identified or who are identifiable, directly from the information in question; or
who can be indirectly identified from that information in combination with other information.

What is Company Personal Data?

When you use Malcolm! to collect information from your customers, suppliers, staff or others that information may include personal data. In this context, Malcolm! acts as your data processor and the personal data we may process on your behalf is referred to as Company Personal Data. You can read more about this here.

Removal of Company Personal Data

There are two tiers of data removal. The first is a recoverable delete, known also as a soft delete. The second is a permanent delete or purge. Malcolm! supports both types of data deletion.

Soft deletion

Soft deletion means data is deleted enough to make it no longer visible or discoverable but not quite enough should it need to be recovered.

For example if you delete a Malcolm! Workflow in MyMalcolm then the Workflow and everything related to that Workflow is soft deleted. This means it'll all disappear from MyMalcolm and our APIs but should you realise the deletion was a mistake it could still be fully recovered (on request).

Purging

Purging is a permanent or secure delete. This could be either a physical delete (e.g. uploaded files on disk) or a nullification of stored values in a database. Once data has been purged it is no longer recoverable.

Rest assured, Malcolm! will never purge your data whilst your Instance is active!

What happens after my trial finishes?

After your 14 day trial period comes to an end your Instance will be disabled. From that point you'll have 30 days to subscribe to one of the plans. If no subscription is in place by then your Instance data will be soft deleted and after 120 days all Company Personal Data will be purged in accordance with our Data Processing Addendum.

What happens if my subscription lapses?

Subscriptions could lapse for a number of reasons but the most likely cause is an expired credit card. We'll keep you Instance active for 14 days to give you time to fix the problem.

If the problem is not fixed your Instance will be disabled but you'll still have a further 30 days to subscribe to a new plan should you wish to. If no subscription is in place by then your Instance data will be soft deleted and after 120 days all Company Personal Data will be purged in accordance with our Data Processing Addendum.

What happens after I delete my Instance?

You can request to have your Instance deleted and purged in Settings > Instance > Delete Instance. After 30 minutes of requesting the deletion your Instance data will be soft deleted and after 120 days all Company Personal Data will be purged in accordance with our Data Processing Addendum.

Can I request just a Workflow data delete and purge?

Yes you can! Within MyMalcolm you can create a Workflow data deletion request. The Workflow data will be first be soft deleted and then 30 days later it will be purged.

See How do I delete data submitted to a Workflow? for more information.

For more information...

For more information please read the Data Processing Addendum.

Question 8

Can I change the "email this answer" description in FAQs?

Accepted Answer

You can change the text label next to the email an FAQ feature on an indiviual FAQ. This can be useful if you are using the FAQ part of Malcolm! to publish articles or other types of content rather than just answers to questions and the "email this answer" language no longer makes sense.

To update the text go to the Brand section in MyMalcolm, then Themes, then click the edit icon in the relevant theme then select "FAQs" in the left hand nav.

Question 9

Can I put videos in my FAQs?

Accepted Answer

Yes, the best way to do this is via an external host like YouTube or Vimeo. Find out more here.

Question 10

How are Related FAQs determined and can I change this?

Accepted Answer

Related FAQs are auto-generated and by default are FAQs either in the same category or similarly tagged (we combine this pool of FAQs). We take the top 4 results from that pool, based on the sort order defined in the instance. For info on how to change the default sort order see this FAQ.

You can choose to force the Related FAQs to use tags or just the category by updating the setting in MyMalcolm / Settings / FAQs:

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/mNimQ1t2R3/Screenshot%202020-03-30%2021.19.11.png (Settings in MyMalcolm)

In this scenario we will then take the top 4 results from just the category or tag pool using the defined sort order.