Add test cases for Articles, Messages export, and tag functionality

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

@@ -0,0 +1,88 @@
+<?php
+
+namespace Intercom;
+
+use Http\Client\Exception;
+use stdClass;
+
+class IntercomArticles extends IntercomResource
+{
+    /**
+     * Creates an Article.
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/v0/reference#create-an-article
+     * @param  array $options
+     * @return stdClass
+     * @throws Exception
+     */
+    public function create(array $options)
+    {
+        return $this->client->post("articles", $options);
+    }
+
+    /**
+     * Gets a single Article based on the Article ID.
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/v0/reference#retrieve-an-article
+     * @param  string $id
+     * @param  array  $options
+     * @return stdClass
+     * @throws Exception
+     */
+    public function getArticle(string $id, array $options = [])
+    {
+        $path = $this->articlePath($id);
+        return $this->client->get($path, $options);
+    }
+
+    /**
+     * Updates an existing Article
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/v0/reference#update-an-article
+     * @param string $id
+     * @param array $options
+     * @return stdClass
+     */
+    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.
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/v0/reference#delete-an-article
+     * @param  string $id
+     * @param  array  $options
+     * @return stdClass
+     * @throws Exception
+     */
+    public function deleteArticle(string $id, array $options = [])
+    {
+        $path = $this->articlePath($id);
+        return $this->client->delete($path, $options);
+    }
+
+    /**
+     * Lists Articles.
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/v0/reference#list-all-articles
+     * @param  array $options
+     * @return stdClass
+     * @throws Exception
+     */
+    public function getArticles(array $options = [])
+    {
+        return $this->client->get('articles', $options);
+    }
+
+    /**
+     * @param string $id
+     * @return string
+     */
+    public function articlePath(string $id)
+    {
+        return 'articles/' . $id;
+    }
+}

src/IntercomClient.php

@@ -58,6 +58,11 @@ class IntercomClient
      */
     public $users;
 
+    /**
+     * @var IntercomContacts $contacts
+     */
+    public $contacts;
+
     /**
      * @var IntercomEvents $events
      */
@@ -69,9 +74,9 @@ class IntercomClient
     public $companies;
 
     /**
-     * @var IntercomContacts $contacts
+     * @var IntercomDataAttributes  $dataAttributes
      */
-    public $contacts;
+    public $dataAttributes;
 
     /**
      * @var IntercomMessages $messages
@@ -144,13 +149,16 @@ public function __construct(string $appIdOrToken, string $password = null, array
     {
         $this->users = new IntercomUsers($this);
         $this->contacts = new IntercomContacts($this);
+        //$this->customers = new IntercomCustomers($this);
         $this->events = new IntercomEvents($this);
         $this->companies = new IntercomCompanies($this);
+        $this->dataAttributes = new IntercomDataAttributes($this);
         $this->messages = new IntercomMessages($this);
         $this->conversations = new IntercomConversations($this);
         $this->leads = new IntercomLeads($this);
         $this->visitors = new IntercomVisitors($this);
         $this->admins = new IntercomAdmins($this);
+        $this->articles = new IntercomArticles($this);
         $this->tags = new IntercomTags($this);
         $this->segments = new IntercomSegments($this);
         $this->counts = new IntercomCounts($this);

src/IntercomCompanies.php

@@ -74,7 +74,7 @@ public function detachContact(string $contactId, string $companyId, array $optio
      * @return stdClass
      * @throws Exception
      */
-    public function getCompanies($options)
+    public function getCompanies($options = [])
     {
         return $this->client->get("companies", $options);
     }

src/IntercomContacts.php

@@ -1,5 +1,4 @@
 <?php
-
 namespace Intercom;
 
 use Http\Client\Exception;
@@ -21,17 +20,18 @@ public function create(array $options)
     }
 
     /**
-     * Updates a Contact.
+     * Updates an existing Contact
      *
      * @see    https://developers.intercom.com/intercom-api-reference/reference#update-contact
-     * @param  string $id
      * @param  array $options
      * @return stdClass
      * @throws Exception
      */
+
     public function update(string $id, array $options)
     {
         $path = $this->contactPath($id);
+
         return $this->client->put($path, $options);
     }
 
@@ -43,6 +43,7 @@ public function update(string $id, array $options)
      * @return stdClass
      * @throws Exception
      */
+
     public function getContacts(array $options = [])
     {
         return $this->client->get('contacts', $options);
@@ -57,6 +58,7 @@ public function getContacts(array $options = [])
      * @return stdClass
      * @throws Exception
      */
+
     public function getContact(string $id, array $options = [])
     {
         $path = $this->contactPath($id);
@@ -78,6 +80,83 @@ public function deleteContact(string $id, array $options = [])
         return $this->client->delete($path, $options);
     }
 
+    /**
+     * List attached tags
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/reference#list-tags-of-contact
+     * @param  string $id
+     * @return stdClass
+     * @throws Exception
+     */
+    public function tags(string $id)
+    {
+        $path = $this->contactTagsPath($id);
+
+        return $this->client->get($path);
+    }
+
+    /**
+     * Applys a tag to a Contact based on the provided Tag ID
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/reference#tag-contact
+     * @param  string $id
+     * @param  string  $tagId
+     * @return stdClass
+     * @throws Exception
+     */
+    public function addTag(string $id, string $tagId)
+    {
+        $path = $this->contactTagsPath($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  $tagId
+     * @return stdClass
+     * @throws Exception
+     */
+    public function removeTag(string $id, string $tagId)
+    {
+        $path = $this->contactTagsPath($id);
+
+        return $this->client->delete($path, ['id' => $tagId]);
+    }
+
+    /**
+     * List attached segments
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/reference#list-attached-segments
+     * @param  string $id
+     * @return stdClass
+     * @throws Exception
+     */
+    public function segments(string $id)
+    {
+        $path = $this->contactSegmentsPath($id);
+
+        return $this->client->get($path);
+    }
+
+    /**
+     * List attached companies
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/reference#list-companies-of-contact
+     * @param  string $id
+     * @return stdClass
+     * @throws Exception
+     */
+    public function companies(string $id)
+    {
+        $path = $this->contactCompaniesPath($id);
+
+        return $this->client->get($path);
+    }
+
     /**
      * Returns list of Contacts that match search query.
      *
@@ -92,6 +171,21 @@ public function search(array $options)
         return $this->client->post($path, $options);
     }
 
+    /**
+     * Gets all data attributes for the Contact model
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/reference#list-data-attributes
+     * @param  array  $options
+     * @return stdClass
+     * @throws Exception
+     */
+    public function getAttributes($options = [])
+    {
+        $options = array_merge($options, ["model" => "contact"]);
+
+        return $this->client->get('data_attributes', $options);
+    }
+
     /**
      * Returns next page of Contacts that match search query.
      *
@@ -130,4 +224,39 @@ public function contactPath(string $id)
     {
         return 'contacts/' . $id;
     }
+
+    /**
+     * Returns the path for viewing/adding/removing a tag for a given contact
+     *
+     * @param string $id Contact ID
+     * @return string
+     */
+    public function contactTagsPath(string $id)
+    {
+        return 'contacts/' . $id . '/tags';
+    }
+
+    /**
+     * Returns the path for viewing segments for a given contact
+     *
+     * @param string $id Contact ID
+     * @return string
+     */
+    public function contactSegmentsPath(string $id)
+    {
+        return 'contacts/' . $id . '/segments';
+    }
+
+    /**
+     * Returns the path for viewing companies for a given contact
+     *
+     * @param string $id Contact ID
+     * @return string
+     */
+    public function contactCompaniesPath(string $id)
+    {
+        return 'contacts/' . $id . '/companies';
+    }
+
+
 }