Website widget

Add MAY to your public website without exposing a private API key.

Configure the website experience in Business Admin, then copy the generated embed snippet into your site. The generated snippet is the source of truth for script URL, public widget identifier and supported options.

1. Configure the website integration

  1. Open MAY Business Admin.
  2. Go to Integrations and select the website / public widget configuration available for your business.
  3. Select the customer-facing AI employee and configure the supported appearance and behaviour options.
  4. Add the domains that are allowed to host the widget when domain controls are available.
  5. Save the configuration and copy the generated embed snippet.

2. Add the generated embed code

Use the generated snippet, not a guessed production URL

MAY can change widget asset paths or configuration fields between releases. Copy the exact snippet shown by Business Admin for your environment.

Embed pattern
<!-- Paste the exact snippet generated by MAY Business Admin -->
<script
  src="YOUR_MAY_WIDGET_SCRIPT_URL"
  data-may-widget="YOUR_PUBLIC_WIDGET_ID"
  defer>
</script>

3. Where to place it

For a traditional HTML site, place the generated snippet near the end of the page before </body>. For a framework application, load it once in the application shell rather than once per component render.

HTML placement
...
  <!-- MAY widget -->
  PASTE_GENERATED_MAY_WIDGET_SNIPPET_HERE
</body>
</html>

4. Public widget security

The public widget must not contain your private MAY API key. Use the widget identifier/configuration issued specifically for the public website experience.

5. If the widget does not appear

Confirm the exact generated script URL loads successfullyConfirm the current domain is allowed by the widget configurationCheck browser console errorsCheck Content Security Policy if your site uses CSPEnsure the embed snippet is loaded only onceConfirm the selected AI employee is enabled for the website channel
Need help implementing MAY?

Use the guide, then configure it in Business Admin.