agendize

Agendize NPM Module

This is a node.js module to interact with Agendize APIs. Agendize API documentation is available here: http://developers.agendize.com/. This module handles both partner authentication and application oAuth2 authentication modes.

Prerequisites

• Have an Agendize Account

• Requesting your API key to our wonderful Support team

  *if you are a pa rtner distributing Agendize accounts, you also need to request a SSO Token to our support team.

• Finally understand how Agendize objects are working together. What is an Account? a Company, Service, Staff, Client or Appointment.

Installation

npm install -g agendize

Initialization

Your Agendize application manages multiple accounts

As mentioned in the developer documentation, authentication will be handled by ssoToken and apiKey.

var Agendize = require('agendize');
var options = {
    apiKey:'abc1xxxxxxxxxxxxxx9jkl',
    token:'mno1xxxxxxxxxxxxxx9vwz'
}
var agendizeApi = new Agendize(options)

Your Agendize application manages multiple accounts

Authentication will be done following the oAuth2 processus. According to the documentation you will need a client ID, a client Secret and a Callback URL.

var Agendize = require('agendize');
var options = {
    client_id:'abc1xxxxxxxxxxxxxx9jkl',
    client_secret:'mno1xxxxxxxxxxxxxx9vwz',
    callback_url:'https://your.application.com/your/callback/path'
}
var agendizeApi = new Agendize(options)

How it works

Most of the functions available will have the form:

agendizeAPI.doSomethingWith(options,callback);

• options is the input of the function and is discribed into each function description.

• callback object is an asynchronously called function with error and result objects.

agendizeApi.doSomethingWith(options,function(error,result){
    if(error){
        //do something with the error
    }else{
        //do something with the result
    }
})

result object will contain the resulted created objects depending on the options parameter. See Agendize developers documentation for each resource body.

error object

Authentication

• If you are managing multiple accounts. Then access the reseller API following the bellow documentation. When accessing the Account or Scheduling APIs, insert the property sso_token inside the options object with the value of the account's sso_token you want to manage.

• However if you work with oAuth2, insert the property access_token inside the options object with the value of the user's access_token you want to manage the account of.

Available Functions

Reseller API

You can manage multiple accounts under a partner Agendize account.

Create accounts

agendizeApi.createAccount(options,callback) with required option:

options = {
    account:{
        email:'[e-mail]'
    }
}

options can be:

options:{
        account:{
            email:String,
            password:String
        },
        staff:[
        {
            firstname:String,
            lastname:String,
            email:String
        }
        ],
        company:{
            name:String
        },
        services:[{
            name:String,
            price:Int,
            duration:Int
        },
        {
            name:String,
            price:Int,
            duration:Int
        }],
        buttons:[
        {
            name:String
        }]
        ,
        clients:[
        {
            firstname:String,
            lastname:String,
            address:{
                street:String,
                zipCode:String,
                city:String,
                country:String
            },
            emailAddresses:[
            {
                primary:Boolean,
                email:String
            }]
        }],
        appointments:[Date,Date],
        paymentProfile:{
            nativePlan:Boolean,
            id:Int
        }
    }
}

Note that according to Agendize objects management:

• buttons creation need company
• appointments creation need staff, service and client.

Check if an email is already used

agendizeApi.checkIfAccountExist(options,function(error,result){

})

with required option:

options = {
    email:'[e-mail]'
}

result is set to true, or false, depending on if the email is known, or not, by Agendize.

Desactive an account

agendizeApi.desactiveAccount(options,function(error){

})

with required ption:

options = {
    account_id:Int
}

Change the plan of an account

agendizeApi.changePlan(options,function(error,result){

})

with required option:

options = {
    account_id:Int,
    destination_plan:Int
}

result is the updated account resource.

Account API

Get account information

agendizeApi.getAccount(options,function(error,result){

})

with required option:

• If you are working with oAuth2:

options = {
    access_token:"abcdefg12345678qabcdefgh"
}

result will be the Agendize account resource of the access_token user owner.

However if you are a reseller and managing multiple accounts:

options = {
    sso_token:"abcdefg12345678qabcdefgh"
}

result will be the Agendize account resource of the sso_token user owner.

Online Scheduling API

Get Companies

agendizeApi.getCompanies(options,function(error,result){

})

with required option:

• If you are working with oAuth2:

options = {
    access_token:"abcdefg12345678qabcdefgh"
}

result will be the Agendize company resource list of the access_token's user's account.

However if you are a reseller and managing multiple accounts:

options = {
    sso_token:"abcdefg12345678qabcdefgh"
}

result will be the Agendize company resource list of the sso_token user owner.

Get Clients

agendizeApi.getClients(options,function(error,result){

})

with required option:

• If you are working with oAuth2:

options = {
    access_token:"abcdefg12345678qabcdefgh"
}

result will be the Agendize client resource list of the access_token's user's account.

However if you are a reseller and managing multiple accounts:

options = {
    sso_token:"abcdefg12345678qabcdefgh"
}

result will be the Agendize client resource list of the sso_token user owner.

Get Staffs

agendizeApi.getClients(options,function(error,result){

})

with required option:

• If you are working with oAuth2:

options = {
    access_token:"abcdefg12345678qabcdefgh",
    company_id:"1234567"
}

result will be the Agendize staff resource list of the access_token's user's account related to the company id indicated.

However if you are a reseller and managing multiple accounts:

options = {
    sso_token:"abcdefg12345678qabcdefgh"
    company_id:"1234567"
}

result will be the Agendize client resource list of the sso_token user owner related to the company id indicated.

Create appointment

Create appointment with ids

agendizeApi.createAppointment(options,function(error,result){

})

options required attributes:

options = {
    sso_token:String,
    company_id:String,
    staff_id:String,
    client_id:String,
    service_id:String,
    date:Date
}

result will be the created appointment resource;

Create appointment with appointment

agendizeApi.createAppointmentWithAppointment(options,function(error,result){

})

options required attributes:

options = {
    sso_token:"abcdefg12345678qabcdefgh"
    appointment:{

    }
}

result will be the created appointment resource;

Click to call API

Make a click-to-call call

You need to have a click to call button on the Agendize account.

agendizeApi.call(options,function(error,result){

})

options required attributes:

options = {
    button_id:"123456789",
    number:"[phone]"
}

Run the examples

You will need to have an Agendize developer account to use the examples then follow the bellow steps:

• Go to the example project folder for instance cd examples/click-to-call
• Install the needed npm modules with the command: npm install
• Set the credentials of the agendize module in the index.js file
• Start the application with node index.js