Question 1

Can I change the reply-to email address of an email answer alert to be the person who completed the Workflow?

Accepted Answer

Email answers are automated emails sent by Malcolm! when a customer completes a Workflow. You can send these emails to members of your team, your suppliers, the customer or anyone else you'd like.

Sometimes it can be useful to set a reply-to address for these emails. This can be a fixed value or a value supplied by a customer when completing a Workflow (eg their email address)

To use this feature, when creating your email answer, toggle the custom email setting

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/qR57A24eot/Enabling%20the%20option%20to%20customise%20the%20email%20theme%2C%20sender%20and%20content%20in%20MyMalcolm.png (Enabling the option to customise the email theme, sender and content in MyMalcolm)

Then you'll see an option to either type a reply-to address or assign a field from the Workflow for this value.

Question 2

Do you support animated GIFs?

Accepted Answer

Yes you can use animated GIFs in Malcolm! placing them in your FAQs or in Workflows (via the Content element).

You can upload the animated GIF into the media section of MyMalcolm or you can pull in externally hosted GIFs.

This cat has been uploaded to MyMalcolm:

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/WsOiR3iaEG/Cat.gif (Animated Cat.gif)

To pull in external GIFs use the following Markdown syntax:

The above Markdown results in this:

https://media.giphy.com/media/QpWDP1YMziaQw/source.gif (Image Description)

Have fun!

Question 3

I'd like to open the Overlay embed directly, how do I do this?

Accepted Answer

When you create an Overlay embed we give you two bits of code to add to your page. The first is the master code which you should place just before the closing tag. The second is the inline code which generates the button users click to open the overlay - this goes inside the tags where you want the button to appear. When the user clicks the button the Overlay embed will appear in a modal (pop-up) over your page.

The inline code we give you will look like this -

Sometimes you might want to call the overlay but not use our button. You might want to call it from text or use your own button/graphic or you might want to call it in the background when a user does something else on your page.

You can do this by calling mapi in JavaScript.

The mapi has four methods - open, close, trigger and toggle. Open, close and toggle all return promises (i.e., a function that resolves when the animation is complete or a rejects if something went wrong, e.g., no embed found for the param passed). Trigger is more "fire and forget" - it will call the open function if everything goes well, otherwise it silently fails.

Here is an example using an href link that uses the trigger method to open the Overlay -

Note that you must have our master embed code on your page for the above to work and you need to replace EMBED_ID with your embed ID.

The above may also be useful for customers who are using third party site building systems - sometimes putting inline code into a page on those systems can be restricted so you can't add our inline code to render your button. If you can create inline links you could try using the above example with the trigger method to open the Overlay (again remember you also need the master code on the page).

Question 4

Can I turn tags off?

Accepted Answer

You can turn the display of all tags or individual tags off/on. This will also affect the tag listing/results screens.

This feature can be useful in a number of ways, for example if you are prepping a new tag to go live and want to attach it to all your relevant FAQs/Articles but don't want it to display just yet you can simply leave it switched off until you are ready.

You can turn Tags off globally in Settings --> FAQs --> General (under the "Listings" heading)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/WW0eQrCvC4/screenshot-my.malcolm.app-2023.04.02-15_42_17.png (Turning tags off globally in MyMalcolm)

Individual tags and their associated listings/results can be turned off via FAQs --> Tags then the three-dot menu to the right of the tag in question

Question 5

How to integrate with Mews using Workflow integrations

Accepted Answer

At Malcolm! HQ we continue to roll-out our built-in Workflow integrations, our most recent being the Mews Property Managamenet System.

Use a Malcolm! Workflow to capture information or record choices from your guest then have that data added to the guest notes in Mews. All you need from your guest is their Surname and Confirmation Number or a Reservation ID.

Connect to Mews

Get started in MyMalcolm by connecting to your Mews account via Settings > Workflows > Integrations using your Mews Client token and Access token.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/nV6HefCjKn/Screenshot%202022-03-28%20at%2009.59.27.png (Screenshot 2022-03-28 at 09.59.27.png)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/31zLOc5PSh/Screenshot%202022-03-28%20at%2009.59.46.png (Screenshot 2022-03-28 at 09.59.46.png)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/W5MGLxYUvx/Screenshot%202022-03-28%20at%2010.00.51.png (Screenshot 2022-03-28 at 10.00.51.png)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/igxpR5jiUq/Screenshot%202022-03-28%20at%2010.01.04.png (Screenshot 2022-03-28 at 10.01.04.png)

Build the Workflow

Start a new Malcolm! Workflow and capture the guest Surname and Confirmation Number.

If you prefer a hidden Reservation ID could be passed in via the URL, for example using a link in a direct email to the guest. URL values can also be tokenised to hide their true value. Read more on Setting Workflow values in a URL and Securing Workflow values.

Finish by adding the fields you'd like to capture in guest profile notes.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/EzbeRogC4Y/Screenshot%202022-03-28%20at%2010.05.53.png (Screenshot 2022-03-28 at 10.05.53.png)

Configure the integration

From the builder head to Configure > Integrations and choose the Mews integration.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/itYnbSd00O/Screenshot%202022-03-28%20at%2010.06.31.png (Screenshot 2022-03-28 at 10.06.31.png)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/l8M5UTXKsH/Screenshot%202022-03-28%20at%2010.06.45.png (Screenshot 2022-03-28 at 10.06.45.png)

Choose the "Add notes to a guest profile" action and your Mews booking service.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/fy8HASkjMf/Screenshot%202022-03-28%20at%2010.07.03.png (Screenshot 2022-03-28 at 10.07.03.png)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/QD16dElxZr/Screenshot%202022-03-28%20at%2010.07.09.png (Screenshot 2022-03-28 at 10.07.09.png)

Connect up your Malcolm! Workflow fields.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/QPrIZSUn6F/Screenshot%202022-03-28%20at%2010.07.39.png (Screenshot 2022-03-28 at 10.07.39.png)

Finish by enabling the integration and saving.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/zfnYbaPohW/Screenshot%202022-03-28%20at%2010.56.56.png (Screenshot 2022-03-28 at 10.56.56.png)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/vISxJiGvRj/Screenshot%202022-03-28%20at%2010.07.53.png (Screenshot 2022-03-28 at 10.07.53.png)

We hope you enjoy using this new integration. If you have any feedback or questions please get in touch below or via support@malcolm.app.

Question 6

What are invisible tags and how do I use them?

Accepted Answer

Invisible tags are a useful way you can influence search results. Like normal tags they will contribute to search ranking of an FAQ, but they won't be shown on the front-end to your users. If you therefore want a particular phrase to return a particular FAQ but your content doesn't feature that phrase or is being out ranked by another FAQ invisible tags can help.

You can make current tags invisible or set up new invisible tags in MyMalcolm via FAQs / Tags:

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/xOq4M1EP9q/01%20-%20screenshot-my.malcolm.app-2019.10.16-13_56_00.png (Creating an invisible tag)

You then apply tags as usual via the configure area of the individual FAQ:

Question 7

How can I password-protect my hub with Auth0?

Accepted Answer

Malcolm supports using Auth0 to password-protect your content.

This guide will help you set up Auth0.

First go to MyMalcolm > Settings > Instance > Visibility and enable Hosted Hub password protection. This automatically enables the built-in password protection.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/ea8meZWJKM/Screenshot%202021-11-25%20at%2016.37.03.png (Screenshot 2021-11-25 at 16.37.03.png)

Next, inside your Auth0 tennant, create a new Auth0 Application. Give it a name and choose Regular Web Applications from the four options.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/VDfX0QpiZh/Screenshot%202021-11-25%20at%2016.31.49.png (Screenshot 2021-11-25 at 16.31.49.png)

Click on the Settings tab and scroll down to the Basic Information section.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/JReEIPSyji/Screenshot%202021-11-25%20at%2016.46.53.png (Screenshot 2021-11-25 at 16.46.53.png)

In MyMalcolm click through to Manage password protection and toward the bottom enable Auth0 for password protection. Copy/paste the Domain, Client ID and Client Secret from Auth0 into MyMalcolm.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/mwX1ffzhIZ/Screenshot%202021-11-25%20at%2016.40.03.png (Screenshot 2021-11-25 at 16.40.03.png)

Next copy/paste the Application Login URI, Allowed Callback URL and Allowed Logout URL from Malcolm! into your Auth0 Application URIs settings.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/ST4LVVMZ3x/Screenshot%202021-11-25%20at%2016.45.36.png (Screenshot 2021-11-25 at 16.45.36.png)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/kpvEhZpVtp/Screenshot%202021-11-25%20at%2016.40.39.png (Screenshot 2021-11-25 at 16.40.39.png)

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

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/oijJOqmb9t/Screenshot%202021-11-25%20at%2016.42.11.png (Screenshot 2021-11-25 at 16.42.11.png)

But that's not all!

Attributes from your Auth0 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 four attribute names email, name, nickname or picture to pre-populate those values directly into your Workflow.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/5zfBKHJgrE/Screenshot%202021-11-25%20at%2017.23.01.png (Screenshot 2021-11-25 at 17.23.01.png)

You can read more about passing values in the URL query here.

Question 8

How do I reset my password?

Accepted Answer

If you need to reset your Malcolm! user account password please visit this link.

Question 9

What is the Share section in MyMalcolm for / how does it work?

Accepted Answer

The Share section of MyMalcolm gives you tools to embed and share content from Malcolm! into your existing websites, applications and social spaces.

You can bring content from Malcolm! directly into your current website via embeds. Choose the content you want to embed and how you want it displayed and we'll give you some code. Inserting that code into your current website will load in your content from Malcolm!

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)

You can embed individual FAQs or Workflows, create custom widgets that can pull in things like search results, category listings, all content by a particular author, recent content, tagged content, most popular content and much more.

If you don't have a website or you want to group all your Malcolm! content together you can use our Hosted Hub.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/77KnCbIxOb/screenshot-my.malcolm.app-2019.11.05-11_21_58.png (About our Hosted Hub)

We also have a plugin for Wordpress.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/3xBONmPNuf/screenshot-my.malcolm.app-2019.11.05-11_06_58.png (The Share section of MyMalcolm)

In addition to the above customers on our Enterprise plans have full access to our API which means they can pull from and push content to Malcolm! in a variety of ways - please speak to your account manager for more details.

Question 10

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.