GUURU for Developers

GUURU for Developers

  • Docs
  • Contacts

›Loader

Loader

  • Getting Started
  • Public Interface
  • Handling Events
  • Conversion
  • Cookies
  • Examples

SmartChat

  • Getting started
  • Chat Widget

    • Getting started
    • Parameters

SmartForm

  • Getting Started

Admin API

  • Getting started
  • Examples
  • API Reference

    • Queries
    • Mutations
    • Types
    • Pagination

Webhooks

  • Getting started
  • Examples

Integrations

  • Facebook
  • Freshchat
  • Salesforce
  • Zendesk
  • Microsoft
  • Third Party Messaging

Install Loader

To get started with SmartChat or SmartForm in your website you need to install our Loader first.

The Loader is the only piece of code you need to place in your website to integrate with us. After you place our javascript code in your website you will be able to enable and configure the SmartChat and SmartForm to be available to your users in your website.

Get the Javascript code

Just copy the code snippet from your Developer Settings, where we pre-populate your Application ID (this is your APP_ID in the code) for you.

Or you can quickly grab it from here instead:

<script type="text/javascript" src="https://static.guuru.com/loader/v1.0/chat.min.js"></script>
<script>
window.guuru = window.Guuru();
window.guuru.init({
  appId: '<APP_ID>',
});
</script>

If you copy the code snippet above you'll need to manually change your Application ID. You can get your AppId on the General Settings.

How to use the Javascript code

Paste the code snippet before the </body> tag on every page where you want the SmartChat or SmartForm to appear for your website visitors.

Alternatively: Using a Tag Manager System

Using a Tag Manager System like Google Tag Manager (GTM) is a simple solution to manage Javascript snippets without requiring a developer to update any code.

Please note that Adblockers and browsers privacy tools are more likely to block code injected by Tag Managers, which will lead to fewer visitors being able to see the chat/form. If you decide to start with a integration using some Tag Manager we recommend to switch to a on-page integration whenever IT resources are available to insure maximum availibility.

Using Google Tag Manager (GTM) in a Single Page Application

If your website is a Single Page Application you may have issues if you want to change the parameters in the init function, like the category for instance, while the visitor clicks and interacts with your website.

To allow that you must configure the Google Tag Manager to trigger in the History Change event. Refer to this documentation page to additional details.

Note: You should also have the Page View trigger to make chat loader appear in the page load.

Also, because the integration script can now already be loaded in your website, you need to call the destroy function before anything else. For example, by calling it just before the guuru variable initialization:

<script src="https://static.guuru.com/loader/v1.0/chat.min.js"></script>
<script>
  if ('guuru' in window) {
    window.guuru.destroy();
  }
  window.guuru = Guuru();
  window.guuru.init({
    "appId": '<YOUR_APP_ID>',
  });
</script>

Content Security Policy

Content Security Policy (CSP) is a security mechanism that helps protect against content injection attacks, such as Cross Site Scripting (XSS).

If your website does not send the CSP header no action is needed from your side.

If your website sends the CSP header you may need to add *.guuru.com to the frame-src, child-src and img-src directives of the CSP header.

Incognito mode in Google Chrome

Our chat need 3rd party cookies enabled to appear and work as expected. So if 3rd party cookies are not enabled in the browser we will not show our chat loader in your website.

When you open Google Chrome in Incognito mode, the option to enable 3rd party cookies is disabled by default. If you want to try our chat loader while using incognito mode make sure you enable this option.

3rdpartycookies

This is a limitation that only happens with Google Chrome, and they are working on implementing the same behaviour as the other browsers.

If you need help or you are experiencing some problem installing our Loader please get in touch with our support team.

Public Interface →
  • Get the Javascript code
  • How to use the Javascript code
    • Alternatively: Using a Tag Manager System
    • Content Security Policy
    • Incognito mode in Google Chrome
GUURU for Developers
Docs
SmartChatSmartFormAPI Reference
Community
GitLabFacebookLinkedIn
Copyright © 2023 GUURU Solutions Ltd.