hkairi / djanoa

Client Ruby pour la plateforme Djanoa (http://www.djanoa.com/)

Djanoa

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.