This is the official node.js library for communicating with Engagespot REST API. Send multi-channel notifications from your node app.

Installation

``
npm install @engagespot/node
`

Prerequisites

You need Engagespot API KEY and API SECRET from your dashboard to get started. If you don't have one, just get one for free.

Getting Started

`javascript
import { EngagespotClient } from '@engagespot/node';

const client = EngagespotClient({
apiKey: 'ENGAGESPOT_API_KEY',
apiSecret: 'ENGAGESPOT_API_SECRET',
dataRegion: 'us', // Optional: Choose data region (us, eu)
});
`

- dataRegion (optional): Specify the region for data storage and processing. Available options:
- us: US region
- eu: EU region

If you pass an invalid dataRegion, the client will throw an error listing the available valid options.

Why do we need a data region? Read more about it here.

Example Usage

$3

`javascript
client.send({
notification: {
workflow: {
identifier: 'appointment_reminder',
},
},
data: {
doctor: {
name: 'Dr. Brian',
},
dateTime: '27 Jul, 13:30',
},
sendTo: {
recipients: ['patient_uuid_001'],
},
});
`

---

For more advanced configurations and the list of all supported parameters, refer to the Engagespot REST API Docs.

Advanced Configurations

Methods and supported parameters.

`javascript
import { EngagespotClient } from '@engagespot/node';

const client = EngagespotClient({
apiKey: 'ENGAGESPOT_API_KEY',
apiSecret: 'ENGAGESPOT_API_SECRET',
});

// Triggering a workflow

client.send({
notification: {
workflow: {
identifier: 'appointment_reminder',
},
},
data: {
doctor: {
name: 'Dr. Brian',
},
dateTime: '27 Jul, 13:30',
},
sendTo: {
recipients: ['patient_uuid_001'],
},
});
`

Create or Update User

`js
import { EngagespotClient } from '@engagespot/node';

const client = EngagespotClient({
apiKey: 'ENGAGESPOT_API_KEY',
apiSecret: 'ENGAGESPOT_API_SECRET',
});

client.createOrUpdateUser('patient_uuid_001', {
firstName: 'Ben',
country: 'US',
});
`

Create User Tokens

`js
import { EngagespotClient } from '@engagespot/node';

const client = EngagespotClient({
apiKey: 'ENGAGESPOT_API_KEY',
apiSecret: 'ENGAGESPOT_API_SECRET',
signingKey: 'YOUR_ENGAGESPOT_SIGNING_KEY',
});

client.generateUserToken('identifier');
`

NOTE : You must provide signingKey while initializing engagespot client to use generateUserToken function.

$3

You can generate your public-private signing key pair from Engagespot console, and this private key should be the secret signing key for generating user tokens

1. Login to Engagespot console -> API Credentials

2. Generate your Signing Key by clicking Generate

:::caution
When you generate the signing key, Engagespot will store only the public key in our database.
You should download the private key and use it for signing your user tokens. You won't be able to retrieve the private key after this step.
:::

$3

In-app inbox notifications are messages that users can view within your application. Here's how you can manage them using the EngagespotClient:

#### 1. Fetching In-App Notifications

You can fetch in-app notifications for a specific user. This retrieves a list of notifications from the in-app inbox.

`javascript
client.inAppInbox
.fetch('john_doe_123', 1, 10)
.then(notifications => {
console.log('Fetched notifications:', notifications);
})
.catch(error => {
console.error('Error fetching notifications:', error);
});
`

- userIdentifier: The identifier of the user whose notifications you want to fetch.
- pageNo (optional): Page number of the notifications (default is 1).
- limit (optional): Maximum number of notifications per page (default is 10).

#### 2. Marking a Notification as Read

You can mark a notification as read once the user has viewed it.

`javascript
client.inAppInbox
.markNotificationAsRead('notification_123')
.then(response => {
console.log('Notification marked as read:', response);
})
.catch(error => {
console.error('Error marking notification as read:', error);
});
`

- notificationId: The ID of the notification to mark as read.

#### 3. Marking a Notification as Unseen

You can mark a notification as unseen to indicate that it hasn't been viewed by the user yet.

`javascript
client.inAppInbox
.markNotificationAsUnseen('notification_123')
.then(response => {
console.log('Notification marked as unseen:', response);
})
.catch(error => {
console.error('Error marking notification as unseen:', error);
});
`

- notificationId: The ID of the notification to mark as unseen.

#### 4. Marking a Notification as Unread

You can mark a notification as unread if the user has viewed it but hasn't interacted with it in a meaningful way.

`javascript
client.inAppInbox
.markNotificationAsUnRead('notification_123')
.then(response => {
console.log('Notification marked as unread:', response);
})
.catch(error => {
console.error('Error marking notification as unread:', error);
});
`

- notificationId: The ID of the notification to mark as unread.

#### 5. Deleting a Notification

You can delete a notification from the in-app inbox if it's no longer relevant.

`javascript
client.inAppInbox
.deleteNotification('notification_123')
.then(response => {
console.log('Notification deleted successfully:', response);
})
.catch(error => {
console.error('Error deleting notification:', error);
});
`

- notificationId: The ID of the notification to delete.

$3

#### 1. Creating a New Topic

You can create a new topic.

`javascript
client.topics
.create('New Topic')
.then(topicId => {
console.log('New topic created with ID:', topicId);
})
.catch(error => {
console.error('Error creating topic:', error);
});
`

- name: The name of the new topic.
- identifier (optional): The identifier of the topic. If not provided, it will be generated from the name.

#### 2. Updating an Existing Topic

You can update the name of an existing topic.

`javascript
client.topics
.update(123, 'Updated Topic Name')
.then(response => {
console.log('Topic updated successfully:', response);
})
.catch(error => {
console.error('Error updating topic:', error);
});
`

- topicId: The ID of the topic to update.
- name: The new name for the topic.

#### 3. Deleting a Topic

You can delete a topic.

`javascript
client.topics
.delete(123)
.then(response => {
console.log('Topic deleted successfully:', response);
})
.catch(error => {
console.error('Error deleting topic:', error);
});
`

- topicId: The ID of the topic to delete.

#### 4. Subscribing Users to a Topic

You can subscribe users to a topic.

`javascript
const usersToSubscribe = [
{ identifier: 'user1', channels: ['email', 'push'] },
{ identifier: 'user2', channels: ['push'] },
];

client.topics
.subscribeUser(123, usersToSubscribe)
.then(response => {
console.log('Users subscribed successfully:', response);
})
.catch(error => {
console.error('Error subscribing users to topic:', error);
});
`

- topicId: The ID of the topic to subscribe users to.
- users: An array of user objects to subscribe. Each user object should have an identifier and channels.

#### 5. Unsubscribing Users from a Topic

You can unsubscribe users from a topic.

`javascript
const usersToUnsubscribe = ['user1', 'user2'];

client.topics
.unsubscribeUser(123, usersToUnsubscribe)
.then(response => {
console.log('Users unsubscribed successfully:', response);
})
.catch(error => {
console.error('Error unsubscribing users from topic:', error);
});
`

- topicId: The ID of the topic to unsubscribe users from.
- users: An array of user identifiers to unsubscribe.

#### 6. Updating Notification Channels for a User in a Topic

You can update notification channels for a user in a topic.

`javascript
client.topics
.updateChannel('user1', 123, ['email', 'push'])
.then(response => {
console.log('Notification channels updated successfully:', response);
})
.catch(error => {
console.error(
'Error updating notification channels for user in topic:',
error,
);
});
`

- identifier: The identifier of the user whose channels are to be updated.
- topicId: The ID of the topic.
- channels: An array of notification channels for the user.

#### 7. Listing Subscriptions of a User to All Topics

You can list subscriptions of a user to all topics.

`javascript
client.topics
.listSubscriptionsOfUser('user1')
.then(subscriptions => {
console.log('User subscriptions:', subscriptions);
})
.catch(error => {
console.error('Error listing user subscriptions:', error);
});
`

- identifier`: The identifier of the user.