stealth-facebook 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4a38f865adee4d13ff7aafdfd61df335c1dc067b
-  data.tar.gz: ca56525cba32394dc4aea0081ff5de0cba989ed3
+  metadata.gz: bb2add5ca870baf50a9dd8dd5e55ebe4625051f8
+  data.tar.gz: 0b880e4057e9c5445facfa83801d02c5788335fa
 SHA512:
-  metadata.gz: 1c1a3de0d5e1bc33641420eead5f2f4ad09250b12a5192f38a72f0f17bb595091dfea03a58592c0fb10894a7f2bb9ca56129c2079a3b2b125cff5d5e15ca04fa
-  data.tar.gz: b0fa545dba48b521e1ff6e7d17149f2445ed4e737a4f7ae9f9580417913e3cf9f62ba64af4f144b4439bb1fd039014774d1350cf8468411e2545bf68a9ee4f10
+  metadata.gz: 9ef0ef7851238ce6c4f6d0b17231695d9f146ceb172285dda30141c38875605f883d0c6d566bcb75b030dde6219d27de3b5861f1bb43e2e43c5ace53011ff9aa
+  data.tar.gz: 69cee3ec475fcaacda34d63b1732aaac5259f21d2a9d3f1ffe8b42b463b57fd16cc58fa623c1a903c5fdb2757c4d8be1812900da70c141f6d067bed7304b4901

data/.circleci/config.yml

@@ -0,0 +1,60 @@
+# Ruby CircleCI 2.0 configuration file
+#
+# Check https://circleci.com/docs/2.0/language-ruby/ for more details
+#
+version: 2
+jobs:
+  build:
+    docker:
+      # specify the version you desire here
+       - image: circleci/ruby:2.4.1-node-browsers
+         environment:
+           STEALTH_ENV: test
+
+      # Specify service dependencies here if necessary
+      # CircleCI maintains a library of pre-built images
+      # documented at https://circleci.com/docs/2.0/circleci-images/
+      # - image: circleci/postgres:9.4
+
+    working_directory: ~/repo
+
+    steps:
+      - checkout
+
+      # Download and cache dependencies
+      - restore_cache:
+          keys:
+          - v1-dependencies-{{ checksum "Gemfile.lock" }}
+          # fallback to using the latest cache if no exact match is found
+          - v1-dependencies-
+
+      - run:
+          name: install dependencies
+          command: |
+            bundle install --jobs=4 --retry=3 --path vendor/bundle
+
+      - save_cache:
+          paths:
+            - ./vendor/bundle
+          key: v1-dependencies-{{ checksum "Gemfile.lock" }}
+
+      # run tests!
+      - run:
+          name: run tests
+          command: |
+            mkdir /tmp/test-results
+            TEST_FILES="$(circleci tests glob "spec/**/*_spec.rb" | circleci tests split --split-by=timings)"
+
+            bundle exec rspec --format progress \
+                --format RspecJunitFormatter \
+                --out /tmp/test-results/rspec.xml \
+                --format progress \
+                -- \
+                $TEST_FILES
+
+      # collect reports
+      - store_test_results:
+          path: /tmp/test-results
+      - store_artifacts:
+          path: /tmp/test-results
+          destination: test-results

data/.gitignore

@@ -0,0 +1,12 @@
+# please add general patterns to your global ignore list
+# see https://github.com/github/gitignore#readme
+.DS_STORE
+*.swp
+*.rbc
+*.sass-cache
+/pkg
+/doc/api
+/coverage
+.yardoc
+doc/
+*.gem

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,83 @@
+PATH
+  remote: .
+  specs:
+    stealth-facebook (0.9.0)
+      faraday (~> 0.13)
+      stealth (~> 0.9)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (5.1.4)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (~> 0.7)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    concurrent-ruby (1.0.5)
+    connection_pool (2.2.1)
+    diff-lcs (1.3)
+    faraday (0.13.1)
+      multipart-post (>= 1.2, < 3)
+    i18n (0.9.1)
+      concurrent-ruby (~> 1.0)
+    minitest (5.10.3)
+    multi_json (1.12.2)
+    multipart-post (2.0.0)
+    mustermann (1.0.1)
+    puma (3.10.0)
+    rack (2.0.3)
+    rack-protection (2.0.0)
+      rack
+    rack-test (0.7.0)
+      rack (>= 1.0, < 3)
+    redis (4.0.1)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.0)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.0)
+    rspec_junit_formatter (0.3.0)
+      rspec-core (>= 2, < 4, != 2.12.0)
+    sidekiq (5.0.5)
+      concurrent-ruby (~> 1.0)
+      connection_pool (~> 2.2, >= 2.2.0)
+      rack-protection (>= 1.5.0)
+      redis (>= 3.3.4, < 5)
+    sinatra (2.0.0)
+      mustermann (~> 1.0)
+      rack (~> 2.0)
+      rack-protection (= 2.0.0)
+      tilt (~> 2.0)
+    stealth (0.9.5)
+      activesupport (~> 5.1)
+      faraday (~> 0.13)
+      multi_json (~> 1.12)
+      puma (~> 3.10)
+      sidekiq (~> 5.0)
+      sinatra (~> 2.0)
+      thor (~> 0.20)
+    thor (0.20.0)
+    thread_safe (0.3.6)
+    tilt (2.0.8)
+    tzinfo (1.2.4)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rack-test (~> 0.7)
+  rspec (~> 3.6)
+  rspec_junit_formatter (~> 0.3)
+  stealth-facebook!
+
+BUNDLED WITH
+   1.15.3

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2017 Mauricio Gomes, Black Ops Bureau
+
+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 @@
+# Stealth Facebook

data/VERSION

@@ -0,0 +1 @@
+0.9.1

data/lib/stealth-facebook.rb

@@ -0,0 +1 @@
+require 'stealth/facebook'

data/lib/stealth/facebook.rb

@@ -0,0 +1,2 @@
+require 'stealth/services/facebook/version'
+require 'stealth/services/facebook/client'

data/lib/stealth/services/facebook/client.rb

@@ -0,0 +1,60 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+require 'faraday'
+
+require 'stealth/services/facebook/message_handler'
+require 'stealth/services/facebook/reply_handler'
+require 'stealth/services/facebook/setup'
+
+module Stealth
+  module Services
+    module Facebook
+
+      class Client < Stealth::Services::BaseClient
+        FB_ENDPOINT = "https://graph.facebook.com/v2.10/me"
+
+        attr_reader :api_endpoint, :reply
+
+        def initialize(reply:, endpoint: 'messages')
+          @reply = reply
+          access_token = "access_token=#{Stealth.config.facebook.page_access_token}"
+          @api_endpoint = [[FB_ENDPOINT, endpoint].join('/'), access_token].join('?')
+        end
+
+        def transmit
+          headers = { "Content-Type" => "application/json" }
+          response = Faraday.post(api_endpoint, reply.to_json, headers)
+          Stealth::Logger.l(topic: "facebook", message: "Transmitting. Response: #{response.status}: #{response.body}")
+        end
+
+        def self.fetch_profile(recipient_id:, fields: nil)
+          if fields.blank?
+            fields = [:first_name, :last_name, :profile_pic, :locale, :timezone, :gender, :is_payment_enabled, :last_ad_referral]
+          end
+
+          query_hash ={
+            fields: fields.join(','),
+            access_token: Stealth.config.facebook.page_access_token
+          }
+
+          uri = URI::HTTPS.build(
+            host: "graph.facebook.com",
+            path: "/v2.10/#{recipient_id}",
+            query: query_hash.to_query
+          )
+
+          response = Faraday.get(uri.to_s)
+          Stealth::Logger.l(topic: "facebook", message: "Requested user profile for #{recipient_id}. Response: #{response.status}: #{response.body}")
+
+          if response.status.in?(200..299)
+            MultiJson.load(response.body)
+          else
+            false
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/stealth/services/facebook/events/message_event.rb

@@ -0,0 +1,59 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  module Services
+    module Facebook
+
+      class MessageEvent
+
+        attr_reader :service_message, :params
+
+        def initialize(service_message:, params:)
+          @service_message = service_message
+          @params = params
+        end
+
+        def process
+          fetch_message
+          fetch_location
+          fetch_attachments
+        end
+
+        private
+
+          def fetch_message
+            if params['message']['quick_reply'].present?
+              service_message.message = params['message']['quick_reply']['payload']
+            elsif params['message']['text'].present?
+              service_message.message = params['message']['text']
+            end
+          end
+
+          def fetch_location
+            if params['location'].present?
+              lat = params['location']['coordinates']['lat']
+              lng = params['location']['coordinates']['long']
+              service_message.location = {
+                lat: lat,
+                lng: lng
+              }
+            end
+          end
+
+          def fetch_attachments
+            if params['attachments'].present? && params['attachments'].is_a?(Array)
+              params['attachments'].each do |attachment|
+                service_message.attachments << {
+                  type: attachment['type'],
+                  url: attachment['payload']['url']
+                }
+              end
+            end
+          end
+
+      end
+
+    end
+  end
+end

data/lib/stealth/services/facebook/events/postback_event.rb

@@ -0,0 +1,36 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  module Services
+    module Facebook
+
+      class PostbackEvent
+
+        attr_reader :service_message, :params
+
+        def initialize(service_message:, params:)
+          @service_message = service_message
+          @params = params
+        end
+
+        def process
+          fetch_payload
+          fetch_referral
+        end
+
+        private
+
+          def fetch_payload
+            service_message.payload = params['postback']['payload']
+          end
+
+          def fetch_referral
+            service_message.referral = params['postback']['referral']
+          end
+
+      end
+
+    end
+  end
+end

data/lib/stealth/services/facebook/message_handler.rb

@@ -0,0 +1,84 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+require 'stealth/services/facebook/events/message_event'
+require 'stealth/services/facebook/events/postback_event'
+
+module Stealth
+  module Services
+    module Facebook
+
+      class MessageHandler < Stealth::Services::BaseMessageHandler
+
+        attr_reader :service_message, :params, :headers, :facebook_message
+
+        def initialize(params:, headers:)
+          @params = params
+          @headers = headers
+        end
+
+        def coordinate
+          if facebook_is_validating_webhook?
+            respond_with_validation
+          else
+            # Queue the request processing so we can respond quickly to FB
+            # and also keep track of this message
+            Stealth::Services::HandleMessageJob.perform_async('facebook', params, {})
+
+            # Relay our acceptance
+            [200, 'OK']
+          end
+        end
+
+        def process
+          @service_message = ServiceMessage.new(service: 'facebook')
+          @facebook_message = params['entry'].first['messaging'].first
+          service_message.sender_id = get_sender_id
+          service_message.timestamp = get_timestamp
+          process_facebook_event
+
+          service_message
+        end
+
+        private
+
+          def facebook_is_validating_webhook?
+            params['hub.verify_token'].present?
+          end
+
+          def respond_with_validation
+            if params['hub.verify_token'] == Stealth.config.facebook.verify_token
+              [200, params['hub.challenge']]
+            else
+              [401, "Verify token did not match environment variable."]
+            end
+          end
+
+          def get_sender_id
+            facebook_message['sender']['id']
+          end
+
+          def get_timestamp
+            Time.at(facebook_message['timestamp']).to_datetime
+          end
+
+          def process_facebook_event
+            if facebook_message['message'].present?
+              message_event = Stealth::Services::Facebook::MessageEvent.new(
+                service_message: service_message,
+                params: facebook_message
+              )
+            elsif facebook_message['postback'].present?
+              message_event = Stealth::Services::Facebook::PostbackEvent.new(
+                service_message: service_message,
+                params: facebook_message
+              )
+            end
+
+            message_event.process
+          end
+      end
+
+    end
+  end
+end

data/lib/stealth/services/facebook/reply_handler.rb

@@ -0,0 +1,480 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  module Services
+    module Facebook
+
+      class ReplyHandler < Stealth::Services::BaseReplyHandler
+
+        attr_reader :recipient_id, :reply
+
+        def initialize(recipient_id: nil, reply: nil)
+          @recipient_id = recipient_id
+          @reply = reply
+        end
+
+        def text
+          check_if_arguments_are_valid!(
+            suggestions: reply['suggestions'],
+            buttons: reply['buttons']
+          )
+
+          template = unstructured_template
+          template['message']['text'] = reply['text']
+
+          if reply['suggestions'].present?
+            fb_suggestions = generate_suggestions(suggestions: reply['suggestions'])
+            template["message"]["quick_replies"] = fb_suggestions
+          end
+
+          # If buttons are present, we need to convert this to a button template
+          if reply['buttons'].present?
+            template['message'].delete('text')
+
+            fb_buttons = generate_buttons(buttons: reply['buttons'])
+            attachment = button_attachment_template(text: reply['text'], buttons: fb_buttons)
+            template['message']['attachment'] = attachment
+          end
+
+          template
+        end
+
+        def image
+          check_if_arguments_are_valid!(
+            suggestions: reply['suggestions'],
+            buttons: reply['buttons']
+          )
+
+          template = unstructured_template
+          attachment = attachment_template(
+            attachment_type: 'image',
+            attachment_url: reply['image_url']
+          )
+          template['message']['attachment'] = attachment
+
+          if reply['suggestions'].present?
+            fb_suggestions = generate_suggestions(suggestions: reply['suggestions'])
+            template["message"]["quick_replies"] = fb_suggestions
+          end
+
+          template
+        end
+
+        def audio
+          check_if_arguments_are_valid!(
+            suggestions: reply['suggestions'],
+            buttons: reply['buttons']
+          )
+
+          template = unstructured_template
+          attachment = attachment_template(
+            attachment_type: 'audio',
+            attachment_url: reply['audio_url']
+          )
+          template['message']['attachment'] = attachment
+
+          if reply['suggestions'].present?
+            fb_suggestions = generate_suggestions(suggestions: reply['suggestions'])
+            template["message"]["quick_replies"] = fb_suggestions
+          end
+
+          template
+        end
+
+        def video
+          check_if_arguments_are_valid!(
+            suggestions: reply['suggestions'],
+            buttons: reply['buttons']
+          )
+
+          template = unstructured_template
+          attachment = attachment_template(
+            attachment_type: 'video',
+            attachment_url: reply['video_url']
+          )
+          template['message']['attachment'] = attachment
+
+          if reply['suggestions'].present?
+            fb_suggestions = generate_suggestions(suggestions: reply['suggestions'])
+            template["message"]["quick_replies"] = fb_suggestions
+          end
+
+          template
+        end
+
+        def file
+          check_if_arguments_are_valid!(
+            suggestions: reply['suggestions'],
+            buttons: reply['buttons']
+          )
+
+          template = unstructured_template
+          attachment = attachment_template(
+            attachment_type: 'file',
+            attachment_url: reply['file_url']
+          )
+          template['message']['attachment'] = attachment
+
+          if reply['suggestions'].present?
+            fb_suggestions = generate_suggestions(suggestions: reply['suggestions'])
+            template["message"]["quick_replies"] = fb_suggestions
+          end
+
+          template
+        end
+
+        def cards
+          template = card_template(
+            sharable: reply["sharable"],
+            aspect_ratio: reply["aspect_ratio"]
+          )
+
+          fb_elements = generate_card_elements(elements: reply["elements"])
+          template["message"]["attachment"]["payload"]["elements"] = fb_elements
+
+          if reply['suggestions'].present?
+            fb_suggestions = generate_suggestions(suggestions: reply['suggestions'])
+            template["message"]["quick_replies"] = fb_suggestions
+          end
+
+          template
+        end
+
+        def list
+          template = list_template(
+            top_element_style: reply["top_element_style"]
+          )
+
+          fb_elements = generate_list_elements(elements: reply["elements"])
+          template["message"]["attachments"]["payload"]["elements"] = fb_elements
+
+          if reply["buttons"].present?
+            if reply["buttons"].size > 1
+              raise(ArgumentError, "Facebook lists support a single button attached to the list itsef.")
+            end
+
+            template["message"]["attachments"]["payload"]["buttons"] = generate_buttons(buttons: reply["buttons"])
+          end
+
+          template
+        end
+
+        def mark_seen
+          sender_action_template(action: 'mark_seen')
+        end
+
+        def enable_typing_indicator
+          sender_action_template(action: 'typing_on')
+        end
+
+        def disable_typing_indicator
+          sender_action_template(action: 'typing_off')
+        end
+
+        def delay
+          enable_typing_indicator
+        end
+
+        # generates property/value pairs required to set the profile
+        def messenger_profile
+          unless Stealth.config.facebook.setup.present?
+            raise Stealth::Errors::ConfigurationError, "Setup for Facebook is not specified in services.yml."
+          end
+
+          profile = {}
+          Stealth.config.facebook.setup.each do |profile_option, _|
+            profile[profile_option] = self.send(profile_option)
+          end
+
+          profile
+        end
+
+        private
+
+          def unstructured_template
+            {
+              "recipient" => {
+                "id" => recipient_id
+              },
+              "message" => { }
+            }
+          end
+
+          def card_template(sharable: nil, aspect_ratio: nil)
+            template = {
+              "recipient" => {
+                "id" => recipient_id
+              },
+              "message" => {
+                "attachment" => {
+                  "type" => "template",
+                  "payload" => {
+                    "template_type" => "generic",
+                    "elements" => []
+                  }
+                }
+              }
+            }
+
+            if sharable.present?
+              template["message"]["payload"]["sharable"] = sharable
+            end
+
+            if aspect_ratio.present?
+              template["message"]["payload"]["image_aspect_ratio"] = aspect_ratio
+            end
+
+            template
+          end
+
+          def list_template(top_element_style: nil, buttons: [])
+            template = {
+              "recipient" => {
+                "id" => recipient_id
+              },
+              "message" => {
+                "attachment" => {
+                  "type" => "template",
+                  "payload" => {
+                    "template_type" => "list",
+                    "elements" => []
+                  }
+                }
+              }
+            }
+
+            if top_element_style.present?
+              unless ['large', 'compact'].include?(top_element_style)
+                raise(ArgumentError, "Facebook list replies only support 'large' or 'compact' as the top_element_style.")
+              end
+
+              template["message"]["payload"]["top_element_style"] = top_element_style
+            end
+
+            if buttons.present?
+              unless buttons.size > 1
+                raise(ArgumentError, "Facebook lists only support a single button in the top element.")
+              end
+
+              template["message"]["payload"]["buttons"] = aspect_ratio
+            end
+
+            template
+          end
+
+          def element_template(element_type:, element:)
+            unless element["title"].present?
+              raise(ArgumentError, "Facebook card and list elements must have a 'title' attribute.")
+            end
+
+            template = {
+              "title" => element["title"]
+            }
+
+            if element["subtitle"].present?
+              template["subtitle"] = element["subtitle"]
+            end
+
+            if element["image_url"].present?
+              template["image_url"] = element["image_url"]
+            end
+
+            if element["default_action"].present?
+              default_action = generate_default_action(action_params: element["default_action"])
+              template["default_action"] = default_action
+            end
+
+            if element["buttons"].present?
+              if element_type == 'card' && element["buttons"].size > 3
+                raise(ArgumentError, "Facebook card elements only support 3 buttons.")
+              end
+
+              if element_type == 'list' && element["buttons"].size > 1
+                raise(ArgumentError, "Facebook list elements only support 1 button.")
+              end
+
+              fb_buttons = generate_buttons(buttons: element["buttons"])
+              template["buttons"] = fb_buttons
+            end
+
+            template
+          end
+
+          def attachment_template(attachment_type:, attachment_url:)
+            {
+              "type" => attachment_type,
+              "payload" => {
+                "url" => attachment_url
+              }
+            }
+          end
+
+          def button_attachment_template(text:, buttons:)
+            {
+              "type" => "template",
+              "payload" => {
+                "template_type" => "button",
+                "text"          => text,
+                "buttons"       => buttons
+              }
+            }
+          end
+
+          def sender_action_template(action:)
+            {
+              "recipient" => {
+                "id" => recipient_id
+              },
+              "sender_action" => action
+            }
+          end
+
+          def generate_card_elements(elements:)
+            if elements.size > 10
+              raise(ArgumentError, "Facebook cards can have at most 10 cards.")
+            end
+
+            fb_elements = elements.collect do |element|
+              element_template(element_type: 'card', element: element)
+            end
+
+            fb_elements
+          end
+
+          def generate_list_elements(elements:)
+            if elements.size < 2 || elements.size > 4
+              raise(ArgumentError, "Facebook lists must have 2-4 elements.")
+            end
+
+            fb_elements = elements.collect do |element|
+              element_template(element_type: 'list', element: element)
+            end
+
+            fb_elements
+          end
+
+          def generate_suggestions(suggestions:)
+            quick_replies = suggestions.collect do |suggestion|
+              # If the user selected a location-type button, no other info needed
+              if suggestion["type"] == 'location'
+                quick_reply = { "content_type" => "location" }
+
+              # Facebook only supports these two types for now
+              else
+                quick_reply = {
+                  "content_type" => "text",
+                  "title" => suggestion["text"]
+                }
+
+                if suggestion["payload"].present?
+                  quick_reply["payload"] = suggestion["payload"]
+                else
+                  quick_reply["payload"] = suggestion["text"]
+                end
+
+                if suggestion["image_url"].present?
+                  quick_reply["image_url"] = suggestion["image_url"]
+                end
+              end
+
+              quick_reply
+            end
+
+            quick_replies
+          end
+
+          # Requires adding support for Buy, Log In, Log Out, and Share button types
+          def generate_buttons(buttons:)
+            fb_buttons = buttons.collect do |button|
+              case button['type']
+              when 'url'
+                button = {
+                  "type" => "web_url",
+                  "url" => button["url"],
+                  "title" => button["text"]
+                }
+
+                if button["webview_height"].present?
+                  button["webview_height_ratio"] = button["webview_height"]
+                end
+
+                button
+
+              when 'payload'
+                button = {
+                  "type" => "postback",
+                  "payload" => button["payload"],
+                  "title" => button["text"]
+                }
+
+              when 'call'
+                button = {
+                  "type" => "phone_number",
+                  "payload" => button["phone_number"],
+                  "title" => button["text"]
+                }
+
+              when 'nested'
+                button = {
+                  "type" => "nested",
+                  "title" => button["text"],
+                  "call_to_actions" => generate_buttons(buttons: button["buttons"])
+                }
+
+              else
+                raise(Stealth::Errors::ServiceImpaired, "Sorry, we don't yet support #{button["type"]} buttons yet!")
+              end
+
+              button
+            end
+
+            fb_buttons
+          end
+
+          def generate_default_action(action_params:)
+            default_action = {
+              "type" => "web_url",
+              "url" => action_params["url"]
+            }
+
+            if action_params["webview_height"].present?
+              action_params["webview_height_ratio"] = action_params["webview_height"]
+            end
+
+            default_action
+          end
+
+          def check_if_arguments_are_valid!(suggestions:, buttons:)
+            if suggestions.present? && buttons.present?
+              raise(ArgumentError, "A reply cannot have buttons and suggestions!")
+            end
+          end
+
+          def greeting
+            Stealth.config.facebook.setup.greeting.map do |greeting|
+              {
+                "locale" => greeting["locale"],
+                "text" => greeting["text"]
+              }
+            end
+          end
+
+          def persistent_menu
+            Stealth.config.facebook.setup.persistent_menu.map do |persistent_menu|
+              {
+                "locale" => persistent_menu['locale'],
+                "composer_input_disabled" => (persistent_menu['composer_input_disabled'] || false),
+                "call_to_actions" => generate_buttons(buttons: persistent_menu['call_to_actions'])
+              }
+            end
+          end
+
+          def get_started
+            Stealth.config.facebook.setup.get_started
+          end
+      end
+
+    end
+  end
+end

data/lib/stealth/services/facebook/setup.rb

@@ -0,0 +1,25 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+require 'stealth/services/facebook/client'
+
+module Stealth
+  module Services
+    module Facebook
+
+      class Setup
+
+        class << self
+          def trigger
+            reply_handler = Stealth::Services::Facebook::ReplyHandler.new
+            reply = reply_handler.messenger_profile
+            client = Stealth::Services::Facebook::Client.new(reply: reply, endpoint: 'messenger_profile')
+            client.transmit
+          end
+        end
+
+      end
+
+    end
+  end
+end

data/lib/stealth/services/facebook/version.rb

@@ -0,0 +1,16 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  module Services
+    module Facebook
+      module Version
+        def self.version
+          File.read(File.join(File.dirname(__FILE__), '..', '..', '..', '..', 'VERSION')).strip
+        end
+      end
+
+      VERSION = Version.version
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+
+require 'stealth'
+require 'stealth-facebook'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }
+
+RSpec.configure do |config|
+
+end

data/spec/version_spec.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Stealth::Services::Facebook::Version" do
+
+  let(:version_in_file) { File.read(File.join(File.dirname(__FILE__), '..', 'VERSION')).strip }
+
+  it "should return the current gem version" do
+    expect(Stealth::Services::Facebook::Version.version).to eq version_in_file
+  end
+
+  it "should return the current gem version via a constant" do
+    expect(Stealth::Services::Facebook::VERSION).to eq version_in_file
+  end
+end

data/stealth-facebook.gemspec

@@ -0,0 +1,26 @@
+$LOAD_PATH.push File.expand_path('../lib', __FILE__)
+
+version = File.read(File.join(File.dirname(__FILE__), 'VERSION')).strip
+
+Gem::Specification.new do |s|
+  s.name = 'stealth-facebook'
+  s.summary = 'Stealth Facebook Messenger driver'
+  s.description = 'Facebook Messenger driver for Stealth.'
+  s.homepage = 'https://github.com/whoisblackops/stealth-facebook'
+  s.licenses = ['MIT']
+  s.version = version
+  s.author = 'Mauricio Gomes'
+  s.email = 'mauricio@edge14.com'
+
+  s.add_dependency 'stealth', '~> 0.9'
+  s.add_dependency 'faraday', '~> 0.13'
+
+  s.add_development_dependency 'rspec', '~> 3.6'
+  s.add_development_dependency 'rspec_junit_formatter', '~> 0.3'
+  s.add_development_dependency 'rack-test', '~> 0.7'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  s.require_paths = ['lib']
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stealth-facebook
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Mauricio Gomes
@@ -85,7 +85,26 @@ email: mauricio@edge14.com
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- ".circleci/config.yml"
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- VERSION
+- lib/stealth-facebook.rb
+- lib/stealth/facebook.rb
+- lib/stealth/services/facebook/client.rb
+- lib/stealth/services/facebook/events/message_event.rb
+- lib/stealth/services/facebook/events/postback_event.rb
+- lib/stealth/services/facebook/message_handler.rb
+- lib/stealth/services/facebook/reply_handler.rb
+- lib/stealth/services/facebook/setup.rb
+- lib/stealth/services/facebook/version.rb
+- spec/spec_helper.rb
+- spec/version_spec.rb
+- stealth-facebook.gemspec
 homepage: https://github.com/whoisblackops/stealth-facebook
 licenses:
 - MIT
@@ -110,4 +129,6 @@ rubygems_version: 2.6.12
 signing_key: 
 specification_version: 4
 summary: Stealth Facebook Messenger driver
-test_files: []
+test_files:
+- spec/spec_helper.rb
+- spec/version_spec.rb