Didacticiel M-Shoutbox Full
-
Upload
loic-maurois -
Category
Technology
-
view
1.388 -
download
1
description
Transcript of Didacticiel M-Shoutbox Full
![Page 1: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/1.jpg)
Didacticiel surcas d'usage :
La M-Shoutbox de l'API SMS
Loïc MAUROIS – Orange Business ServicesV1.1 Full 14/12/2009
![Page 2: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/2.jpg)
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 !
![Page 3: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/3.jpg)
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.
![Page 4: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/4.jpg)
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.
![Page 5: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/5.jpg)
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 ;)
![Page 6: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/6.jpg)
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
![Page 7: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/7.jpg)
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?>
![Page 8: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/8.jpg)
http://<myserver.mydomain>/mshoutbox/index.php
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.
![Page 9: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/9.jpg)
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
![Page 10: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/10.jpg)
Phase II : Inscriptions et invitations dans la M-Shoutbox
Pré requis : – Phase I achevée !– Un peu de crédit sur son compte
OrangeAPiZone
![Page 11: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/11.jpg)
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>
![Page 12: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/12.jpg)
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
![Page 13: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/13.jpg)
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>
![Page 14: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/14.jpg)
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
![Page 15: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/15.jpg)
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…
![Page 16: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/16.jpg)
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.
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
![Page 17: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/17.jpg)
Phase III : Discussions via la M-Shoutbox
Pré requis : – Phase II achevée !– Un peu de crédit sur son compte
OrangeAPiZone
![Page 18: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/18.jpg)
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…
![Page 19: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/19.jpg)
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
![Page 20: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/20.jpg)
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
![Page 21: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/21.jpg)
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
![Page 22: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/22.jpg)
Phase IV : Administration de la M-Shoutbox
Pré requis : – Phase II / III achevée !– Un peu de crédit sur son compte
OrangeAPiZone
![Page 23: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/23.jpg)
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>
![Page 24: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/24.jpg)
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
![Page 25: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/25.jpg)
John choisit le nom ou le téléphone du contact à supprimer,
Phase IV : Administration par la page d'administration
http://<myserver.mydomain>/mshoutbox/index.php
Le contact est automatiquement supprimé de la M-Shoutbox.
![Page 26: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/26.jpg)
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 !
![Page 27: Didacticiel M-Shoutbox Full](https://reader033.fdocuments.us/reader033/viewer/2022051515/54c70e1c4a795967508b461d/html5/thumbnails/27.jpg)
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