Social Miner Expert Notification via API

Version 1
    This document was generated from CDN thread

    Created by: Andrew Fraser on 29-11-2011 10:33:53 AM
    Hello all,

    I would like to write an Android App that creates a new Social Contact in Social Miner.  This contact would then initiate broadcast XMPP notification by IM to a group of experts, one of whom will log in and own the contact.  I then want my Android App to be able to be either:

    1) Notified that an expert has taken ownership of this contact.
       > Is this possible?  If so how?!
    2) Regularly poll the SM API to retrieve the extension of the user who has taken ownership of the contact
       > Is this possible?  Which API call would this be - GET Social Contact?  What information about the owner would this pull back?
     
    The Android App will then go on to CTS-Manager from Telepresence to schedule a (one-click) meeting between this Expert and the customer...
     
    All help much appreciated!
     
    Thanks,
    Andrew

    Subject: RE: Social Miner Expert Notification via API
    Replied by: Eric Rose on 29-11-2011 03:34:14 PM
    Hi
    Andrew,
     
    You must
    use the Social Contact post API to create a new Social Contact. The ¿author¿, ¿title¿,
    and ¿refFeedURL¿ parameters are required for creating a new Social Contact.
     
    Once
    the Social Contact has been created, there's no mechanism to be notified when
    the Social Contact's status changes. You'd have to poll the API (Social Contact
    get), and watch for the <status> changing to 'reserved' and/or 'handled'.
    The <statusUserID> associated with that <status> change is as close
    as you'll get to the "Owner", but there is nothing to prevent someone
    else from later replying to the Social Contact. The latest user to change a
    Social Contact is identified as the <statusUserID>.
    Also,
    you mention: "'retrieve the extension of the user". We're not sure
    what you mean by this. If you mean the telephone extension, we don't keep
    users' telephone extension. The <extensionFields> mentioned in the API
    doc is for additional, user-defined fields.
     
    Here¿s a link to the SocialMiner
    Developer¿s Guide for version 8.5(4):
    http://developer.cisco.com/documents/2163684/2165688/Cisco+SocialMiner+Developers+Guide+%2c%20Releases+8.5%284%29.pdf?redirect=http%3a%2f%2fdeveloper.cisco.com%2fweb%2fsocialminer%2fdocs%3fp_p_id%3ddoc_library_summary_portlet_WAR_doclibrarysummaryportlet_
     
    I hope this helps!



     
    Hello all,

    I would like to write an Android App that creates a new Social Contact in Social Miner.  This contact would then initiate broadcast XMPP notification by IM to a group of experts, one of whom will log in and own the contact.  I then want my Android App to be able to be either:

    1) Notified that an expert has taken ownership of this contact.
       > Is this possible?  If so how?!
    2) Regularly poll the SM API to retrieve the extension of the user who has taken ownership of the contact
       > Is this possible?  Which API call would this be - GET Social Contact?  What information about the owner would this pull back?
     
    The Android App will then go on to CTS-Manager from Telepresence to schedule a (one-click) meeting between this Expert and the customer...
     
    All help much appreciated!
     
    Thanks,
    Andrew


    Subject: RE: Social Miner Expert Notification via API
    Replied by: Amy Nordberg on 29-11-2011 03:45:10 PM
    Hi Andrew,

    You must use the Social Contact POST API to create a new Social Contact. The ¿author¿, ¿title¿, and ¿refFeedURL¿ parameters are required for creating a new Social Contact.

    Once the Social Contact has been created, there's no mechanism to be notified when the Social Contact's status changes. You'd have to poll the API (Social Contact get), and watch for the <status> changing to 'reserved' and/or 'handled'. The <statusUserID> associated with that <status> change is as close as you'll get to the "Owner", since there is nothing to prevent someone else from later replying to the Social Contact. The user who made the state change on the Social Contact is identified as the <statusUserID>.

    Also, you mention "the extension of the user". We're not sure what you mean by that. If you mean the telephone extension, we don't keep users' telephone extensions. The <extensionFields> mentioned in the API doc is for additional, user-defined fields.

    Here¿s a link to the SocialMiner Developer¿s Guide for version 8.5(4):
    http://developer.cisco.com/documents/2163684/2165688/Cisco+SocialMiner+Developers+Guide+%2c%20Releases+8.5%284%29.pdf?redirect=http%3a%2f%2fdeveloper.cisco.com%2fweb%2fsocialminer%2fdocs%3fp_p_id%3ddoc_library_summary_portlet_WAR_doclibrarysummaryportlet

    I hope this helps!

    Subject: RE: Social Miner Expert Notification via API
    Replied by: Andrew Fraser on 29-11-2011 05:56:07 PM
    Thanks Amy,
    The userid of the contact owner may well be enough to provision the CTS-Manager for the expert's device (e.g. a Cisco EX90).  I'll check with that dev forum...

    Regards,
    Andrew