Merge fbccfed into be8097c

README.md

@@ -76,6 +76,28 @@ Bot.deliver(
 )
 ```
 
+##### Messages with quick replies
+
+The human may appreciate hints:
+
+```ruby
+Bot.deliver(
+  recipient: {
+    id: '45123'
+  },
+  message: {
+    text: 'Human, who is your favorite bot?'
+    quick_replies: [
+      {
+        content_type: 'text',
+        title: 'You are!',
+        payload: 'HARMLESS'
+      }
+    ]
+  }
+)
+```
+
 ##### Messages with buttons
 
 The human may require simple options to communicate:

examples/bot.rb

@@ -8,14 +8,21 @@
 include Facebook::Messenger
 
 Bot.on :message do |message|
-  puts "Received #{message.text} from #{message.sender}"
+  puts "Received '#{message.inspect}' from #{message.sender}"
 
   case message.text
   when /hello/i
     Bot.deliver(
       recipient: message.sender,
       message: {
-        text: 'Hello, human!'
+        text: 'Hello, human!',
+        quick_replies: [
+          {
+            content_type: 'text',
+            title: 'Hello, bot!',
+            payload: 'HELLO_BOT'
+          }
+        ]
       }
     )
   when /something humans like/i

lib/facebook/messenger/incoming/message.rb

@@ -37,8 +37,10 @@ def attachments
           @messaging['message']['attachments']
         end
 
-        def quick_replies
-          @messaging['message']['quick_reply']
+        def quick_reply
+          return nil unless @messaging['message']['quick_reply']
+
+          @messaging['message']['quick_reply']['payload']
         end
       end
     end

spec/facebook/messenger/incoming/message_spec.rb

@@ -14,7 +14,9 @@
         'mid' => 'mid.1457764197618:41d102a3e1ae206a38',
         'seq' => 73,
         'text' => 'Hello, bot!',
-        'quick_reply' => 'Hi, I am a quick reply!',
+        'quick_reply' => {
+          'payload' => 'Hi, I am a quick reply!'
+        },
         'attachments' => [{
           'type' => 'image',
           'payload' => {
@@ -75,9 +77,23 @@
     end
   end
 
-  describe '.quick_replies' do
-    it 'returns the message quick_replies' do
-      expect(subject.quick_replies).to eq(payload['message']['quick_reply'])
+  describe '.quick_reply' do
+    context 'when a quick reply was used' do
+      it 'returns the payload of the quick reply' do
+        expect(subject.quick_reply).to eq(
+          payload['message']['quick_reply']['payload']
+        )
+      end
+    end
+
+    context 'when a quick reply was not used' do
+      before do
+        payload['message'].delete('quick_reply')
+      end
+
+      it 'returns nil' do
+        expect(subject.quick_reply).to eq(nil)
+      end
     end
   end
 end