didacticiel m-shoutbox full

Didacticiel surcas d'usage :

La M-Shoutbox de l'API SMS

Loïc MAUROIS – Orange Business ServicesV1.1 Full 14/12/2009

Sommaire

Qu'est-ce-qu'une M-Shoutbox ?

Comment configurer sa M-Shoutbox ?

Comment inviter des contacts ?

Comment discuter avec ses contacts ?

Comment administrer ses contacts ?

Pour aller plus loin…

Shoutbox is great !

Introduction

Une Shoutbox (anglicisme pour "boîte à discussion") est un système de messagerie instantanée, intégré dans une page Web qui permet aux internautes de laisser des messages et dialoguer sur le site Web.

La M-Shoutbox vous permet de contacter par SMS un ensemble de personnes qui sont inscrites dans votre shoutbox, voire de dialoguer avec eux. La M-Shoutbox repose sur l'API SMS d'Orange Api Zone.

Une M-Shoutbox est identifiée par un mot-clef que l'on envoie par SMS à un numéro court avec son message.

Cas d'usage

La M-Shoutbox peut être utilisée de plusieurs façons :

Vous voulez contacter un ensemble de personnes très rapidement par SMS.• Inscription des téléphones de vos contacts via une page web.• Envoi des SMS via un numéro court non surtaxé ou via une page web.• Tous les auditeurs reçoivent le SMS.

Vous souhaitez créer une boîte de discussion par SMS. • Invitation des contacts par SMS.• Inscription des dialogueurs par SMS et mode d'emploi envoyé par SMS.• Envoi des SMS par tous les contacts via un numéro court non surtaxé.• Tous les contacts reçoivent le SMS (y compris l'émetteur).

Il est possible d'avoir des dialogueurs et des auditeurs dans la même M-Shoutbox.

Phase I : Configuration de la M-Shoutbox

Pré requis : – Un compte provisionné sur Orange API Zone– Un serveur PHP 5 accessible sur Internet– Un peu d'indulgence envers le rédacteur de

ce didacticiel ;)

Phase I : Configuration de la M-Shoutbox – partie Orange API Zone

John Smith est l'administrateur de la M-Shoutbox (typiquement un membre d'association sportive, de crèche, de centre aéré, d'une association loi 1901, …).

John Smith possède un compte d'utilisateur des Api Instant (disponible sur www.orangeapizone.com). C'est lui qui provisionne le compte Orange Api Zone.

John Smith configure la SMS API zone, et renseigne • le mot-clef de sa M-Shoutbox (ici "shout")• l'URL de redirection des SMS, en clair l'URL de son serveur PHP.

John Smith

http://www.orangeapizone.com/

Phase I : Configuration de la M-Shoutbox – partie PHP

John s'y connaît un peu en PHP, et dispose d'une zone d'hébergement et d'un serveur PHP 5 accessible sur Internet.

John a installé le package "M-Shoutbox" sur son serveur PHP 5.

John va sur la page de configuration de sa M-Shoutbox :

http://<myserver.mydomain>/mshoutbox/index.php<?php?>

http://<myserver.mydomain>/mshoutbox/index.php


John configure la M-Shoutbox, et saisit son Access Key, et son mot-clef, issus d'Orange API Zone.


Ca y est ! John a configuré la M-Shoutbox ! Le serveur est prêt à recevoir les SMS entrants, et traiter les SMS sortants.Le serveur lui indique donc comment utiliser le service par SMS …


Phase II : Inscriptions et invitations dans la M-Shoutbox

Pré requis : – Phase I achevée !– Un peu de crédit sur son compte

OrangeAPiZone

John Smith souhaite s'inscrire dans la M-Shoutbox :il envoie son SMS au 31244.

… enregistre le nouveau contact…

… et envoie par SMS- une confirmation d'inscription- un "guide d'utilisation" par SMS.

31244

Le serveur PHP trace chaque appel entrant et sortant …

1

2

3

Phase II : Inscription par SMS

<mot-clef> <son téléphone> <son pseudo>

John Smith invite son ami Jason Mac Lane dans la M-Shoutbox : il envoie son invitation au 31244.

31244

12

3

Phase II : Inscriptions et invitations par SMS

Le serveur fait suivre l'invitation à Jason en lui indiquant la marche à suivre pour s'inscrire dans la M-ShoutboxLe serveur indique à John que son invitation a bien été envoyée.

<mot-clef> + <le numéro de Jason>

Jason Mac Lane

Jason Mac Lane répond à l'invitation : il envoie son SMS au 31244.

31244

Le serveur enregistre le nouveau contact, et lui envoie par SMS :

-une confirmation d'inscription- un "guide d'utilisation".

1

2 3

Phase II : Inscriptions et invitations

<mot-clef> <son téléphone> <son pseudo>

John souhaite ajouter d'autres membres, mais sans les inviter. Il passe par la page d'administration PHP:

Phase II : Inscriptions par la page d'administration




John saisit les pseudos et téléphones de ses contacts, il peut en ajouter autant qu'il lui plaira.

John ajoute ses contacts…

Le serveur enregistre les nouveaux contacts, mais ne leur envoie pas de SMS de confirmation, ni de "guide utilisateur". Le serveur ne connaît pas les données techniques (alias) de ces contacts. Les contacts seront auditeurs de la shoutbox. En théorie, ils ne peuvent pas émettre sur la M-Shoutbox.


John a saisi les pseudos et téléphones de ses contacts.


Phase III : Discussions via la M-Shoutbox

Pré requis : – Phase II achevée !– Un peu de crédit sur son compte

OrangeAPiZone

John décide d'envoyer un message au groupe : il envoie son SMS au 31244.

Phase III : Discussions

<mot-clef> <le message de John>

31244

Le serveur envoie le message à tous les contacts. Il a reconnu que le SMS provenait de John…

Jason répond au message : il envoie son SMS au 31244.

Phase III : Discussions

<mot-clef> <la réponse de Jason>

31244

Le serveur renvoie la réponse de Jason à tous les contacts

Répondre

John souhaite lancer un message au groupe, mais n'a pas son téléphone, ou souhaite simplement envoyer une information sans attendre de retour.il passe par la page d'administration PHP:

Phase III : Initier une discussion par la page admin


John tape son message et l'envoie :

Phase IV : Administration par la page d'administration


Finalement, la séance de ce soir est annulée pour cause de grippe A.

Le serveur envoie le message de la part de John à tous les contacts

Phase IV : Administration de la M-Shoutbox

Pré requis : – Phase II / III achevée !– Un peu de crédit sur son compte

OrangeAPiZone

31244

Grâce à son téléphone, John peut administrer à distance sa M-Shoutbox : il envoie des commandes par SMS au 31244 pour :

• Inviter de nouveaux contacts

• Supprimer des contacts desa M-Shoutbox

•Envoyer une commande d'aide à lui-même ou ses contacts

Phase IV : Administration via SMS

<mot-clef> + <Le téléphone de Kate>

<mot-clef> - <Le téléphone de Jack>

<mot-clef> ? <Le téléphone de Jason>

John souhaite supprimer des membres de sa M-Shoutbox. Les membres ne font plus partie du club, ou ne souhaitent plus recevoir de SMS.il passe par la page d'administration PHP:



John choisit le nom ou le téléphone du contact à supprimer,



Le contact est automatiquement supprimé de la M-Shoutbox.

Conclusion

Avec finalement très peu de connaissances en PHP,

John a réussi à configurer sa M-Shoutbox,

Il peut joindre facilement et rapidement, un ensemble de contacts. Certains contacts peuvent également en faire de même.

D'autres contacts peuvent suivre le fil de la discussion sans intervenir.

Des personnes peuvent être ajoutées à tout moment.

Ou supprimées très facilement.

La M-Shoutbox est plus rapide, plus économique qu'un nombre équivalent de coups de téléphone pour diffuser une information, et c'est à la portée d'un enfant de 12 ans !

Pour aller plus loin…

Loïc MAUROIS – Orange Business Services

Les évolutions sont multiples !• Pouvoir gérer plusieurs M-Shoutbox sur le même serveur PHP, en gérant un mot-clef différent par groupe de contacts !• Réceptionner des tweets, et les rediriger sur des listes de contacts !• Gagner de l'argent grâce à la M-Shoutbox en utilisant un numéro de téléphone surtaxé au lieu du numéro au tarif SMS.• Etc, etc, etc…

Plus d'info sur l'API SMS : Orange API

http://www.orangepartner.com/site/frfr/access_orange_apis/instant_apis/sms_api/p_sms_api.jsp

didacticiel m-shoutbox full

Technology