@saysimple/node-sdk

SaySimple SDK for JavaScript

We’re Saysimple — the Messaging Platform Pioneer — and we’re on a mission to change customer service centers into commercial profit centers. We’re turning social messaging channels that are used for personal communication into powerful communication channels for any kind of business, providing conversational excellence with unrivaled ease.

And this, is our SDK for JavaScript for you.

Installation

For NPM

npm i @saysimple/node-sdk

For Yarn

yarn add @saysimple/node-sdk

Usage

API Documentation 📑

The SDK is a one-on-one translation of the native REST API, which can be found here.
You can get a more in-depth knowledge of the API and the possible parameters if you read the API documentation.

Intelligence V1 👩🏻‍🔬

Initialization

const SaySimpleClient = require("@saysimple/node-sdk");
const Intelligence = SaySimpleClient.Intelligence.V1("[API TOKEN]", "[SECRET KEY]");
// Or:
const Intelligence = SaySimpleClient.Intelligence.Latest("[API TOKEN]", "[SECRET KEY]");  

If you omit a secret key, the SDK will assume you put a valid access token directly on the first parameter.

Functions

Function	Parameters
addMessage	See Add A Message in the API Docs
getMessagesSummed	See Total Messages Summed in the API Docs
getActiveContactsSummed	See Total Active Contacts in the API Docs
getSendPaidTemplatesSummed	See Total Paid Templates Send in the API Docs
getAgents	See List Agents in the API Docs
getChannels	See List Channels in the API Docs

To get all messages summed you can run the following code

const SaySimpleClient = require("@saysimple/node-sdk");
const Intelligence = SaySimpleClient.Intelligence.V1("[API TOKEN]", "[SECRET KEY]");

(async () => {
    const messagesSummed = await Intelligence.getMessagesSummed({
        agent: "[e-mail]"
    });

    console.log(messagesSummed);
})();

That's it! 🚀

Messaging V1 💌

Will be implemented as soon as possible.
For now please refer to the API documentation.

Showcasing 🎭

We are really keen to know what you build with SaySimple, so please do let us know when your project is up-and-running!

TypeScript support ⌨️

This package exports type declarations, thus it can be used in TypeScript projects without requiring extra dependencies.

Support 🧞

We tried to make the API and SDK as easy as possible, but maybe we didn't succeed on every aspect of it. Please don't hesitate to contact us if something is not working or is unclear.

You can reach us at: [e-mail].

Raising an issue 🤕

If you encounter a bug in this software we'd love to hear about it. So we can work on improving our SDK, and your developer experience.

Please be sure you've searched for the same problem in the tickets opened already. Also, it would be helpful if you can provide as many details as possible. Like the versions of the SDK and Node.js and how your (environment) set up is.

License 🕵🏽‍♀️

This software is distributed under the Apache License 2.0 license. See LICENSE.txt.

Copyright 2019 - 2020 Just Internet B.V. or its affiliates. All Rights Reserved.

Changelog

v0.0.5

12 November 2020

• It is possible to set the authentication URL now. It won't add any endpoint.
• Renamed 'send' to sent
• Fixed tests