1. Didacticiel sur cas d'usage : La M-Shoutbox de l'API SMS Loïc MAUROIS – Orange Business Services V1.1 Full 14/12/2009

2. 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 !

3. 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.

7. 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 &quot;M-Shoutbox&quot; sur son serveur PHP 5. John va sur la page de configuration de sa M-Shoutbox : <?php ?> http:// <myserver.mydomain> /mshoutbox/index.php

8. Phase I : Configuration de la M-Shoutbox – partie PHP John configure la M-Shoutbox, et saisit son Access Key , et son mot-clef , issus d'Orange API Zone. http:// <myserver.mydomain> /mshoutbox/index.php

9. Phase I : Configuration de la M-Shoutbox – partie PHP 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 … http:// <myserver.mydomain> /mshoutbox/index.php

12. John Smith invite son ami Jason Mac Lane dans la M-Shoutbox : il envoie son invitation au 31244 . 1 2 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-Shoutbox Le serveur indique à John que son invitation a bien été envoyée. Jason Mac Lane 31244 <mot-clef> + <le numéro de Jason>

14. 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 http:// <myserver.mydomain> /mshoutbox/index.php

15. Phase II : Inscriptions par la page d'administration http:// <myserver.mydomain> /mshoutbox/index.php John saisit les pseudos et téléphones de ses contacts, il peut en ajouter autant qu'il lui plaira. John ajoute ses contacts…

16. Le serveur enregistre les nouveaux contacts, mais ne leur envoie pas de SMS de confirmation, ni de &quot;guide utilisateur&quot;. 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. Phase II : Inscriptions par la page d'administration John a saisi les pseudos et téléphones de ses contacts. http:// <myserver.mydomain> /mshoutbox/index.php

18. John décide d'envoyer un message au groupe : il envoie son SMS au 31244 . Phase III : Discussions Le serveur envoie le message à tous les contacts. Il a reconnu que le SMS provenait de John… <mot-clef> <le message de John> 31244

19. Jason répond au message : il envoie son SMS au 31244 . Phase III : Discussions Le serveur renvoie la réponse de Jason à tous les contacts <mot-clef> <la réponse de Jason> 31244 Répondre

20. 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 http:// <myserver.mydomain> /mshoutbox/index.php

21. John tape son message et l'envoie : Phase IV : Administration par la page d'administration http:// <myserver.mydomain> /mshoutbox/index.php 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

24. 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: Phase IV : Administration par la page d'administration http:// <myserver.mydomain> /mshoutbox/index.php

25. John choisit le nom ou le téléphone du contact à supprimer, Phase IV : Administration par la page d'administration Le contact est automatiquement supprimé de la M-Shoutbox. http:// <myserver.mydomain> /mshoutbox/index.php

26. 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 !