@b-jones-rfd/nice-api-tasks
v0.2.0
Published
Perform common tasks using the Nice InContact API
Readme
Nice API Tasks
Helpers to perform common tasks using the Nice InContact API. This is an exercise to avoid code reuse in my own projects. Use at your own risk.
Prerequisites
This project requires NodeJS (version >= 18) and NPM. Node and NPM are really easy to install. To make sure you have them available on your machine, try running the following command.
$ npm -v && node -v
10.2.4
v20.11.1PNPM is a awesome alternative to NPM and is recommended.
Table of contents
Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
Installation
BEFORE YOU INSTALL: please read the prerequisites
To install and set up the library, run:
$ npm i @b-jones-rfd/nice-api-tasksOr if you prefer using Yarn:
$ yarn add @b-jones-rfd/nice-api-tasksOr for PNPM:
$ pnpm add @b-jones-rfd/nice-api-tasksUsage
TBD
API
Authentication
getToken(options)
Implements OAuth Authentication (Post Authentication) and returns the access token as the result data.
options
| Property | Type | Description | Required | | ------------ | ------ | -------------------- | -------- | | clientId | string | Nice Client ID | Y | | clientSecret | string | Nice Client Password | Y | | username | string | Nice Access Key | Y | | password | string | Nice Access Secret | Y |
Extracts
getExtractData(options)
Implements Data Extraction and returns the extract text. For available extracts review Data Extraction APIs online help. This is a multistep process running the following actions:
- Start data extract
- Polls Get data extract status until error or complete
- Returns the file text as string
options
| Property | Type | Description | Format | Required | | ----------- | ------ | ------------------- | ---------- | -------- | | entityName | string | Extract entity name | | Y | | version | string | Extract version | | Y | | startDate | string | Extract start date | YYYY-MM-DD | Y | | endDate | string | Extract end date | YYYY-MM-DD | Y | | accessToken | string | Bearer token | | Y |
getExtractStatus(options)
Implements Data Extraction (Get a specific job status) and returns the status of the job. For available extracts review Data Extraction APIs online help.
options
| Property | Type | Description | Required | | ----------- | ------ | ------------ | -------- | | jobId | string | Job ID | Y | | accessToken | string | Bearer token | Y |
runExtracts(options)
Implements Data Extraction and returns the status of the completed job. For available extracts review Data Extraction APIs online help. This is a multistep process running the following actions:
- Start data extract
- Polls Get data extract status until error or complete
options
| Property | Type | Description | Format | Required | | ----------- | ------ | ------------------- | ---------- | -------- | | entityName | string | Extract entity name | | Y | | version | string | Extract version | | Y | | startDate | string | Extract start date | YYYY-MM-DD | Y | | endDate | string | Extract end date | YYYY-MM-DD | Y | | accessToken | string | Bearer token | | Y |
startExtract(options)
Implements Data Extraction (Prepares data for extraction) and returns the job id as the result data. For available extracts review Data Extraction APIs online help.
options
| Property | Type | Description | Format | Required | | ----------- | ------ | ------------------- | ---------- | -------- | | entityName | string | Extract entity name | | Y | | version | string | Extract version | | Y | | startDate | string | Extract start date | YYYY-MM-DD | Y | | endDate | string | Extract end date | YYYY-MM-DD | Y | | accessToken | string | Bearer token | | Y |
Contributing
This is a pet project to save me time at work. It is still under development and you should use at your own risk.
Versioning
We use SemVer for versioning. For the versions available, see the tags on this repository.
Authors
- B Jones RFD - Package Noob - B-Jones-RFD
