Noojee API

    The Noojee API allows calls and call recording to be controlled directly from within your CRM or any business application.

    This API is part of the broader Noojee Admin API which provides control over various aspects of our Call Centre suite.Through the API:

    • New calls can be initiated
    • Existing calls can be terminated (hangup)
    • Incoming calls can be answered
    • Call state can be tracked for speific extensions
    • Recording can be initiated
    • Recording can be stopped

    Recordings can be attached to any record within your CRM for easy retrieval. When starting a recording from within your CRM you can also 'tag' a recording by adding a reference no. (e.g. an invoice no.) to the recording so that the recording can be later retrieved by the invoice no. This is often used to attached a 'Voice Signature' recording directly to an order or customer account record in the CRM.

    REST API  

    The API is exposed as a REST service.

    API calls are made through HTTP POST requests. Responses to API calls are JSON formatted.

    All calls must be authenticated.

    REST Resources Overview

    The service has the following resources:

    • Code - an integer status code. This resource is included in every API call response. The Code is zero ({"Code": 0}) for successful calls. A negative value signifies an error. A positive non-zero value indicates a warning or a notice.
    • Message - a string status message. Common to most call responses. The message generally clarifies the status code. The message is particularly useful where the status code is non-zero (an error has occured).
    • SessionID - an integer session identifier. This identifier is returned by the API when a call is initiated. Use this ID to track the status of the call. Note that the extension number can also be used to track call status. 
    • CallData - details of an inbound call. Inbound call notices have this information.
    • MetaData - call recording meta-data.

    REST Methods Overview

    The service has the following methods

    • dial - initiate a call
    • checkState - check the status of a call
    • hangup - terminate a call
    • subscribe - subscribe to inbound call notification
    • answer - answer an inbound call
    • start - start a recording
    • stop - stop a recording
    • tag - tag a recording
    • retrieve - retrieve a recording
    • retrieveByCallRecordId - retrieve a recording by call record ID
    • retrieveMetaData - retrieve recording meta-data
    • retrieveMetaDataByUniqueId - retrieve recording meta-data by unique ID

    Auto Answer Settings

    The dial and answer API methods require an auto answer string which is specific to the manufacturer, make and model of handset. Below is a list of some of the strings that might be used:

    Aastra Alert-Info: info=alert-autoanswer
    Grandstream Call-Info:\\; answer-after=0
    Linksys Call-Info:\\; answer-after=0
    Polycom Alert-Info: Ring Answer
    Snom Call-Info:\\; answer-after=0
    Snom - newer firmware Call-Info: <sip:1923.168.1.1>\;answer-after=0
      IP address must be correct
    Yealink Call-Info:\; answer-after=0

    Comments

    You must login to post a comment.

    Attach file

    Attachments