charminder/vue-intercom

An Intercom Javascript API plugin for Vue.js

vue-intercom

A reactive wrapper for Intercom's JavaScript API

Forked in order to add the showArticle command.

Installation

npm install --save @charminder/vue-intercom

yarn add @charminder/vue-intercom

import Vue from 'vue';
import VueIntercom from '@charminder/vue-intercom';

Vue.use(VueIntercom, { appId: 'your-app-id' });

Usage

vue-intercom handles the injection of Intercom's script into your html and wraps calls to the Intercom API with methods and exposes them through the $intercom object in your components.

new Vue({
  el: '#app',
  data() {
    return {
      userId: 1,
      name: 'Foo Bar',
      email: '[email protected]',
    };
  },
  mounted() {
    this.$intercom.boot({
      user_id: this.userId,
      name: this.name,
      email: this.email,
    });
    this.$intercom.show();
  },
  watch: {
    email(email) {
      this.$intercom.update({ email });
    },
  }
});

Example App

cd example
yarn
yarn dev

API

Values

$intercom.ready

Set to true once the Intercom script has been loaded.

$intercom.visible

Set via the onShow/onHide events.

$intercom.unreadCount

Set via the onUnreadCountChange event.

Methods

$intercom.boot(/* optional */options)

Calls Intercom('boot'). Automatically sets the app_id unless specified in the options object.

$intercom.shutdown()

Calls Intercom('shutdown').

$intercom.update(/* optional */options)

Calls Intercom('update'). If the options object is set, calls Intercom('update', options)

$intercom.show()

Calls Intercom('show').

$intercom.hide()

Calls Intercom('hide').

$intercom.showMessages()

Calls Intercom('showMessages').

$intercom.showNewMessage(/* optional */content)

Calls Intercom('showNewMessage') with pre-populated content if provided.

$intercom.trackEvent(name, /* optional */metadata)

Calls Intercom('trackEvent') with extra metadata if provided.

$intercom.showArticle(articleId)

Calls Intercom('showArticle', article).

$intercom.getVisitorId()

Calls Intercom('getVisitorId').

License

MIT

Copyright (c) 2017 Continuon