Add Recipient type support.

Author: irazasyed

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-All notable changes to `facebook` will be documented in this file
+All notable changes to this project will be documented in this file
 
 ## 1.0.0 - 201X-XX-XX
 

README.md

@@ -140,7 +140,7 @@ public function routeNotificationForFacebook()
 
 ### Available Message methods
 
-- `to($userIdOrPhoneNumber)`: (string) Recipient's page-scoped User ID or Phone number of with the format `+1(212)555-2368`. **NOTE:** Sending a message to phone numbers requires the `pages_messaging_phone_number` permission. Refer [docs](https://developers.facebook.com/docs/messenger-platform/send-api-reference#phone_number) for more information.
+- `to($pageScopedIdOrPhoneNumber, $type)`: (string) Recipient's page-scoped User `id`, `phone_number`, `user_ref`, `post_id` or `comment_id` (as one of the supported types). Phone number supported format `+1(212)555-2368`. **NOTE:** Sending a message to phone numbers requires the `pages_messaging_phone_number` permission. Refer [docs](https://developers.facebook.com/docs/messenger-platform/send-api-reference#phone_number) for more information.
 - `text('')`: (string) Notification message.
 - `attach($attachment_type, $url)`: (AttachmentType, string) An attachment type (IMAGE, AUDIO, VIDEO, FILE) and the url of this attachment
 - `buttons($buttons = [])`: (array) An array of "Call to Action" buttons (Created using `NotificationChannels\Facebook\Components\Button::create()`). You can add up to 3 buttons of one of the following types: `web_url`, `postback` or `phone_number`. See Button methods below for more details.

src/FacebookMessage.php

@@ -70,11 +70,13 @@ public function __construct(string $text = '')
      * @param  string  $recipient  ID of recipient or Phone number of the recipient
      *                   with the format +1(212)555-2368
      *
+     * @param  string  $type Recipient Type: id, user_ref, phone_number, post_id, comment_id.
+     *
      * @return $this
      */
-    public function to(string $recipient): self
+    public function to(string $recipient, string $type = 'id'): self
     {
-        $this->recipient = $recipient;
+        $this->recipient = [$type => $recipient];
 
         return $this;
     }