Docs Icon


Telesocial - Social Calling API Introduction

Telesocial - Social Calling API

Our free social calling API enables mobile calling in social networks.  No phone numbers, no cost, high security and huge scale.

We can offer our API for free (US Mobile Only!) since we are partnered with telecommunications network operators.

Telesocial makes integration simple for developers by making communications as easy as:

                                            Facebook: john call bill susie joey

                                            Twitter: @john call @bill @susize @lucy @steve

For users, Telesocial is like a firewall for your mobile phone number, protecting it from the social web.  Now you can integrate mobile phones to social networks at massive scale.  

Telesocial supports RESTful methods and a delivers a rich but simple communications framework for to integrate with today’s app platforms. 

How does it work?

Telesocial is a security and routing system for social networks and mobile phones in the context of the developer's application on:

Facebook iOS Google+ Twitter LinkedIn Yammer Box Minecraft Email


Telesocial manages all of this by authenticating devices to users using applications.  Once authorized, apps can then use mobile devices in a secure and anonymous way and at huge scale.


Developers can manage mobile calling features from social networks to mobile devices. 


Developers must first sign up and get an application key, i.e.:






The Telesocial API is a free and powerful system that enables mobile calling and advanced communications is safe for users and developers. It is best to think of Telesocial as a “Single Sign On” system for phone numbers and social networks. Telesocial provides a strong physical device challenge system to register phone numbers and map them to social networks and applications.  The system is self healing by using a device challenge mechanism and thus correct for phone number churn and loss or errors in mapping devices.


Telesocial provides a hard device registration mechanism that lets developers register users and devices and allow apps to communicate. The Telesocial API does not require hard authorization and physical challenge unless the user is new in the system or is using the challenge method.


As a best practice, getting the status for a user in the system will establish whether your application can use the user's mobile device, if it is unavailable, needs to be re-mapped to a different number etc., using status codes in this documentation.




User's anonymity is always preserved through the system in two ways-- caller ID is never exposed and even your own phone's voice mail is protected through our unique "Press 1" to accept a communication request. Calls should always be "opt-in" -- your phone shouldn't just ring --only when you tell it.


With an advanced API, your phone doesn't just ring -- something triggers the call, in an application, in a  social network, or on a mobile phone or online playing a game, but in reality a cascade of interactions may occur before any phones start ringing.  Users can now opt-in or choose how to accept communications through applications and ring phones when appropriate - not when it's annoying.

As a developer, you interact with the user’s communications devices as objects within the API based on their corresponding network ID’s, for example:


                                facebook         6815841748 call 658849357

                                twitter            @barakobama call @mittromney


Security within our API system won't let you do this, of course, unless both users have registered with your application and Telesocial -- just because you have an API key does not mean that you can just make @barakobama call anyone.  That is, unless he uses your app and has enabled calling.

Telesocial lets developers to integrate mobile calling with the social web.  it’s easy to call people and groups programmatically, without phone numbers and using only social names - free and anonymous.  The functions for Telesocial are simple word-based algorithms that do fun calling stuff using applications on social networks or in mobile applications. Actions like call, record, blast, and voicemail are some quick examples.  Telesocial works on Facebook, Twitter, LinkedIn,  iTunes to iOS devices, and Android.   Telesocial can be implemented in any language.

The pseudocode below demonstrates the simplicity and power of using Telesocial with any social network or application platform.

call ( 125318975235,1239812309)                                         Call two Facebook users 

Use cases:  call 2 players in a game, or a part of a social application on Facebook,

call ( 124835798375, 839482347, 7927123753, 1389572435) - Conference call 4 Facebook users 

Use cases:  call multiple people on a Facebook, party line, call a Group on FB and start a conference call, team call in a game, etc.

record (helloworld) -  Record message “helloworld”

Use cases:  record a message that you want to use later to broadcast to a group

blast friends ( 2491480137232.helloworld ) -   Send voice message “helloworld” to friends

voicemail (@the_real_shaq,@aplusk) -  Record voice message and forward to 2 Twitter users

blast followers (@aplusk.heyall)           Send voice message “@aplusk.heyall” to all Twitter followers

Upcoming services such as messaging and SMS, Location Based Services (LBS), payment gateways, video:

video followers (@aplusk)                   Start video streaming / video to all Twitter followers