Load HelpAlive after consent from your cookie banner

​

Consent at a glance

• HelpAlive has no consent mode. Your banner decides when the tag loads.
• Without the tag, nothing of HelpAlive runs and the agent doesn’t appear.
• Calls to identify() and reset() made before the tag loads wait in the page, then run once it has loaded.
• The old data-consent attribute, setConsent() and the mode and consent options of init() do nothing now. You can delete them.
• HelpAlive doesn’t read Do Not Track or Global Privacy Control signals.

​

Prerequisites

• A cookie banner or consent tool that tells your code when a user accepts or declines.

​

Make HelpAlive wait for consent

​

Example: add the tag when the user accepts

// Run when your cookie banner reports that the user accepted.
function loadHelpAlive() {
  const src = "https://cdn.helpalive.com/sdk/helpalive.js";
  if (document.querySelector(`script[src="${src}"]`)) return;
  const tag = document.createElement("script");
  tag.src = src;
  tag.async = true;
  tag.setAttribute("data-api-key", "YOUR_PROJECT_KEY");
  document.head.appendChild(tag);
}

​

If a user withdraws consent

// Run when your cookie banner reports that the user withdrew consent.
HelpAlive.reset();     // closes the agent and forgets the person in this browser
HelpAlive.shutdown();  // stops recording on this page

​

How HelpAlive behaves before and after consent

• Before the user accepts: the tag isn’t on the page, so HelpAlive sends nothing and shows nothing. Your four queue lines hold any identify() or reset() calls in the page.
• After the user accepts: the tag loads, runs the waiting calls, and the chat button appears for users in Who gets it.
• If the user declines: the tag never loads. This means that the agent stays away for that user, in that browser, until your banner reports a change.

​

Old consent settings

• A data-consent="required" attribute on the tag is ignored.
• setConsent() still exists, so old pages don’t break, but it does nothing.
• The mode and consent options of init() are gone.

​

Check it works

1. Open your app in a private window with the browser’s developer tools open on Network. Filter on helpalive.
2. Sign in and decline in your banner. No HelpAlive request appears.
3. Accept in your banner. The script loads, and the chat button appears for users in Who gets it.

​

Next