Smiirl Integration

[Kronshage]

Has anyone had success with Smiirl's custom web counter? We are looking to connect them to individual superusers Kudo count.

Any best practices would be very welcome. 🙂

[PaoloT]

Hey @Kronshage

looks like the device only requires an input JSON endpoint that provides the counter value. I think if you create a Custom Studio Endpoint that returns the number of kudos for a given user (maybe accepting a user ID as a parameter) - it should do the trick.

Thanks,

[VarunGrazitti]

@Kronshage as @PaoloT mentioned, this just requires a JSON input which can be generated by an endpoint.  Moreover, for your case, you need to custom code to get the super users kudo in the endpoint and pass that to your smiirl counter.

I hope this helps. Good luck!

[ClaudiusH]

Thanks for sharing this product link, @Kronshage - I just spent 15 minutes on their page and was about to order one right away 🙂

I think the integration can be pretty straight forward if you just use this API v1 link for the kudo count of each of your super users: http://community.lithium.com/restapi/vc/users/login/Kronshage/kudos/received/count

[PaoloT]

This will actually return JSON : http://community.lithium.com/restapi/vc/users/login/Kronshage/kudos/received/count?restapi.response_format=json

However their page does not specify if a specific JSON format is required, or if you can configure which element to look at. If a specific format is required, an endpoint will likely help.

[Kronshage]

Thanks for the replies everyone. I will definitely keep you posted once we get the devices in hand and have a chance to test them. 

[JulieHamel]

@Kronshage any updates yet? I recently came across a Smiirl counter in a bar I visited here in Montreal and was reminded of SFR who had quite the success story in 2015 with the live "Merci" counters they offered to superusers: https://community.lithium.com/t5/Past-Lithys/Lithys-2015-SFR-Marketing-Champion/idi-p/192784

I've been thinking of this as a potential community anniversary thank you for our own top contributors so I was glad to come across your recent thread! I would love to get more insights once you have an update. Perhaps we even have some folks still around from SFR or The Social Client who would be willing to share? (cc: @ArnaudL)

Cheers,

[ArnaudL]

Thanks for pinging me on this one @JulieHamel ! Yes it has been done before by The Social Client. Even if he is newly more into IA projects i'm sure @sakkaoui (CIO The Social Client) would be happy to share here !

FYI this counter integration has been fully demonstrated at LiNC2015 during a breakout session : look at the picture below, counter and Stéphane are on top 😃

https://forum.sfr.fr/t5/Anniversaire-du-forum/bd-p/2-ans-merci

[christophertsan]

I'm working with Anthony and is team on getting this up and running.  From my understanding, it's as simple as using the link you provided, but changing the domain and username accordingly. Is that it?

http://forum.telus.com/restapi/vc/users/login/Christopher/kudos/received/count?restapi.response_form...

Should this just work  "out of the box"?

[christophertsan]

Hi @ClaudiusH Is this an API available on all lithium communities? DO I need to enable it within out TELUS domain to have it active?  

[ClaudiusH]

Hi @christophertsan,

Yes, this API is available on all Lithium Communities, but you might not have API read access permissions enabled for the default anonymous user. You would need to do this as the Smiirl client would contact your community as an anonymous user. If you don't want to grant API read permissions to everyone you would need to go the route of creating an endpoint.

[christophertsan]

Thanks @ClaudiusH.   Some of this is over our head.  If I'm understanding this correctly, this is an existing rest call we can make.

Example for my username on our forum: http://forum.telus.com/restapi/vc/users/login/Christopher/kudos/received/count?restapi.response_form...

However, as you can see if you test it, it says not allowed.

I'm assuming you mean I need to make this API readable publicly - is this within the Community Admin? I've been searching, and can't find anything related, other than creating an API app.  

Can you help us further?  Thanks.

[CarolineS]

Oh my goodness, I need one of these! I sort of want to send them as swag to some of our top users - as well as having one on my desk :-D. 

[christophertsan]

@ClaudiusH Hey Lithium team, hoping someone can still help. We can't get this working because Smiirl is requesting a very specific format for the response, and as I understand it, the response Lithium provides can't be altered.  Did anyone get this working?

From Smiirl: "I am afraid the only format our Counter can accept is the following: {"number":1}. You cannot, unfortunately, use the following response : {"response":{"status":"success","value":{"type":"int","$":34}}}.

I don't know if you took a look at the following documentation, to build you JSON url: https://medium.com/@m_nebra/bootstrapping-your-company-counter-22f5d4bc7dd4 "

Smiirl is expecting a response formatted as such: {"number":2}

How can this be accomplished?