messenger-bot-ruby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5e58554d6934e450aa15901619fbda6209f4daa4
+  data.tar.gz: debc4eaa53d54eae3afaaaa30a601b9a03bebf56
+SHA512:
+  metadata.gz: 134cac2692eb0ec98fe15e189a9b1704b2910e39ee94d7827a98ce2d3b2fd203c4bb047dae3a4f3b3119190e68cb2a0514a20519037782bccb14cb08a66a63fe
+  data.tar.gz: a939e9cb006ce518aec1d7721559bae14984ec2d8b26f0c7d307aab3c88c8a4f17f0c5886aa4e1fa84a821e6c64398dac58b581774d57cf32d8dd4abe5bbfeee

data/.gitignore

@@ -0,0 +1,36 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+- Initial commit and implementation, really quick and dirty.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,71 @@
+PATH
+  remote: .
+  specs:
+    messenger-bot-ruby (0.1.0)
+      httmultiparty (~> 0.3.16)
+      persistent_httparty (~> 0.1.2)
+      virtus (~> 1.0.5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    axiom-types (0.1.1)
+      descendants_tracker (~> 0.0.4)
+      ice_nine (~> 0.11.0)
+      thread_safe (~> 0.3, >= 0.3.1)
+    coderay (1.1.1)
+    coercible (1.0.0)
+      descendants_tracker (~> 0.0.1)
+    cuba (3.6.0)
+      rack (~> 1.6.0)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    equalizer (0.0.11)
+    gene_pool (1.4.1)
+      thread_safe
+    httmultiparty (0.3.16)
+      httparty (>= 0.7.3)
+      mimemagic
+      multipart-post
+    httparty (0.13.7)
+      json (~> 1.8)
+      multi_xml (>= 0.5.2)
+    ice_nine (0.11.2)
+    json (1.8.3)
+    method_source (0.8.2)
+    mimemagic (0.3.1)
+    multi_json (1.11.2)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    persistent_http (1.0.6)
+      gene_pool (>= 1.3)
+    persistent_httparty (0.1.2)
+      httparty (~> 0.9)
+      persistent_http (< 2)
+    pry (0.10.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rack (1.6.4)
+    rake (10.5.0)
+    slop (3.6.0)
+    thread_safe (0.3.5)
+    virtus (1.0.5)
+      axiom-types (~> 0.1)
+      coercible (~> 1.0)
+      descendants_tracker (~> 0.0, >= 0.0.3)
+      equalizer (~> 0.0, >= 0.0.9)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.9)
+  cuba (~> 3.6.0)
+  messenger-bot-ruby!
+  multi_json
+  pry (~> 0.10.3)
+  rake (~> 10.0)
+
+BUNDLED WITH
+   1.11.2

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Matteo Gavagnin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,152 @@
+# messenger-bot-ruby
+
+Ruby wrapper for [Messenger's Platform Bot API](https://developers.facebook.com/docs/messenger-platform).
+
+[![Gem Version](https://badge.fury.io/rb/messenger-bot-ruby.svg)](http://badge.fury.io/rb/messenger-bot-ruby)
+
+This library is heavily based on the great [telegram-bot-ruby](https://github.com/atipugin/telegram-bot-ruby) gem written by [Alexander Tipugin](mailto:atipugin@gmail.com) and its main goal is let you easily integrate your (existing?) Telegram Bot with Messenger.
+
+## Prerequisites
+
+Messenger platform uses the webhook pattern to send you updates on events, requiring a TLS encrypted connection.
+
+### Development: ngrok
+
+To be able to use the bot on your development machine I heavily suggest you to purchase a [ngrok Pro subscription](https://ngrok.com/product#pricing) (billed monthly or yearly). I struggled with [localtunnel](https://localtunnel.me) that's free, but at the moment has a bug (it crashes losing the tunnel and the domain) and you have to reconfigure the webhook on Facebook every few minutes.
+
+Remember to [authorize your machine](https://dashboard.ngrok.com/auth) after you purchase the subscription.
+
+Whenever you need to develop, start a tunnel following the ngrok instructions, but something like this should suffice:
+
+```shell
+ngrok http 9292
+```
+
+where `http` is the protocol (if authenticated will establish also the encrypted `https` tunnel), `9292` is the default Cuba port.
+
+```shell
+Forwarding                    http://bf6ab2c6.ngrok.io -> localhost:9292
+Forwarding                    https://bf6ab2c6.ngrok.io -> localhost:9292
+```
+
+The interesting information is the `https://bf6bb3c6.ngrok.io` forwarded address, you need to use it on Facebook to configure the webhook appending the `/messenger` path.
+
+So your webhook should point to something like
+
+    https://bf6ab2c6.ngrok.io/messenger
+
+Please follow the [official guide](https://developers.facebook.com/docs/messenger-platform) and once completed you can proceed.
+
+### Production: Let's Encrypt
+
+On the production machine I cannot praise enough [Let's Encrypt](http://letsencrypt.org): free and secure TLS certificates for everyone (I'm using it on many production projects and it rocks!).
+
+## Quick start
+
+Clone this repository and start a terminal session inside the folder and execute the following commands to fetch the necessary dependancies and start the server.
+
+```shell
+bundle
+bundle exec rackup
+```
+
+The `rackup` command will start a Cuba server using the sample file in `examples/bot.rb`.
+There you should replace the `YOUR_MESSENGER_PAGE_TOKEN_HERE` string with the page token provided by Facebook (follow the [official guide](https://developers.facebook.com/docs/messenger-platform) to know more).
+
+## Installation
+
+Add following line to your Gemfile:
+
+```ruby
+gem 'messenger-bot-ruby'
+```
+
+And then execute:
+
+```shell
+$ bundle
+```
+
+Or install it system-wide:
+
+```shell
+$ gem install messenger-bot-ruby
+```
+
+## Usage
+
+Take a look at the `examples/bot.rb` file reported below.
+I'm planning to add detailed informations in the next few days.
+
+```ruby
+require 'bundler/setup'
+require 'cuba'
+require 'multi_json'
+require 'messenger/bot'
+
+token = "YOUR_MESSENGER_PAGE_TOKEN_HERE"
+bot = Messenger::Bot::Client.new(token)
+
+# deserialize JSON data from request body
+def json_load(request_body)
+  request_body.rewind
+  body = request_body.read
+  MultiJson.load body
+end
+
+Cuba.define do
+  on get do
+    on "messenger" do
+      on param("hub.mode"), param("hub.challenge"), param("hub.verify_token") do |mode, challenge, token|
+        if mode == "subscribe"
+          # TODO: check the verify_token value that you inserted on the facebook developer page
+          res.write challenge
+        end
+      end
+    end
+    on root do
+      res.write "Hello world!"
+    end
+  end
+
+  on post do
+    puts "Got a post call #{res.to_json}"
+    on "messenger" do
+      data = json_load req.body
+      # puts "#{data}"
+      res.write "" #200
+      callback = Messenger::Bot::Types::Callback.new(data)
+      for e in callback.entry
+        for mess in e.messaging
+          if mess.message
+            if mess.sender.id # We have someone to send the message to!
+              options = {bot: bot, messaging: mess, token: token}
+              bot.api.messages(recipient: {id: mess.sender.id}, message: { text: "Hello from a Bot!"})
+            end
+          else
+            puts "Received Postback or delivery"
+          end
+        end
+      end
+    end
+  end
+end
+
+```
+
+## Aknowledgments
+
+Idea and initial implementation by [Matteo Gavagnin](https://twitter.com/macteo)
+Thanks again to [Alexander Tipugin](mailto:atipugin@gmail.com) for inspiration and the [original gem](https://github.com/atipugin/telegram-bot-ruby) architecture.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+Released under MIT license.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler/gem_tasks'
+require 'bundler/setup'

data/bin/console

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+require 'bundler/setup'
+require 'messenger/bot'
+
+require 'pry'
+Pry.start

data/bin/setup

@@ -0,0 +1,5 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install

data/config.ru

@@ -0,0 +1,3 @@
+require './examples/bot.rb'
+
+run Cuba

data/examples/bot.rb

@@ -0,0 +1,53 @@
+#!/usr/bin/env ruby
+require 'bundler/setup'
+require 'cuba'
+require 'multi_json'
+require 'messenger/bot'
+
+token = "YOUR_MESSENGER_PAGE_TOKEN_HERE"
+bot = Messenger::Bot::Client.new(token)
+
+# deserialize JSON data from request body
+def json_load(request_body)
+  request_body.rewind
+  body = request_body.read
+  MultiJson.load body
+end
+
+Cuba.define do
+  on get do
+    on "messenger" do
+      on param("hub.mode"), param("hub.challenge"), param("hub.verify_token") do |mode, challenge, token|
+        if mode == "subscribe"
+          # TODO: check the verify_token value that you inserted on the facebook developer page
+          res.write challenge
+        end
+      end
+    end
+    on root do
+      res.write "Hello world!"
+    end
+  end
+
+  on post do
+    puts "Got a post call #{res.to_json}"
+    on "messenger" do
+      data = json_load req.body
+      # puts "#{data}"
+      res.write "" #200
+      callback = Messenger::Bot::Types::Callback.new(data)
+      for e in callback.entry
+        for mess in e.messaging
+          if mess.message
+            if mess.sender.id # We have someone to send the message to!
+              options = {bot: bot, messaging: mess, token: token}
+              bot.api.messages(recipient: {id: mess.sender.id}, message: { text: "Hello from a Bot!"})
+            end
+          else
+            puts "Received Postback or delivery"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/messenger/bot.rb

@@ -0,0 +1,10 @@
+require 'httmultiparty'
+require 'persistent_httparty'
+require 'virtus'
+
+require 'messenger/bot/types'
+require 'messenger/bot/exceptions'
+require 'messenger/bot/api'
+require 'messenger/bot/null_logger'
+require 'messenger/bot/client'
+require 'messenger/bot/version'

data/lib/messenger/bot/api.rb

@@ -0,0 +1,87 @@
+module Messenger
+  module Bot
+    class Api
+      include HTTMultiParty
+      ENDPOINTS = %w(
+              messages
+            ).freeze
+      POOL_SIZE = ENV.fetch('MESSENGER_BOT_POOL_SIZE', 1).to_i.freeze
+
+      attr_reader :token
+
+      base_uri 'https://graph.facebook.com/v2.6/'
+      persistent_connection_adapter pool_size: POOL_SIZE,
+                                    keep_alive: 30,
+                                    force_retry: true
+
+      def initialize(token)
+        @token = token
+      end
+
+      def method_missing(method_name, *args, &block)
+        endpoint = method_name.to_s
+        endpoint = camelize(endpoint) if endpoint.include?('_')
+
+        ENDPOINTS.include?(endpoint) ? call(endpoint, *args) : super
+      end
+
+      def respond_to_missing?(*args)
+        method_name = args[0].to_s
+        method_name = camelize(method_name) if method_name.include?('_')
+
+        ENDPOINTS.include?(method_name) || super
+      end
+
+      def user_profile(user_id)
+        response = self.class.get("#{user_id}?fields=first_name,last_name,profile_pic&access_token=#{token}")
+        if response.code == 200
+          response.to_hash
+        else
+          fail Exceptions::ResponseError.new(response),
+               'Messenger API has returned the error.'
+        end
+      end
+
+      def call(endpoint, raw_params = {})
+        params = build_params(raw_params)
+        response = self.class.post("/me/#{endpoint}?access_token=#{token}", query: params)
+        if response.code == 200
+          response.to_hash
+        else
+          fail Exceptions::ResponseError.new(response),
+               'Messenger API has returned the error.'
+        end
+      end
+
+      private
+
+      def build_params(h)
+        h.each_with_object({}) do |(key, value), params|
+          params[key] = sanitize_value(value)
+        end
+      end
+
+      def sanitize_value(value)
+        jsonify(jsonify_with_file_preservation(value))
+      end
+
+      def jsonify_with_file_preservation(value)
+        if !value.is_a?(File)
+          return value.to_h.to_json
+        end
+        return value
+      end
+
+      def jsonify(value)
+        return value unless value.is_a?(Array)
+        value.map { |i| i.to_h.select { |_, v| v } }.to_json
+      end
+
+      def camelize(method_name)
+        words = method_name.split('_')
+        words.drop(1).map(&:capitalize!)
+        words.join
+      end
+    end
+  end
+end

data/lib/messenger/bot/client.rb

@@ -0,0 +1,66 @@
+module Messenger
+  module Bot
+    class Client
+      TIMEOUT_EXCEPTIONS = [Timeout::Error]
+      TIMEOUT_EXCEPTIONS << Net::ReadTimeout if Net.const_defined?(:ReadTimeout)
+
+      attr_reader :api, :offset, :timeout
+      attr_accessor :logger
+
+      def self.run(*args, &block)
+        new(*args).run(&block)
+      end
+
+      def initialize(token, h = {})
+        options = default_options.merge(h)
+        @api = Api.new(token)
+        @offset = options[:offset]
+        @timeout = options[:timeout]
+        @logger = options[:logger]
+      end
+
+      def run
+        yield self
+      end
+
+      def listen(&block)
+        logger.info('Starting bot')
+        running = true
+        Signal.trap('INT') { running = false }
+        fetch_updates(&block) while running
+        exit
+      end
+
+      def fetch_updates
+        response = api.getUpdates(offset: offset, timeout: timeout)
+        return unless response['ok']
+
+        response['result'].each do |data|
+          update = Types::Update.new(data)
+          @offset = update.update_id.next
+          message = extract_message(update)
+          log_incoming_message(message)
+          yield message
+        end
+      rescue *TIMEOUT_EXCEPTIONS
+        retry
+      end
+
+      private
+
+      def default_options
+        { offset: 0, timeout: 20, logger: NullLogger.new }
+      end
+
+      def extract_message(update)
+        update.inline_query || update.chosen_inline_result || update.message
+      end
+
+      def log_incoming_message(message)
+        logger.info(
+          format('Incoming message: text="%s" uid=%i', message, message.from.id)
+        )
+      end
+    end
+  end
+end

data/lib/messenger/bot/exceptions.rb

@@ -0,0 +1,2 @@
+require 'messenger/bot/exceptions/base'
+require 'messenger/bot/exceptions/response_error'

data/lib/messenger/bot/exceptions/base.rb

@@ -0,0 +1,7 @@
+module Messenger
+  module Bot
+    module Exceptions
+      class Base < StandardError; end
+    end
+  end
+end

data/lib/messenger/bot/exceptions/response_error.rb

@@ -0,0 +1,32 @@
+module Messenger
+  module Bot
+    module Exceptions
+      class ResponseError < Base
+        attr_reader :response
+
+        def initialize(response)
+          @response = response
+        end
+
+        def to_s
+          super +
+            format(' (%s)', data.map { |k, v| %(#{k}: "#{v}") }.join(', '))
+        end
+
+        def error_code
+          data[:error_code] || data['error_code']
+        end
+
+        private
+
+        def data
+          @data ||= begin
+            JSON.parse(response.body)
+          rescue JSON::ParserError
+            { error_code: response.code, uri: response.request.last_uri.to_s }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/messenger/bot/null_logger.rb

@@ -0,0 +1,11 @@
+module Messenger
+  module Bot
+    class NullLogger < Logger
+      def initialize(*)
+      end
+
+      def add(*)
+      end
+    end
+  end
+end

data/lib/messenger/bot/types.rb

@@ -0,0 +1,20 @@
+require 'messenger/bot/types/base'
+require 'messenger/bot/types/payload'
+require 'messenger/bot/types/element'
+require 'messenger/bot/types/button'
+require 'messenger/bot/types/attachment'
+require 'messenger/bot/types/sender'
+require 'messenger/bot/types/recipient'
+require 'messenger/bot/types/delivery'
+require 'messenger/bot/types/postback'
+require 'messenger/bot/types/message'
+require 'messenger/bot/types/messaging'
+require 'messenger/bot/types/entry'
+require 'messenger/bot/types/callback'
+require 'messenger/bot/types/button_template'
+require 'messenger/bot/types/generic_template'
+require 'messenger/bot/types/receipt_element'
+require 'messenger/bot/types/address'
+require 'messenger/bot/types/summary'
+require 'messenger/bot/types/adjustment'
+require 'messenger/bot/types/receipt_template'

data/lib/messenger/bot/types/address.rb

@@ -0,0 +1,14 @@
+module Messenger
+  module Bot
+    module Types
+      class Address < Base
+        attribute :street_1, String
+        attribute :street_2, String
+        attribute :city, String
+        attribute :postal_code, String
+        attribute :state, String
+        attribute :country, String
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/adjustment.rb

@@ -0,0 +1,10 @@
+module Messenger
+  module Bot
+    module Types
+      class Adjustment < Base
+        attribute :name, String
+        attribute :amount, Float
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/attachment.rb

@@ -0,0 +1,10 @@
+module Messenger
+  module Bot
+    module Types
+      class Attachment < Base
+        attribute :type, String
+        attribute :payload, Payload
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/base.rb

@@ -0,0 +1,9 @@
+module Messenger
+  module Bot
+    module Types
+      class Base
+        include Virtus.model
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/button.rb

@@ -0,0 +1,12 @@
+module Messenger
+  module Bot
+    module Types
+      class Button < Base
+        attribute :type, String # web_url or postback
+        attribute :title, String
+        attribute :url, String # Required for web_url buttons
+        attribute :payload, String # Required for postback buttons
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/button_template.rb

@@ -0,0 +1,12 @@
+module Messenger
+  module Bot
+    module Types
+      class ButtonTemplate < Base
+        attribute :template_type, String # value must be button
+        attribute :text, String
+        attribute :buttons, Array[Button]
+        alias_method :to_s, :text
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/callback.rb

@@ -0,0 +1,10 @@
+module Messenger
+  module Bot
+    module Types
+      class Callback < Base
+        attribute :object, String
+        attribute :entry, Array[Entry]
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/delivery.rb

@@ -0,0 +1,11 @@
+module Messenger
+  module Bot
+    module Types
+      class Delivery < Base
+        attribute :mids, Array[String]
+        attribute :watermark, Integer
+        attribute :seq, Integer
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/element.rb

@@ -0,0 +1,11 @@
+module Messenger
+  module Bot
+    module Types
+      class Element < Base
+        attribute :mids, Array[String]
+        attribute :watermark, Integer
+        attribute :seq, Integer
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/entry.rb

@@ -0,0 +1,11 @@
+module Messenger
+  module Bot
+    module Types
+      class Entry < Base
+        attribute :id, Integer
+        attribute :time, Integer
+        attribute :messaging, Array[Messaging]
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/generic_template.rb

@@ -0,0 +1,28 @@
+module Messenger
+  module Bot
+    module Types
+      class GenericTemplate < Base
+        attribute :template_type, String # generic
+        attribute :elements, Array[Element]
+      end
+    end
+  end
+end
+
+=begin
+
+# Generic Template Guidelines
+
+## Limits
+
+- Title: 45 characters
+- Subtitle: 80 characters
+- Call-to-action title: 20 characters
+- Call-to-action items: 3 buttons
+- Bubbles per message (horizontal scroll): 10 elements
+
+## Image Dimensions
+
+Image ratio is 1.91:1
+
+=end

data/lib/messenger/bot/types/image.rb

@@ -0,0 +1,12 @@
+module Messenger
+  module Bot
+    module Types
+      class Image < Base
+        attribute :url, String
+        alias_method :to_s, :url
+      end
+    end
+  end
+end
+
+# Only jpeg and png

data/lib/messenger/bot/types/image_attachment.rb

@@ -0,0 +1,10 @@
+module Messenger
+  module Bot
+    module Types
+      class ImageAttachment < Base
+        attribute :type, String, :default => "image"
+        attribute :payload, Image
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/message.rb

@@ -0,0 +1,14 @@
+module Messenger
+  module Bot
+    module Types
+      class Message < Base
+        attribute :text, String
+        attribute :mid, String
+        attribute :seq, Integer
+        attribute :attachments, Array[Attachment]
+
+        alias_method :to_s, :text
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/messaging.rb

@@ -0,0 +1,14 @@
+module Messenger
+  module Bot
+    module Types
+      class Messaging < Base
+        attribute :sender, Sender
+        attribute :recipient, Recipient
+        attribute :timestamp, Integer
+        attribute :message, Message
+        attribute :delivery, Delivery
+        attribute :postback, Postback
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/payload.rb

@@ -0,0 +1,9 @@
+module Messenger
+  module Bot
+    module Types
+      class Payload < Base
+        attribute :url, String
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/postback.rb

@@ -0,0 +1,9 @@
+module Messenger
+  module Bot
+    module Types
+      class Postback < Base
+        attribute :payload, String
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/receipt_element.rb

@@ -0,0 +1,14 @@
+module Messenger
+  module Bot
+    module Types
+      class ReceiptElement < Base
+        attribute :title, String
+        attribute :subtitle, String
+        attribute :quantity, Float
+        attribute :price, String
+        attribute :currency, String
+        attribute :image_url, String
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/receipt_template.rb

@@ -0,0 +1,19 @@
+module Messenger
+  module Bot
+    module Types
+      class ReceiptTemplate < Base
+        attribute :template_type, String # receipt
+        attribute :recipient_name, String
+        attribute :order_number, String
+        attribute :currency, String
+        attribute :payment_method, String
+        attribute :timestamp, String
+        attribute :order_url, String
+        attribute :elements, Array[ReceiptElement]
+        attribute :address, Address
+        attribute :summary, Summary
+        attribute :adjustments, Array[Adjustment]
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/recipient.rb

@@ -0,0 +1,12 @@
+module Messenger
+  module Bot
+    module Types
+      class Recipient < Base
+        attribute :id, Integer
+        attribute :phone_number, String
+        
+        # alias_method :to_s, :text
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/sender.rb

@@ -0,0 +1,12 @@
+module Messenger
+  module Bot
+    module Types
+      class Sender < Base
+        attribute :id, Integer
+        attribute :phone_number, String
+
+        # alias_method :to_s, :text
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/summary.rb

@@ -0,0 +1,12 @@
+module Messenger
+  module Bot
+    module Types
+      class Summary < Base
+        attribute :subtotal, Float
+        attribute :shipping_cost, Float
+        attribute :total_tax, Float
+        attribute :total_cost, Float
+      end
+    end
+  end
+end

data/lib/messenger/bot/types/template_attachment.rb

@@ -0,0 +1,10 @@
+module Messenger
+  module Bot
+    module Types
+      class TemplateAttachment < Base
+        attribute :type, String, :default => "template"
+        attribute :payload, Hash
+      end
+    end
+  end
+end

data/lib/messenger/bot/version.rb

@@ -0,0 +1,5 @@
+module Messenger
+  module Bot
+    VERSION = '0.1.0'
+  end
+end

data/messenger-bot-ruby.gemspec

@@ -0,0 +1,29 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'messenger/bot/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'messenger-bot-ruby'
+  spec.version       = Messenger::Bot::VERSION
+  spec.authors       = ['Matteo Gavagnin', 'Alexander Tipugin']
+  spec.email         = ['m@macteo.it', 'atipugin@gmail.com']
+  spec.licenses      = ['MIT']
+  spec.summary       = "Ruby wrapper for Messenger's Bot API"
+  spec.homepage      = 'https://github.com/macteo/messenger-bot-ruby'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'httmultiparty', '~> 0.3'
+  spec.add_dependency 'persistent_httparty', '~> 0.1'
+  spec.add_dependency 'virtus', '~> 1.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.9'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'pry', '~> 0.10'
+  spec.add_development_dependency 'cuba', '~> 3.6'
+  spec.add_development_dependency 'multi_json', '~> 1.11'
+end

metadata

@@ -0,0 +1,202 @@
+--- !ruby/object:Gem::Specification
+name: messenger-bot-ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Matteo Gavagnin
+- Alexander Tipugin
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-04-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httmultiparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: persistent_httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: virtus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: cuba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+description: 
+email:
+- m@macteo.it
+- atipugin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- config.ru
+- examples/bot.rb
+- lib/messenger/bot.rb
+- lib/messenger/bot/api.rb
+- lib/messenger/bot/client.rb
+- lib/messenger/bot/exceptions.rb
+- lib/messenger/bot/exceptions/base.rb
+- lib/messenger/bot/exceptions/response_error.rb
+- lib/messenger/bot/null_logger.rb
+- lib/messenger/bot/types.rb
+- lib/messenger/bot/types/address.rb
+- lib/messenger/bot/types/adjustment.rb
+- lib/messenger/bot/types/attachment.rb
+- lib/messenger/bot/types/base.rb
+- lib/messenger/bot/types/button.rb
+- lib/messenger/bot/types/button_template.rb
+- lib/messenger/bot/types/callback.rb
+- lib/messenger/bot/types/delivery.rb
+- lib/messenger/bot/types/element.rb
+- lib/messenger/bot/types/entry.rb
+- lib/messenger/bot/types/generic_template.rb
+- lib/messenger/bot/types/image.rb
+- lib/messenger/bot/types/image_attachment.rb
+- lib/messenger/bot/types/message.rb
+- lib/messenger/bot/types/messaging.rb
+- lib/messenger/bot/types/payload.rb
+- lib/messenger/bot/types/postback.rb
+- lib/messenger/bot/types/receipt_element.rb
+- lib/messenger/bot/types/receipt_template.rb
+- lib/messenger/bot/types/recipient.rb
+- lib/messenger/bot/types/sender.rb
+- lib/messenger/bot/types/summary.rb
+- lib/messenger/bot/types/template_attachment.rb
+- lib/messenger/bot/version.rb
+- messenger-bot-ruby.gemspec
+homepage: https://github.com/macteo/messenger-bot-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper for Messenger's Bot API
+test_files: []