Contact & Conversation Tagging / Articles / Messages

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($id, $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  array $options
+     * @return stdClass
+     * @throws Exception
+     */
+    public function update($id, $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,16 @@ class IntercomClient
      */
     public $users;
 
+    /**
+     * @var IntercomContacts $contacts
+     */
+    public $contacts;
+
+    /**
+     * @var IntercomCustomers $customers
+     */
+    public $customers;
+
     /**
      * @var IntercomEvents $events
      */
@@ -144,13 +154,15 @@ 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->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;
@@ -25,13 +24,18 @@ public function create(array $options)
      *
      * @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
      * @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 +47,7 @@ public function update(string $id, array $options)
      * @return stdClass
      * @throws Exception
      */
+
     public function getContacts(array $options = [])
     {
         return $this->client->get('contacts', $options);
@@ -57,7 +62,8 @@ public function getContacts(array $options = [])
      * @return stdClass
      * @throws Exception
      */
-    public function getContact(string $id, array $options = [])
+
+    public function getContact($id, $options = [])
     {
         $path = $this->contactPath($id);
         return $this->client->get($path, $options);
@@ -78,6 +84,38 @@ public function deleteContact(string $id, array $options = [])
         return $this->client->delete($path, $options);
     }
 
+    /**
+     * 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  $tag_id
+     * @return stdClass
+     * @throws Exception
+     */
+    public function addTag(string $id, string $tag_id)
+    {
+        $path = $this->contactPath($id);
+
+        return $this->client->post($path.'/tags', ['id' => $tag_id]);
+    }
+
+    /**
+     * 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
+     * @return stdClass
+     * @throws Exception
+     */
+    public function removeTag(string $id, string $tag_id)
+    {
+        $path = $this->contactPath($id);
+
+        return $this->client->delete($path.'/tags', ['id' => $tag_id]);
+    }
+
     /**
      * Returns list of Contacts that match search query.
      *

src/IntercomConversations.php

@@ -108,6 +108,40 @@ public function markConversationAsRead($id)
         return $this->client->put($path, $data);
     }
 
+    /**
+     * Adds a tag to a Conversation based on the provided Tag and Admin ID
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/reference#attach-a-tag-to-a-conversation
+     * @param string $id
+     * @param string $tagId
+     * @param string $adminId
+     * @return stdClass
+     */
+
+    public function addTag($id, $tagId, $adminId) {
+
+        $path = $this->conversationPath($id);
+
+        return $this->client->post($path.'/tags', ['id' => $tagId, 'admin' => $adminId]);
+    }
+
+    /**
+     * Removes a tag to a Conversation based on the provided Tag and Admin ID
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/reference#attach-a-tag-to-a-conversation
+     * @param string $id
+     * @param string $tagId
+     * @param string $adminId
+     * @return stdClass
+     */
+
+    public function removeTag($id, $tagId) {
+
+        $path = $this->conversationPath($id);
+
+        return $this->client->delete($path.'/tags', ['id' => $tagId]);
+    }
+
     /**
      * Returns endpoint path to Conversation with given ID.
      *

src/IntercomMessages.php

@@ -19,4 +19,45 @@ public function create($options)
     {
         return $this->client->post("messages", $options);
     }
+
+    /**
+     * Creates Message Export Job
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/reference#creating-an-export-job
+     * @param  array $options
+     * @return stdClass
+     * @throws Exception
+     */
+    public function createExport($options)
+    {
+        return $this->client->post("export/messages/data", $options);
+    }
+
+    /**
+     * Retrieves Export Job Status
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/reference#checking-the-status-of-the-job
+     * @param  string $job_identifier
+     * @return stdClass
+     * @throws Exception
+     */
+    public function retrieveExportStatus($job_identifier)
+    {
+        return $this->client->get("export/messages/data/" . $job_identifier, []);
+    }
+
+    /**
+     * Retrieves Export Job Data
+     *
+     * Important: The Intercom Client Accept Header must be application/octet-stream
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/reference#downloading-the-data
+     * @param  string $job_identifier
+     * @return stdClass
+     * @throws Exception
+     */
+    public function retrieveExportData($job_identifier)
+    {
+        return $this->client->get("download/messages/data/" . $job_identifier, []);
+    }
 }