Add Alma to your website

What the embed code is

Every Alma chatbot has its own embed code. It is on the bot's Settings page in your Alma dashboard, in the Embed Code section, with a Copy Code button underneath. It is a short script of about seven lines:

<script>
  (function(w,d,s,o,f,js,fjs){
    w['AlmaChat']=o;w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};
    js=d.createElement(s),fjs=d.getElementsByTagName(s)[0];
    js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs);
  }(window,document,'script','alma','https://www.helloalma.chat/widget/widget.js'));
  alma('init', 'YOUR-BOT-ID');
</script>

The code loads Alma's chat file asynchronously (in the background), so the browser keeps building your page instead of waiting for it. Once the file has loaded, a round chat button appears in the bottom right corner of the page, or the bottom left if you choose that under Widget Position on the same Settings page. A visitor clicks the button and the chat opens with your welcome message.

Where it goes

Alma's instruction is the same on every platform: paste the code just before the closing </body> tag, which sits near the end of every page's HTML (the code a browser reads to draw the page). Website builders rarely show you that tag. Instead, each one has its own place for adding code to the end of a page, such as a footer code box, a code injection field or a theme file, and some only offer it on certain plans. The guides show you that place on each platform and name the plans that include it, using the platform's own documentation.

Showing the chat on only some pages

Alma has no setting that limits the chat to certain pages. It appears on every page that contains the embed code, so to show it on only some pages, you paste the code on those pages instead of adding it to the whole site. Each guide explains how to do that on its platform. Put the code on a page once only: a page with two copies loads the chat twice.

Other platforms

If your site runs on another platform or was built by hand, the same rule applies. Look in your platform's help pages for "custom code" or "code injection". If it lets you add a script before the closing </body> tag, that is where the embed code goes.