Client Ruby pour la plateforme Djanoa.
Installation
gem install djanoa
Utilisation
Il faut d'abord créer un compte sur le site de djanoa.
Ensuite vous faites les configurations
require 'djanoa'
Djanoa.configure do |config|
config.from = VOTRE_NUMERO_COURT
config.account_code = CODE_DE_VOTRE_COMPTE
config.application_pass = MOT_DE_PASSE
end
ensuite pour envoyer un SMS il suffit de faire :
Djanoa.send_sms '221777777777', 'juste pour tester mon gem'
Gestion des erreurs
Si vous voulez allez plus loin vous pouvez récupérer la réponse et voir s'il n'y a pas d'erreur.
Le code suivant permet d'envoyer un SMS et, s'il y'a une erreur, affiche le code de l'erreur, le message d'erreur ainsi que l'adresse IP de l'envoyeur.
r = Djanoa.send_sms '221777777777', 'juste pour tester mon gem'
if r.sent?
puts "le sms est envoyé"
else
puts r.error.code
puts r.error.message
puts r.error.ip
end
Utilisation avec Rails
Depuis la version 1.0.1, vous pouvez utiliser la gem sur votre application Ruby On Rails pour la reception des SMS.
installation
Il faut ajouter la ligne suivante sur votre fichier Gemfile
gem 'djanoa'
Ensuite vous faites un bundle install
. Après ca vous lancez le générateur
rails generate djanoa:install
# résultat :
create db/migrate/20130330192041_djanoa_migration.rb
create app/models/djanoa_message.rb
create app/controllers/djanoa_messages_controller.rb
create config/initializers/djanoa.rb
route get '/new_sms' => 'djanoa_messages#new_sms', defaults: {format: 'xml'}
Après ca il faut éditer le fichier d'initialisation djanoa.rb et mettre les informations de votre compte djanoa. Sur votre compte djanoa vous pouver ajouter l'URL http://votre_domaine/new_sms avec la méthode GET.
Maintenant à chaque fois qu'il recoit un SMS il l'enregistre dans la table djanoa_messages
autres méthodes
# récupération du dernier sms recu
sms = DjanoaMessage.last
# récupérer la liste des mots du texte du sms dans un tableau
sms.words
# vérifier si y'a un deuxième mot dans le text du sms
sms.word_2_exists?
# récupération du troisième mot du message
sms.word_3
Copyright
Copyright 2013 Cheikh Sidya CAMARA. Voir la LICENSE pour plus de détails.