home forums become a member Français
 
site search
our programme mobile apps & solutions other innovation APIs news & events


Contact Everyone API allows you – within your application – to send messages in more than 200 countries, via 4 medias: SMS, voice mail (fixed line or mobile), email and fax.

 

Similar APIs:

bullet SMS Internet API

bullet SMS API

Find out more on the Orange SMS APIs comparison pagelink arrow

Contact Everyone API

 

trial the APIbuy the API

  •     overview      
  •    technical features      
  •     pricing     
  •     development     

The Contact Everyone API enables you to develop applications that can broadcast information.
It enables you to communicate to more than 200 countries through the following media:


 SMS
 voice mail (fixed line or mobile)
 email
 fax

 

The Contact everyone API allows you to send and keep track of messages you have broadcasted through your application. This allows customers to benefit from an integrated service to improve productivity, optimise costs and develop end-user loyalty.


Using the Contact Everyone interface, you the developer, can manage broadcast strategies such as choosing the type of media, their order, number of attempts and how failures are to be treated.
The interface also provides statistical information.


benefits

The Contact Everyone API enables message broadcasting from your applications. Your customers can benefit from a new integrated service for improving productivity, control costs and increase end user loyalty.


The service is customisable according to your needs:

a modular communication solution At any time, you may call your business partner to request the activation of new delivery media.  This flexibility allows you to cope with evolving business requirements.
the service allows to schedule rules of broadcast Through the web interface, you can define a broadcast strategy, which includes, choosing the media , their order, the number of attempts and the treatment of failures.
free transfer option to a live person when recipients are done listening to their voice mail messages, the system can offer to put them through a preset number, free of charge.

 

See how others are using Contact Everyone...


example 1

A beauty company sends out an offer to its customers using the Contact Everyone API.  It's a promotional campaign via SMS and email.  This company also wants to send out an SMS, email and voice mail message to 10 top clients who have to reply using SMS to win a perfume.  They have to go to the shop and redeem their purchase within 3 hours of receiving the SMS.


example 2

A company has a sales force and want to send an important company announcement. To make sure everyone receives the information, a Contact Everyone API based application is used to communicate the message through all available media - SMS, email and voice mail.

example 3
 download the case study (in French)

supported protocols
 HTTPS
 Web Services, SOAP protocol
 MIME Multipart only and DIME for enclosed attachment management 


specific functions
A modular service to broadcast messages:
 by communicating to a recipient list using SMS, voice mail, e-mail and fax
 based on broadcasting policies defined by you
 on a scheduled basis receiving detailed broadcast reports


service delivery
The service is delivered through:
 a SOAP Web Service API for any connected application
 a web portal to set some parameters (media, strategies, etc...)


notification features by media:

voice mail

 Multi operators, international coverage, excluding special numbers
 voice mail based on
   - text (text to speech)
   - WAV file 8kHz mono, <2Mb
 « Success » based on pickup, full listening or acknowledgment by * or #

SMS  limited to 160 characters
 multi operators, international coverage
 SMS "classic" or "flash" (deleted after reading)
 « Success » based on transmission to terminal
e-mail  mail html
 attachment size limited to: 1Mb
 « Success », based on mail sent or read
fax  international, excluding special numbers
 based on text or file
 « Success » based on fax transmission



broadcasting logic

step 1

In the Web portal, define the broadcasting logic using a strategy:
A strategy defines the policy with chosen media, sequences and timers. 
For example: send at the same time an SMS, an email and if SMS fails then send a voice mail on fixed line.

step 2 Via the client application, define the recipient list and the message content.
step 3 Using the API, design a broadcast template which wrap-up message content, strategy and recipient list.


security
The message transport uses HTTPS with an SSL server certificate.
The authentication uses HTTP BasicAuth mechanism.
The identification uses 3 SOAP headers to be provided in each request.


limitation

The media broadcast is initiated from France by other countries. This means that broadcast will be in the form of an international call if used outside France.


(back to top)

The pricing structure is composed of following elements and indicative prices excluding VAT.


service activation (one off fees)
 API : 500 €
 Per Media: SMS, email, voice, fax (160 € / activated media)


service subscription (monthly recurring fees)
 API : 50 €
 Per Media : SMS, email, voice, fax (40 € / activated media)


service usage (billable usage depending on media type)
 SMS : per unit price (from 0,087 € to 0,33 € depending to geography)
 Email: per unit price (0,02  €)
 Voice towards fixed phones: per second from France price (from 0,07 € to 0,89 €
   depending to geography)
 Voice towards mobile phones: excluding first minute, per second from France price
   (from 0,28 € to 1,076 € depending to geography)
 Fax: per page (from 0,07 € to 0,818 € depending to geography)


Volume discounts on French domestic traffic for monthly service usage of minimum 1000 € / media.

development material

Development kits (libraries and documentations including code samples, covered by Apache 2 licence):

Java 1.5

zip icon Java development kitarrow (v 1.0.3)

includes binaries, documentation, reference manual and source files

pdf icon Java SDK manualarrow (v 1.0.3)

.NET 3.5

zip icon C# development kitarrow (v 1.0.3)

includes binaries, documentation, reference manual and source files

pdf icon C# SDK manualarrow (v 1.0.3)

You can also download the Orange API SDK on CodePlex. Especially, this global .Net SDK contains dedicated samples for this API.

PHP version 5

zip icon PHP development kitarrow (v 1.0.3)

includes binaries, documentation, reference manual and source files

pdf icon PHP SDK manualarrow (v 1.0.3)

 

Direct integration of SOAP WSDL:

WSDL integration

zip icon WSDL and integration documentarrow (v 1.0.3)
includes documentation, reference manual and exemples

pdf icon developer manualarrow (v 1.0.3)

 

Server certificate:

server certificate

zip icon SSL server certificatearrow

required for SSL authentication.

 

Using the API is simple. Just follow the steps below:

 

test the API

 

 Prerequisite: becoming Premium member

To test an API, you need to registrer in Orange Partner web site (member), and to become

   a Premium member.


 If you're not already an Orange Partner member, become one now, and make sure

   you tick the "Yes, I am interested in using Orange APIs" box on the membership

   form.

 

If you're already an Orange Partner member, sign in, and verify your account:
   tick the "Yes I am interested in using Business APIs" box.


To become Premium member, please complete the registration form (don't forget to tick

   « Please tick the box if you're a business based in France wishing to access

   trial and live APIs ») and enter your SIRET number.

 

If you are already Premium member, sign in, and verify your account: tick « Please tick

   the box if you're a business based in France wishing to access trial and live

   APIs » and enter your SIRET number.


  In both cases, you will receive an acknowledgement by email, and, in a few days, a

    confirmation of your Premium status.

 

Once Premium member, click on the "test" button above, to obtain the credentials needed to integrate the test API.

                                                      

Depending on your integration mode and development language, download above:

One development kit, for java, .Net or PHP, and the documentation.

The WSDL description and the direct integration guide.

Follow the instructions of the documentation above to integrate the API.

 

buy the API

You have tested the API... Happy with it?

 

Prerequisite: becoming Contracted member

Your account manager from Orange Business Services will present you advantages

   and terms of the Orange partnership, and the associated contract.

 

Once contracted partner, click on the "buy" button above, to obtain the credentials needed to integrate the test API.

 

Then, manage yours APIs, with the *** API manager *** left hand side menu.

 

(back to top)

please note...

 This API is only for use by
   companies based or having a
   subsidiary in France
 Please read the user guide
   (in French)

something not clear?

try the following...


 read the user guide

Please make sure you have a look at the user guide we've created. It takes you through the different stages of developing with this API.

download the user guide (in French)


 read the FAQs

Please make sure you have a look at the FAQs.

FAQs 


 use the discussion forum

We've set-up a discussion forum for all the APIs. Many of you are already using it.

Ask your question by creating a new topic, or have a conversation with other members using the APIs.

access the forum


still stuck?


 email us

Get in touch with us at developers@orange.com

download the Unified SDK

The unified SDK is the aggregation of all SDK developed for both Advanced and most Instant APIs.

This means that you can use the single Unified SDK to develop with APIs from both the families.

download nowlink arrow

related APIs

 Multimedia Conference API
 Device Capability Enabler API