• Loading...

Getting started using the Ribbit developer platform

Welcome to the Ribbit Developer Platform Getting Started guide.

2. Get Your 25 USD Free Credit with CodeFest

There are some features you can use freely like starting Application, login, Calls to Toll-Free Numbers, Access to various APIs and SDKs while for others like Make/Receive/Record Call, Send SMS, Voice Mail, voice to text transcription, collect DTMF tones etc. You need to establish a billing relationship with Ribbit.

To help you get started using the platform features and services, Ribbit is offering developers a 25 USD Free Credit for all codefest participants. To Get free 25 USD for application development for RAD follow instructions given below

  • Step 1. Register yourself on the CodeFest Website.
  • Step 2. Create a team for RAD through teams page. Creating team involves providing a name for the team & the codefest username of your teammate (in case the owner wants a member in his team).
  • Step 3. A notification appears on the teams page to submit the ribbit username and ribbit account id of the team's owner. Ribbit Username has to be obtained by the team owner by registering at Ribbit Developer Portal with the same emailId that was used to register at CodeFest. Ribbit Account Id can be obtained from your ribbit profile page after logging in.
  • Step 4. When the Ribbit username is submitted, a notification will appear on the teams page that your request to claim 25$ is in the process and it may take 24-36 hours to get the credit.
  • Step 5. Based on the owner's email id, username & account id, 25$ will be credited to the account and an email notification will be sent with further details.

3. Start Building Your Application

You can then develop multiple applications and assign multiple users under one developer account. You'll insert each application's unique credentials and configuration into the code while developing the application. Follow the given instructions to create an application under your profile :

  1. Login to your Ribbit Developer Account.


    Ribbit login page
  2. From the Developer Portal, select the My Apps tab and click Start an App.


    start an app
  3. The Project/App Name is how your app will be known in the Ribbit system. Fill out all required fields.

    App form
  4. Click Submit to create your new app and add it to the My Apps tab, where you can access your information and make changes later.

4. Configure Your App

This page contains important information you'll need while coding your application. It also provides instructions for adding users and configuring other details about your application.


  1. The App ID is used when coding your app with Ribbit's APIs. See the sample apps in each Dev Center to see where this data is required, generally it will be a properties file having data mentioned on the page.
  2. The Secret Key is used when coding your app with Ribbit's technologies, The Ribbit platform requires this data so that it knows which app is accessing the service with given credentials.

5. Add Users

Once your app is set up, you'll be able to give multiple users (including yourself) access to Ribbit services.

  1. From the App configuration page, click Users in the left menu. Enter the first name, last name, and email address of each new user.
  2. From here, you can also edit existing users' access information, including your own. (see Edit Users)
  3. Once a user is created, you can add a purpose number to that account. This is a specially assigned number from the Ribbit system that will allow the outside world to call the user designated in the Ribbit system.
  4. A token is special piece of configuration code that lets you build an embeddable widget on behalf of your user that will allow customers to call that user through a Web page. (see Add Token)
  5. You can remove users from an app by selecting Remove.

6. Edit Users

This page, accessible through the Add Users page, lets you modify details for individual users.

  1. Click the Edit User icon next to the user name in your application to edit that user.
  2. You can reset a user's password here. The user will receive an email prompting him or her to reset their password.
  3. This form also allows you to request a purpose number for an individual user.
  4. Selecting the Remove from Billing option will preserve a user and his or her data, but prevent that user from accessing Ribbit features and logging into your app in the future.
  5. Adding transcriptions (voice-to-text feature for voicemail and messages) is still a manual process. You can request it here.
  6. You can enable or disable voicemail and missed call notifications here. This will toggle your user's ability to receive emails from the Ribbit system.
  7. You can also request tokens for a user from this form. (See Adding Tokens)

7. Adding Tokens

A token is special piece of configuration code that lets you build an embeddable widget on behalf of your user that will allow customers to call that user through a Web page.

  1. You can add tokens for users from either the Add User or Edit User pages.
  2. You must select the source phone number for the token, which can be the purpose number assigned to the user. This number will appear as the Caller ID when the user's number is called through a token-enabled app.
  3. You can request a purpose number to populate the CallerID field.
  4. Currently, there is only one available token type: YouPhone.
  5. The number to call, or destination number, is the number that will ring when a call is made from the token-enabled app.

8. Pricing Details

Ribbit Platform pricing is based solely on usage. No hidden fees, no packages, it's simply pay as you go. You can purchase any amount of credit to use the Ribbit network, infrastructure, communications features and services to meet your application development needs. You as a Participant of RAD in codefest will get free credit of 25 USD for application development in first round.

Monthly Recurring Charges

Price (USD)

Purpose Numbers (US or UK)

$3.00

Voicemail Box  

FREE

Usage Charges

 

Outbound Calling (per minute)

Pricing

Inbound Calling (per minute)

FREE

Automated Voice-to-Text Transcriptions (per 30 seconds)

$0.10

Outbound SMS Text Messaging (per message)

$0.03



10.Manage Your Developer Profile

Once you've created a developer account, you can modify almost any detail about yourself and how you plan to work with Ribbit.

  1. You can view this page by selecting My Profile from the Accounts tab on the Developer Portal homepage.
  2. If you've requested a purpose number for your developer account (requires $3), which you can do from the Add User, Edit User, or Add Tokens pages, that number will appear here. This number lets you test incoming calls in your app, and send messages directly to your Ribbit voicemail.
  3. To access your Ribbit voicemail, use the pilot number mentioned on this page.
  4. You can toggle your account's ability to receive email notifications and SMS messages from the Ribbit service here.

11.Start Coding

Now that your account is set up, you're ready to code Ribbit into your application. Ribbit offers a variety of platform technologies for you to use, each with their own benefits and features. While general and even advanced familiarity with a platform technology is helpful, Ribbit has designed its code samples and documentation to assist all levels of developers in getting started with their Ribbit applications. Ribbit Provides 7 APIs for application development

  1. REST
  2. PHP
  3. FLASH/FLEX
  4. JAVA
  5. JAVASCRIPT
  6. SILVERLIGHT
  7. .NET

12.Getting Support

  1. Ribbit Developer Forum is the best place to engage the community for solutions, ideas, and general support. The forum is frequently visited by team members, platform specialists, and engineers.
  2. You can also post your doubts at CodeFest RAD forum.
  3. You can write your queries and ideas to codefest@itbhu.ac.in with subject [Ribbit Support].