Add create conversation method (#338)

* Add create conversation method

* Add test of create conversation method

* Add create conversation method's description to README

Co-authored-by: mass-min <[email protected]>

Author: nakata-koyo

README.md

@@ -432,6 +432,18 @@ $client->messages->create([
 ## Conversations
 
 ```php
+/**
+ * Create a conversation
+ * See more options here: https://developers.intercom.com/intercom-api-reference/reference#create-a-conversation
+ */
+$client->conversations->create([
+    'body' => 'Hello.',
+    'from' => [
+        'id' => '1234',
+        'type' => 'user',
+    ],
+]);
+
 /**
  * List conversations for an admin
  * See more options here: https://developers.intercom.io/reference#list-conversations

src/IntercomConversations.php

@@ -7,6 +7,19 @@
 
 class IntercomConversations extends IntercomResource
 {
+    /**
+     * Creates a Conversation.
+     *
+     * @see    https://developers.intercom.com/intercom-api-reference/reference#create-a-conversation
+     * @param  array $options
+     * @return stdClass
+     * @throws Exception
+     */
+    public function create(array $options)
+    {
+        return $this->client->post('conversations', $options);
+    }
+
     /**
      * Returns list of Conversations.
      *

tests/IntercomConversationsTest.php

@@ -7,6 +7,14 @@
 
 class IntercomConversationsTest extends TestCase
 {
+    public function testConversationCreate()
+    {
+        $this->client->method('post')->willReturn('foo');
+
+        $conversations = new IntercomConversations($this->client);
+        $this->assertSame('foo', $conversations->create([]));
+    }
+
     public function testConversationsList()
     {
         $this->client->method('get')->willReturn('foo');