add missing conversations calls (#186)

* Update IntercomConversations, add missing route support

Add support for replying to user's last conversation and also marking a conversation as read

* update IntercomClient, add put support

Add HTTP PUT method support to IntercomClient

* update README with new conversations methods

update README with usage examples on replyToLastConversation() and markConversationAsRead()

* formatting fix

* add createMessage to IntercomConversations

implement message creation and make IntercomConversations interface backwards compatible with previous versions of intercom/intercom-php

* remove createMessage on IntercomConversations

duplicate functionality; createMessage exists on IntercomMessages

* Update IntercomUsers.php

Author: luoshiben

README.md

@@ -209,6 +209,19 @@ $client->conversations->replyToConversation("5678", [
   "type" => "user",
   "message_type" => "comment"
 ]);
+
+//Reply to a user's last conversation
+// See more options here: https://developers.intercom.com/reference#replying-to-users-last-conversation
+$client->conversations->replyToLastConversation([
+  "email" => "[email protected]",
+  "body" => "Thanks :)",
+  "type" => "user",
+  "message_type" => "comment"
+]);
+
+// Mark a conversation as read
+// See API documentation here: https://developers.intercom.io/reference#marking-a-conversation-as-read
+$client->conversations->markConversationAsRead("7890");
 ```
 
 ## Counts

src/IntercomClient.php

@@ -110,6 +110,25 @@ public function post($endpoint, $json)
         ]);
         return $this->handleResponse($response);
     }
+    
+    /**
+     * Sends PUT request to Intercom API.
+     * @param string $endpoint
+     * @param string $json
+     * @return mixed
+     * @throws \GuzzleHttp\Exception\GuzzleException
+     */
+    public function put($endpoint, $json)
+    {
+        $response = $this->http_client->request('PUT', "https://api.intercom.io/$endpoint", [
+            'json' => $json,
+            'auth' => $this->getAuth(),
+            'headers' => [
+                'Accept' => 'application/json'
+            ]
+        ]);
+        return $this->handleResponse($response);
+    }
 
     /**
      * Sends DELETE request to Intercom API.

src/IntercomConversations.php

@@ -25,7 +25,7 @@ public function __construct($client)
    */
   public function getConversations($options)
   {
-    return $this->client->get("conversations", $options);
+    return $this->client->get('conversations', $options);
   }
 
   /**
@@ -52,15 +52,40 @@ public function replyToConversation($id, $options) {
     $path = $this->conversationReplyPath($id);
     return $this->client->post($path, $options);
   }
-
+  
+   /**
+   * Creates Conversation Reply to last conversation. (no need to specify Conversation ID.)
+   * @see https://developers.intercom.io/reference#replying-to-users-last-conversation
+   * @param array $options
+   * @return mixed
+   * @throws \GuzzleHttp\Exception\GuzzleException
+   */
+  public function replyToLastConversation($options) {
+    $path = 'conversations/last/reply';
+    return $this->client->post($path, $options);
+  }
+  
+   /**
+   * Marks a Conversation as read based on the given Conversation ID.
+   * @see https://developers.intercom.io/reference#marking-a-conversation-as-read
+   * @param string $id
+   * @return mixed
+   * @throws \GuzzleHttp\Exception\GuzzleException
+   */
+  public function markConversationAsRead($id) {
+    $path = $this->conversationPath($id); 
+    $data = ['read' => true];
+    return $this->client->put($path, $data);
+  }
+  
   /**
    * Returns endpoint path to Conversation with given ID.
    * @param string $id
    * @return string
    */
   public function conversationPath($id)
   {
-    return "conversations/" . $id;
+    return 'conversations/' . $id;
   }
 
   /**
@@ -70,6 +95,6 @@ public function conversationPath($id)
    */
   public function conversationReplyPath($id)
   {
-    return "conversations/" . $id . "/reply";
+    return 'conversations/' . $id . '/reply';
   }
 }

src/IntercomUsers.php

@@ -37,15 +37,43 @@ public function create($options)
    */
   public function getUsers($options)
   {
-    return $this->client->get("users", $options);
+    return $this->client->get('users', $options);
   }
 
+  /**
+   * Gets a single User based on the Intercom ID.
+   * @see https://developers.intercom.com/reference#view-a-user
+   * @param integer $id
+   * @param array $options
+   * @return mixed
+   * @throws \GuzzleHttp\Exception\GuzzleException
+   */
   public function getUser($id, $options = [])
   {
     $path = $this->userPath($id);
     return $this->client->get($path, $options);
   }
+  
+  /**
+   * Gets a list of Users through the user scroll API.
+   * @see https://developers.intercom.com/reference#iterating-over-all-users
+   * @param array $options
+   * @return mixed
+   * @throws \GuzzleHttp\Exception\GuzzleException
+   */  
+  public function scrollUsers($options = [])
+  {
+    return $this->client->get('users/scroll', $options);
+  }
 
+  /**
+   * Deletes a single User based on the Intercom ID.
+   * @see https://developers.intercom.com/reference#delete-a-user
+   * @param integer $id
+   * @param array $options
+   * @return mixed
+   * @throws \GuzzleHttp\Exception\GuzzleException
+   */
   public function deleteUser($id, $options = [])
   {
     $path = $this->userPath($id);
@@ -54,6 +82,6 @@ public function deleteUser($id, $options = [])
 
   public function userPath($id)
   {
-    return "users/" . $id;
+    return 'users/' . $id;
   }
 }