Dopt users JavaScript browser client

Overview

The Dopt users JavaScript client is a friendly client-side package for accessing the Dopt blocks API to access and updates block and flow state for a particular user in Dopt.

It is published to npm as @dopt/users-javascript-browser-client.

Installation

Via npm:

npm install @dopt/users-javascript-browser-client

Via Yarn:

yarn add @dopt/users-javascript-browser-client

Via pnpm:

pnpm add @dopt/users-javascript-browser-client

Configuration

To configure the Users JavaScript Client you will need

1. A users API key (generated in Dopt)
2. An identifier for the user or group you wish to identify (the same identifier will be used in the React SDK)
3. The properties you wish to store and/or update for the given user or group

Usage

Initialization

import { DoptApiClient } from '@dopt/users-javascript-browser-client';

const client = new DoptApiClient({
  apiKey: process.env.DOPT_USERS_API_KEY as string,
});

Users

Identify a single user to Dopt.

await client.users.identifyUser({
  identifier: "identifier_example",
  properties: {
    stringExample: "string",
    numberExample: 12345,
    booleanExample: true,
    nullExample: null,
  },
});

Identify a batch of users to Dopt.

await client.users.identifyUsers([
  {
    identifier: "identifier_example",
    properties: {
      stringExample: "string",
      numberExample: 12345,
      booleanExample: true,
      nullExample: null,
    },
  },{
    identifier: "user2_identifier",
    properties: {
      stringExample: "string",
    },
  }
]);

Groups

Identify a group to Dopt.

await client.groups.identifyGroup({
  identifier: "group_identifier_example",
  properties: {
    stringExample: "string",
    numberExample: 12345,
    booleanExample: true,
    nullExample: null,
  },
})