RHUB
  Contact About FAQ Blog
Call 408-899-2831
Home   Products   Customers   Buy   Partners   Support   Register for Webinars
 
 

 

Integration with the RHUB Web Conferencing & Remote Support Solutions

 
The following is a set of interfaces to integrate the RHUB server with your web or Windows based applications and audio conferencing.

  1. Web-based APIs to start and join a meeting
  2. Embed a web viewer into your web page
  3. Windows-based APIs to start and join a meeting
  4. The URL to publish scheduled public meetings
  5. The interface to integrate with your audio conferencing bridge or service
  6. User authentication via your application server (e.g., CRM server, LDAP)
  7. Direct integration with LDAP
  8. Integrate webinar registration with your website
  9. Integrate with your PBX

If you are an application software vendor, you may want to embed some functions in your software to facilitate your customers for the TurboMeeting integration. You are welcome to contact RHUB for integration support

 
Web-based APIs to start and join a meeting
You can call the following two URLs to start and join a meeting.
  • URL to start a meeting

  • http://your_meeting_server_address/as/wapi/goto_downloader?role=host&email=xxx&user_password=yyy

    where "xxx" is your email address and "yyy" is your password. If you are concerned with the password displayed in the URL, leave the password value empty. The TurboMeeting client software will ask users to input the password.

     
  • URL to join a meeting
  • http://your_meeting_server_address/as/wapi/goto_downloader?role=attendee&name=xxx&meeting_id=yyy&password=zzz&sumbit=submit

    where "xxx" is your name,  "yyy" meeting ID, and "zzz" meeting password.

 
Embed a web viewer into your web page
You can use frame (or iframe) to embed a web viewer into any of your web page by the following URL:

http://your_meeting_server_address/id=yyy&name=xxx&password=zzz

where "xxx" is your name,  "yyy" meeting ID, and "zzz" meeting password.

 
Windows-based APIs to start and join a meeting

You can place Start and Join Meeting buttons in your Windows based application and let users launch TurboMeeting meetings just from your application.

The following is a suggested workflow:

  1. Test if TurboMeeting has been installed. If not, call the web-based APIs to let users start and join meeting from the web. After this first-time web-based API call, TurboMeeting is installed.
  2. If TurboMeeting is installed, find the TurboMeeting.exe path, generate a temporary file called "Command File" to contain the parameters needed by TurboMeeting and execute the following DOS command line:

TurboMeeting-Path --cmd Command-File-Path

For example,

C:\Documents and Settings\Administrator\Application Data\TurboMeeting\TurboMeeting\TurboMeeting.exe --cmd c:\MyApplication\LaunchTM.txt

Depending on the values in the Command File, the above will start or join a meeting. After TurboMeeting is launched, the Command File will be removed by TurboMeeting in order to keep the parameters inside the file secured.

You can find the TurboMeeting.exe path by clicking "Start", "All Programs", and "TurboMeeting". Then right-click "Start Meeting" and select "Properties". The property dialog displays the TurboMeeting.exe path. Another quick way to find the TurboMeeting.exe path is to right-click the TurboMeeting icon on your desktop and then select "Properties". However, the desktop icon can be easily removed by users.

 The TurboMeeting.exe path should be programmatically retrieved by your application. Click here to download a sample written in VC++.

The Command File is defined in an XML format. Below are two samples, one for joining a meeting, the other for starting a meeting:

Join a Meeting:				
<Action>Join</Action> 
<ServerAddress>turbomeet.com</ServerAddress> 
<ServerPort>80</ServerPort> 
<MeetingPassword>123</MeetingPassword> 
<MeetingId>8813-7455</MeetingId> 
<AttendeeName>Brian Smith</AttendeeName> 
<Email></Email> 
<UserPassword></UserPassword> 
<MeetingType></MeetingType> 
<StartMeetingNow>Y</StartMeetingNow>  
<StartAtMinimized>Y</StartAtMinimized>  				
Start a Meeting:
<Action>Host</Action> 
<ServerAddress>turbomeet.com</ServerAddress> 
<ServerPort>80</ServerPort> 
<MeetingPassword></MeetingPassword> 
<MeetingId></MeetingId> 
<AttendeeName></AttendeeName> 
<Email>johdoe@aceme.com</Email> 
<UserPassword>password</UserPassword> 
<MeetingType>0</MeetingType> 
<StartMeetingNow>Y</StartMeetingNow>  
<StartAtMinimized>N</StartAtMinimized>  				
The values of the XML elements are defined below:

<Action>: "Host" if it is to host a meeting. "Join" if it is to join a meeting

<ServerAddress>:  The TurboMeeting server address

<ServerPort>: One of the available TurboMeeting server Ports: 80, 443 or 8889. Fill in 80 if it is available.

<MeetingPassword>: Meeting password, used only when Action = Join

<MeetingId>: Meeting ID, required when Action = Join.

<AttendeeName>: Attendee name, required only when Action = Join

<Email>: The host email address, required only when Action = Host

<UserPassword>: The host password at the TurboMeeting server, required only when Action = Host

<MeetingType>: "0" for Interactive Meeting; "1" for remote support; "2" for remote access; "3" for seminar. This is required only when the Action is Host.

<StartMeetingNow> "Y" to start a meeting right away; "N" to start TurboMeeting and sign in. This is required only when Action = Host

<StartAtMinimized>: "Y": minimize TurboMeeting when started; "N": display the TurboMeeting control panel when started. When Action = Host, it should be "N" so that the meeting Host can read the Meeting ID from the meeting panel and invite attendees.

 
The URL to publish scheduled public meetings

You may want to publish some scheduled meetings on your website so that visitors can easily join the meetings such as a sales or training seminar. The steps below show you how to publish those meetings on your website.

  1. Schedule a meeting. On the schedule meeting dialog, check the "To be published"


  2. publish meetings

  3. Login to the web console and click "Manage Meetings". Look for the section "The URL to publish the scheduled public meetings in HTML". You can also use "The URL to publish the scheduled public meetings in XML", which will give the flexibility to integrate the list of scheduled meeting with any of your applications.
  4. Paste the URL on your website. To embed the list of scheduled meetings into your web page, use iFrame.

 

 
The interface to integrate with your audio conferencing bridge or service

You can integrate with TurboMeeting any audio conferencing services including your own audio conferencing bridge. The integration is as easy as inputting a call number to the TurboMeeting system. The call number is shown in your meeting invitation messages and the TurboMeeting meeting control panel automatically.

Follow the steps below:

  1. Login to the web console
  2. Click the "Manage Meetings" link
  3. Look for the audio conferencing integration section. Check the option "My audio conferencing number" and input your audio conferencing number.
  4. If you would like to use TurboMeeting ID as the audio conference code, check "Use Meeting ID as the audio conference Access Code".

    audio conferencing integration

 
User authentication via your application server (e.g., CRM server, LDAP)

To facilitate the TurboMeeting deployment to all employees in your organization, you may want to use your own server to do the user authentication. For example, you can use your CRM system or LDAP to authenticate TurboMeeting users so that you can manage users in a single system.

In order to do the integration, you need to set up an adapter, which is a web server to

1. Accept a user authentication URL call from the TurboMeeting server

2. Parse the URL and send a user authentication request to your server

3. Based on the response from your server, return a proper response in XML to the TurboMeeting server.

The parameters in the URL calling from the TurboMeeting server are:

email The email address that a user inputs to a TurboMeeting client. Note that the email address can be any string, for example, a user name. It depends on the user authentication format of your server.  
password The password that a user inputs to a TurboMeeting client. Note that the password is secured between TurboMeeting client and server via both proprietary encryption and SSL encryption. The transmission of the password between the TurboMeeting server and your server  can be encrypted by SSL if you instructs the TurboMeeting server to use a HTTPS user authentication URL.

The response from your server to the TurboMeeting server should follow the format below:

 <__Return__>
<__Status__>SUCCEED</__Status__>

<__Reason__></__Reason__>
<__FirstName__>John</__FirstName__>
<__LastName__>Doe</__LastName__>
<__Phone__>408-939-2919</__Phone__>
<__UserId__>2910-21202</__UserId__>

<__IsAdministrator__>Y</__IsAdministrator__>
<__PrivilegeInteractiveMeeting__>Y</__PrivilegeInteractiveMeeting__>
<__PrivilegeSeminar__>Y</__PrivilegeSeminar__>
<__PrivilegeRemoteSupport__>Y</__PrivilegeRemoteSupport__>
<__PrivilegeRemoteAccess__>Y</__PrivilegeRemoteAccess__>
<__PrivilegeSendFile__>Y</__PrivilegeSendFile__>
<__PrivilegeChat__>Y</__PrivilegeChat__>
<__PrivilegeRecord__>Y</__PrivilegeRecord__>
<__VideoConference__>Y</__VideoConference__>
<__UserGroupName__></__UserGroupName__>
</__Return__>

where

<__Status__> has a value of either SUCCEED or FAILED depending on whether the user authentication succeeds or not.

<__Reason__> needs a value when the Status is FAILED. The reason for failed user authentication will be displayed to TurboMeeting users.

<__FirstName__> is the first name of an authenticated user.

<__LastName__> is the last name of an authenticated user.

<__Phone__> is the phone of an authenticated user.

<__UserId__> is the user ID of an authenticated user in your server.

<__IsAdministrator__> has a value of either "Y" or "N" depending on whether the user is a system administrator.

<__PrivilegeInteractiveMeeting__> has a value of either "Y" or "N" depending on whether the user can hold an interactive meeting.

<__PrivilegeSeminar__> has a value of either "Y" or "N" depending on whether the user can host a seminar.

<__PrivilegeRemoteSupport__> has a value of either "Y" or "N" depending on whether the user can hold a remote support session.

<__PrivilegeRemoteAccess__> has a value of either "Y" or "N" depending on whether the user can host a remote access session.

<__PrivilegeSendFile__> has a value of either "Y" or "N" depending on whether the user can send files during a meeting session.

<__PrivilegeChat__> has a value of either "Y" or "N" depending on whether the user can chat during a meeting session.

<__PrivilegeRecord__> has a value of either "Y" or "N" depending on whether the user can record during a meeting session.

<__VideoConference__> has a value of either "Y" or "N" depending on whether the user can do multipoint webcam based video conferencing during a meeting session.

<__UserGroupName__> defines the user group this user belongs to.

After you set up the integration adapter, you need to tell the TurboMeeting server your user authentication URL:

1. Go to your TurboMeeting server web administration console

2. Click the "Application Server" link under the Integration section. You will see the following page:

integration

On the page, input your user authentication URL to accept calls from the TurboMeeting server. You can use either HTTP or HTTPS. However, if you use HTTPS, make sure your adapter response HTTPS header contains the field "Content-Length".

Do not add any parameters in the URL. The TurboMeeting server will attach two parameters to your URL and the final URL calling your adapter will be like:

http://ldap.acme.com/authentication.aspx?email=johndoe@aceme.com&password=test

You can choose to have the TurboMeeting server cache user passwords. With cached passwords, when your adapter is down, the TurboMeeting server will conduct the user authentication independently based on the previous successes. The cached passwords are irreversibly encrypted and saved in the TurboMeeting server database.

If you want to delete a user profile from the TurboMeeting server, your adapter returns <__Status__>Deleted</__Status__><__UserID__>xxxx</__UserID__> where xxxx is the unique user id in your server for the user. The user id, which is a part of authentication return, is saved at the TurboMeeting server after successful authentication. You can also manually delete the user profile using the web-based administration console.

 
Direct integration with LDAP
You can easily integrate RHUB servers with your LDAP servers including Active Directory servers for user authentication. You just fill in one form and it is done (see the figure below).

Note that if your LDAP supports multiple domains, use the port 3268.

LDAP integration

 

 
Integrate webinar registration with your website
 

All RHUB servers come with a webinar registration function to facilitate your webinar hosting. The webinar registration function allows you to:

  1. Create and edit webinars
  2. Publish webinars together with a registration form
  3. Collect registrations, which can be exported to an Excel sheet.

There are two ways to integrate the registration form to your website: use the system built-in webinar registration page or embed the registration form into your own web page.

1. Use the system built-in webinar registration page

Goto the "Webinar Registration" section on your web-based admin console and open "URLs". You will see three URLs shown in the figure below. Choose the first URL and publish it on your website.

webinar management

2. Embed the registration into your own web page

Open the third URL shown in the above figure and you will see a page like the following one. Follow the instruction and you can build a completely customized webinar registration page. See a live sample at the RHUB website:

http://www.rhubcom.com/v4/web_conferencing/webinar_registration.html

webinar registration page

 
 
Integrate with your PBX

You can integrate your RHUB web conferencing server with your PBX so that callers from your PBX and attendees using headsets with TurboMeeting can have audio conferencing together while sharing desktops. The audio together the presenter's screen updates can be recorded. The integration offers you a number of benefits.

The integration needs the RHUB support staff to assist. Please contact us for the integration.

Note that at this moment, the integration requires your PBX to open a set of UDP ports to a trusted RHUB server so that the RHUB server makes proper connections between your appliance and your PBX. The RHUB server essentially works as a SIP session border controller. The service provided by the RHUB server is part of our product warranty service. There is no extra change for it. If you cannot meet the open-port requirement, the integration does not work for you for now.