Contact & Conversation Tagging / Articles / Messages

README.md

@@ -90,6 +90,12 @@ $client->contacts->nextSearch($query, $response->pages);
 
 /** List all contacts */
 $client->contacts->getContacts([]);
+
+/** Tag a Contact */
+$client->contacts->addTag("570680a8a1bcbca8a90001b9", "2084335");
+
+/** Remove a Tag from a Contact */
+$client->contacts->removeTag("570680a8a1bcbca8a90001b9", "2084335");
 ```
 
 ## Users
@@ -489,6 +495,25 @@ $client->teams->getTeams();
 $client->teams->getTeam("1188");
 ```
 
+## Articles
+
+```php
+/** Create an Article */
+$client->articles->create(["title" => "How To Use the Intercom API", "description" => "A quick guide to the universe of the Intercom API", "body" => "<p>This is the body in html</p>", "author_id" => 1]);
+
+/** Retrieve an Article */
+$client->articles->getArticle("123456");
+
+/** Update an Article */
+$client->articles->update("123456", ["title" => "How To Use the Intercom API", "description" => "A quick guide to the universe of the Intercom API", "body" => "<p>This is the body in html</p>");
+
+/** Delete an Article */
+$client->articles->deleteArticle("123456");
+
+/** List Articles */
+$client->articles->getArticles();
+```
+
 
 ## Rate Limits
 

src/IntercomArticles.php

@@ -19,7 +19,7 @@ public function create(array $options)
     {
         return $this->client->post("articles", $options);
     }
-    
+
     /**
      * Gets a single Article based on the Article ID.
      *
@@ -29,7 +29,7 @@ public function create(array $options)
      * @return stdClass
      * @throws Exception
      */
-    public function getArticle($id, $options = [])
+    public function getArticle(string $id, array $options = [])
     {
         $path = $this->articlePath($id);
         return $this->client->get($path, $options);
@@ -39,16 +39,16 @@ public function getArticle($id, $options = [])
      * Updates an existing Article
      *
      * @see    https://developers.intercom.com/intercom-api-reference/v0/reference#update-an-article
-     * @param  array $options
+     * @param string $id
+     * @param array $options
      * @return stdClass
-     * @throws Exception
      */
-    public function update($id, $options = [])
+    public function update(string $id, array $options = [])
     {
         $path = $this->articlePath($id);
         return $this->client->put($path, $options);
     }
-    
+
      /**
      * Deletes a single article based on the Article ID.
      *

src/IntercomContacts.php

@@ -20,10 +20,6 @@ public function create(array $options)
     }
 
     /**
-     * Updates a Contact.
-     *
-     * @see    https://developers.intercom.com/intercom-api-reference/reference#update-contact
-     * @param  string $id
      * Updates an existing Contact
      *
      * @see    https://developers.intercom.com/intercom-api-reference/reference#update-contact
@@ -63,7 +59,7 @@ public function getContacts(array $options = [])
      * @throws Exception
      */
 
-    public function getContact($id, $options = [])
+    public function getContact(string $id, array $options = [])
     {
         $path = $this->contactPath($id);
         return $this->client->get($path, $options);
@@ -89,31 +85,31 @@ public function deleteContact(string $id, array $options = [])
      *
      * @see    https://developers.intercom.com/intercom-api-reference/reference#tag-contact
      * @param  string $id
-     * @param  string  $tag_id
+     * @param  string  $tagId
      * @return stdClass
      * @throws Exception
      */
-    public function addTag(string $id, string $tag_id)
+    public function addTag(string $id, string $tagId)
     {
-        $path = $this->contactPath($id);
+        $path = $this->contactTagsPath($id);
 
-        return $this->client->post($path.'/tags', ['id' => $tag_id]);
+        return $this->client->post($path, ['id' => $tagId]);
     }
 
     /**
      * Removes a tag from a Contact based on the provided Tag ID
      *
      * @see    https://developers.intercom.com/intercom-api-reference/reference#untag-contact
      * @param  string $id
-     * @param  string  $tag_id
+     * @param  string  $tagId
      * @return stdClass
      * @throws Exception
      */
-    public function removeTag(string $id, string $tag_id)
+    public function removeTag(string $id, string $tagId)
     {
-        $path = $this->contactPath($id);
+        $path = $this->contactTagsPath($id);
 
-        return $this->client->delete($path.'/tags', ['id' => $tag_id]);
+        return $this->client->delete($path, ['id' => $tagId]);
     }
 
     /**
@@ -168,4 +164,15 @@ public function contactPath(string $id)
     {
         return 'contacts/' . $id;
     }
+
+    /**
+     * Returns the path for adding/removing a tag for a given contact
+     *
+     * @param string $id Contact ID
+     * @return string
+     */
+    public function contactTagsPath(string $id)
+    {
+        return 'contacts/' . $id . '/tags';
+    }
 }