question

robert-jerina115 avatar image
robert-jerina115 asked robert-jerina115 answered

HipChat integration with RingCentral?

We use HipChat internally for our inter-organization communication. We have a lot of things that integrate with it including Zendesk and OpsGenie. I haven't been able to find any information or even interest in integrating with HipChat though. How hard would it be to do this? Basically the only thing I am looking for is incoming calls to certain groups in RingCentral send an alert to that group's chatroom in HipChat with CallerID info and number.


We used to have this with our custom phone system but lost it when we moved to our previous provider and many people keep requesting that feature's return.


Thanks!

integrations
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

kim avatar image
kim answered
Please direct this to the Developers Community in the upper right corner for this API.  
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

robert-jerina115 avatar image
robert-jerina115 answered
Can you move it? Or do I have to double post :P
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

benjamin-dean avatar image
benjamin-dean answered
Hello Robert,

RingCentral currently hasn't built an official HipChat integration. The good news is you can use your RingCentral account to develop this integration and tailor it to suit your needs. We (RingCentral Developer Relations Team) will be here to guide you, answer your questions, and will work with you to get your app into production so you can be the hero who delivered this valuable integration for your company.

It looks like the most common language between the RingCentral Connect Platform and Atlassian's Marketplace is Node.js. You could use their KOA app as a starting point ( https://bitbucket.org/atlassianlabs/ac-koa-hipchat) and then include the RingCentral Node.js SDK 'npm install --save rcsdk'. If you're not a Node.js developer, the other common languages you could use are: Python, Android, PHP, C#.

Complete list of RingCentral SDKs on Github:  https://github.com/ringcentral
Complete list of Atlassian SDKs:  https://www.hipchat.com/docs/apiv2/libraries

Here is how you can get started...
  1. Read the RingCentral Developer Tutorials (https://developers.ringcentral.com/library/tutorials.html)
  2. Login to the Developer Portal at (https://developers.ringcentral.com/login.html)
  3. You'll need a place to host your app code and to define your app's RingCentral Redirect URL
  4. Register a new app (in your case: HipChat Call Poster)
  5. Create a Sandbox Account (used for development of your RingCentral Integration)
Here is a list of useful RingCentral Developer Resources including our API Explorer, links to our SDKs, and video tutorials:  http://ringcentral.github.io/

If you have any questions about developing your app with RingCentral, feel free to ask it in our developer community:  https://devcommunity.ringcentral.com/ringcentraldev

Next, you'll want to:
  1. Register as a developer on Atlassian's Marketplace at (https://id.atlassian.com/signup) if you haven't already
  2. Decide if you want to make an Ad-Hoc or Independent Add-On and follow the guide at (https://www.hipchat.com/docs/apiv2), I'm guessing you'll want the Independent Add-On (so you can share this with others later)
  3. You'll need a place to host your app code and to define your app's Atlassian Redirect URL and 
  4. Create a new app at (https://marketplace.atlassian.com/manage/plugins/create)
Since you're wanting to receive call information for a group, you'll need to have your app subscribe to the presence information for the extensions within that group. I wrote an article will show you how to subscribe to the presence event data for multiple extensions:  https://devcommunity.ringcentral.com/ringcentraldev/topics/fyfygcftg

1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

charles-robert-watson151 avatar image
charles-robert-watson151 answered benjamin-dean commented
I have the same need, but for integrating Zoho SalesIQ chats with RC so that we can ask, in chat, for a website visitor's phone number, click it, and have RingCentral make the call. I'm not that familiar with Zoho's APIs (yet), though. Hopefully someone in this thread has insight into whether this is possible with SalesIQ.
1 comment
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

benjamin-dean avatar image benjamin-dean commented ·
Hey Charles,

Will you be developing this integration yourself?
0 Likes 0 ·
robert-jerina115 avatar image
robert-jerina115 answered
Will the account being used to detect calls coming into the system really need to have administrator privileges? That is what our developer is telling us... That seems silly.
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Developer sandbox tools

Using the RingCentral Phone for Desktop, you can dial or receive test calls, send and receive test SMS or Fax messages in your sandbox environment.

Download RingCentral Phone for Desktop:

Tip: switch to the "sandbox mode" before logging in the app:

  • On MacOS: press "fn + command + f2" keys
  • On Windows: press "Ctrl + F2" keys