Merge pull request #166 from Nexmo/ncco-param-create-call

Add NCCO parameter support for PHP

Author: lornajane

README.md

@@ -321,6 +321,27 @@ $client->calls()->create([
 ]);
 ```
 
+Or you can provide an NCCO directly in the POST request
+
+```
+$call = $client->calls()->create([
+    'to' => [[
+        'type' => 'phone',
+        'number' => '14843331234'
+    ]],
+    'from' => [
+        'type' => 'phone',
+        'number' => '14843335555'
+    ],
+    'ncco' => [
+        [
+            'action' => 'talk',
+            'text' => 'This is a text to speech call from Nexmo'
+        ]
+    ]
+]);
+```
+
 Or you can create a `Nexmo\Call\Call` object, and use that:
 
 ```php
@@ -334,6 +355,23 @@ $call->setTo('14843331234')
 $client->calls()->create($call);
 ```
 
+The same example, providing an NCCO directly:
+
+```php
+use Nexmo\Call\Call;
+$call = new Call();
+$call->setTo('14843331234')
+     ->setFrom('14843335555')
+     ->setNcco([
+        [
+            'action' => 'talk',
+            'text' => 'This is a text to speech call from Nexmo'
+        ]
+      ]);
+
+$client->calls()->create($call);
+```
+
 ### Fetching a Call
 
 You can fetch a call using a `Nexmo\Call\Call` object, or the call's UUID as a string:
@@ -594,6 +632,7 @@ API Coverage
             * [X] Campaign Subscription Management
 * Voice
     * [X] Outbound Call
+    * [X] Outbound Call with an NCCO
     * [X] Inbound Call
     * [X] Text-To-Speech Call
     * [X] Text-To-Speech Prompt

src/Call/Call.php

@@ -195,6 +195,11 @@ public function setTimeout($type, $length)
         $this->data[$type . '_timeout'] = $length;
     }
 
+    public function setNcco($ncco) {
+        $this->data['ncco'] = $ncco;
+        return $this;
+    }
+
     public function getStatus()
     {
         if($this->lazyLoad()){

test/Call/CollectionTest.php

@@ -135,6 +135,26 @@ public function testCreatePostCall($payload, $method)
         $this->assertInstanceOf('Nexmo\Call\Call', $call);
         $this->assertEquals('e46fd8bd-504d-4044-9600-26dd18b41111', $call->getId());
     }
+
+    /**
+     * @dataProvider postCallNcco
+     */
+    public function testCreatePostCallNcco($payload)
+    {
+        $this->nexmoClient->send(Argument::that(function(RequestInterface $request) use ($payload){
+            $ncco = [['action' => 'talk', 'text' => 'Hello World']];
+
+            $this->assertRequestUrl('api.nexmo.com', '/v1/calls', 'POST', $request);
+            $this->assertRequestBodyIsJson(json_encode($payload), $request);
+            $this->assertRequestJsonBodyContains('ncco', $ncco, $request);
+            return true;
+        }))->willReturn($this->getResponse('created', '201'));
+
+        $call = $this->collection->post($payload);
+
+        $this->assertInstanceOf('Nexmo\Call\Call', $call);
+        $this->assertEquals('e46fd8bd-504d-4044-9600-26dd18b41111', $call->getId());
+    }
 
     /**
      * @dataProvider postCall
@@ -228,6 +248,45 @@ public function getCall()
         ];
     }
 
+    /**
+     * Creating a call with an NCCO can take a Call object or a simple array.
+     * @return array
+     */
+    public function postCallNcco()
+    {
+        $raw = [
+            'to' => [[
+                'type' => 'phone',
+                'number' => '14843331234'
+            ]],
+            'from' => [
+                'type' => 'phone',
+                'number' => '14843335555'
+            ],
+            'ncco' => [
+                [
+                    'action' => 'talk',
+                    'text' => 'Hello World'
+                ]
+            ]
+        ];
+
+
+        $call = new Call();
+        $call->setTo('14843331234')
+             ->setFrom('14843335555')
+             ->setNcco([
+                 [
+                     'action' => 'talk',
+                     'text' => 'Hello World'
+                 ]
+             ]);
+
+        return [
+            'object' => [clone $call],
+            'array' => [$raw]
+        ];
+    }
     /**
      * Creating a call can take a Call object or a simple array.
      * @return array