facebook-messenger 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 55e300c4f11036d518035144eaf94581e5e99ce5
-  data.tar.gz: ca59746d98d4fab7f37284468fe57c6cf6414106
+  metadata.gz: a97b014f458381225a5cf3b76148fdf1b240348a
+  data.tar.gz: 6a3d1c139c2aa42f3891864b1080b8af1f782ecc
 SHA512:
-  metadata.gz: 3b3e31067f8f111b86d712d68566b8f6de895ccd016a71d47b8ccc9b6a886cd99a1e84db20ec2860f006903b63cef874656a0cfc383cc0b7d6f728b32df9022c
-  data.tar.gz: 3dc23071c67f9060f27125646afb8236c5cac30b101311ac880242611b141a80ff31012642ff04e89a93a6d100e8d7498713a565dedb91d39748810ea579564e
+  metadata.gz: bb9b1c17ab1057e49489153deb9fa94384abcbe550114101f1b2f16cdd5b8b3fba9b8640b241af14ada44f51f1502b345e1168d5b7e089144f4b7afd50be4ecc
+  data.tar.gz: d4b2d577c290b9caf6cb02861f6a1e592bb2e313918e875d5a4055db3751da9eec7651af67fcfe82b7213b7a561e823a5e8affb9c8c81121db3dd4e25bd97a0c

data/README.md

@@ -155,6 +155,14 @@ Bot.on :delivery do |delivery|
 end
 ```
 
+#### Set a welcome message
+
+You can greet new humans to entice them into talking to you:
+
+```ruby
+Facebook::Messenger::Welcome.set text: 'Hello, human!'
+```
+
 ## Configuration
 
 ### Create an Application on Facebook

data/lib/facebook/messenger.rb

@@ -1,6 +1,7 @@
 require 'facebook/messenger/version'
 require 'facebook/messenger/error'
 require 'facebook/messenger/subscriptions'
+require 'facebook/messenger/welcome'
 require 'facebook/messenger/bot'
 require 'facebook/messenger/server'
 require 'facebook/messenger/configuration'

data/lib/facebook/messenger/version.rb

@@ -1,5 +1,5 @@
 module Facebook
   module Messenger
-    VERSION = '0.6.0'.freeze
+    VERSION = '0.7.0'.freeze
   end
 end

data/lib/facebook/messenger/welcome.rb

@@ -0,0 +1,61 @@
+require 'httparty'
+
+module Facebook
+  module Messenger
+    # This module handles setting welcome messages.
+    #
+    # https://developers.facebook.com/docs/messenger-platform/send-api-reference#welcome_message_configuration
+    module Welcome
+      include HTTParty
+
+      base_uri 'https://graph.facebook.com/v2.6/me'
+
+      format :json
+
+      module_function
+
+      def set(message)
+        response = post '/thread_settings',
+                        body: welcome_setting_for(message).to_json
+
+        raise_errors(response)
+
+        true
+      end
+
+      def unset
+        response = post '/thread_settings',
+                        body: welcome_setting_for(nil).to_json
+
+        raise_errors(response)
+
+        true
+      end
+
+      def raise_errors(response)
+        raise Error, response['error']['message'] if response.key? 'error'
+      end
+
+      def default_options
+        super.merge(
+          query: {
+            access_token: Facebook::Messenger.config.access_token
+          },
+          headers: {
+            'Content-Type' => 'application/json'
+          }
+        )
+      end
+
+      def welcome_setting_for(payload)
+        {
+          setting_type: 'call_to_actions',
+          thread_state: 'new_thread',
+          call_to_actions: payload ? [{ message: payload }] : []
+        }
+      end
+
+      class Error < Facebook::Messenger::Error; end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: facebook-messenger
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Johannes Gorset
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-06-08 00:00:00.000000000 Z
+date: 2016-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -173,6 +173,7 @@ files:
 - lib/facebook/messenger/server.rb
 - lib/facebook/messenger/subscriptions.rb
 - lib/facebook/messenger/version.rb
+- lib/facebook/messenger/welcome.rb
 homepage: https://github.com/hyperoslo/facebook-messenger
 licenses:
 - MIT