Merge remote-tracking branch 'origin/master' into master

Author: mgomes

README.md

@@ -189,14 +189,14 @@ These are standard text replies. It can sent like:
 
 ```yaml
 - reply_type: text
-  text: Hello World!
+  text: "Hello World!"
 ```
 
 Text replies can also include suggestions, which will be rendered as quick replies:
 
 ```yaml
 - reply_type: text
-  text: What is your favorite color?
+  text: "What is your favorite color?"
   suggestions:
     - text: Blue
     - text: Red
@@ -206,7 +206,7 @@ Text replies can also include buttons:
 
 ```yaml
 - reply_type: text
-  text: Would you like to give us a call?
+  text: "Would you like to give us a call?"
   buttons:
     - type: call
       phone_number: "+15552991212"
@@ -292,7 +292,7 @@ This is the most common button type. When a user presses a button that is `paylo
 
 ```yaml
 - reply_type: text
-  text: Please press the button below
+  text: "Please press the button below"
   buttons:
     - type: payload
       text: 'Press me!'
@@ -308,25 +308,29 @@ The `url` button is useful when sharing a link to a website. By default, it will
 
 ```yaml
 - reply_type: text
-  text: Find out more via our website
+  text: "Find out more via our website"
   buttons:
     - type: url
       text: 'Visit website'
       url: 'https://example.org'
+      messenger_extensions: true
 
 ```
 
+Enabling messenger_extensions allows your webview to access a selection of features from the Messenger platform. More info [here](https://developers.facebook.com/docs/messenger-platform/webview/extensions?source=post_page). Without this parameter set to true, the webview opens in a separate tab or window if a user is visiting from the 'messenger.com' domain.
+
 You can also specify the height of the webview window that opens up in Messenger via: `webview_height`. You can choose between `compact`, `tall`, and `full`.
 
 More info [here](https://developers.facebook.com/docs/messenger-platform/webview).
 
+
 #### call
 
 The `call` button type will prompt the user to dial the specified number. The number will be pre-filled in, but the user will still have to confirm by confirming via the modal that is shown. To create a `call` button:
 
 ```yaml
 - reply_type: text
-  text: Give us a ring!
+  text: "Give us a ring!"
   buttons:
     - type: call
       text: 'Call'
@@ -460,3 +464,35 @@ To send an audio clip:
 The `audio_url` should be set to URL where the video has been uploaded.
 
 Audio replies support buttons and suggestions like text replies.
+
+### Account Linking
+
+Account Linking allows you to invite users to log-in using your own authentication flow, and to receive a Messenger page-scoped ID (PSID) upon completion. You can find more info about Facebook Account Linking [here](https://developers.facebook.com/docs/messenger-platform/identity/account-linking).
+
+#### Login
+
+The `login` button type will prompt the user to log-in using your own authentication flow in the case he or she has an account with your business. You can find more info about Facebook Log In Button [here](https://developers.facebook.com/docs/messenger-platform/reference/buttons/login).
+
+To create a `login` button:
+
+```yaml
+- reply_type: text
+  text: "Log in to access your account information."
+  buttons:
+    - type: login
+      url: "https://my-app.com/login"
+```
+
+#### Logout
+
+The `logout` button type is used in the account linking flow to unlink the message recipient's identity on Messenger with their account on your site. You can find more info about Facebook Log Out Button [here](https://developers.facebook.com/docs/messenger-platform/reference/buttons/logout).
+
+To create a `logout` button:
+
+```yaml
+- reply_type: text
+  text: "Log out"
+  buttons:
+    - type: logout
+```
+

lib/stealth/services/facebook/reply_handler.rb

@@ -427,6 +427,17 @@ def generate_buttons(buttons:)
                   "title" => button["text"]
                 }
 
+              when 'login'
+                _button = {
+                  "type" => "account_link",
+                  "url" => button["url"]
+                }
+
+              when 'logout'
+                _button = {
+                  "type" => "account_unlink"
+                }
+
               when 'nested'
                 _button = {
                   "type" => "nested",

stealth-facebook.gemspec

@@ -15,7 +15,6 @@ Gem::Specification.new do |s|
   s.add_dependency 'stealth', '>= 2.0.0.beta'
   s.add_dependency 'http', '~> 4.4'
 
-  s.add_development_dependency 'rspec', '~> 3'
   s.add_development_dependency 'rspec_junit_formatter', '~> 0.3'
   s.add_development_dependency 'rack-test', '~> 1.1'