Voice API Overview

Install the Nexmo Node library:

npm install nexmo

Create an index.js:

const Nexmo = require('nexmo')

const nexmo = new Nexmo({
  apiKey: API_KEY,
  apiSecret: API_SECRET,
  applicationId: APPLICATION_ID,
  privateKey: PRIVATE_KEY
})

nexmo.calls.create({
  from: {
    type: 'phone',
    number: FROM_NUMBER
  },
  to: [{
    type: 'phone',
    number: TO_NUMBER
  }],
  answer_url: ['https://nexmo-community.github.io/ncco-examples/first_call_talk.json']
}, (error, response) => {
  if (error) {
    console.error(error)
  } else {
    console.log(response)
  }
})

Run the application:

node index.js

Create your build.gradle file and list your dependencies:

// build.gradle

repositories {
    mavenCentral()
}

dependencies {
    compile 'com.nexmo:client:2.0.2'
}

task fatJar(type: Jar, dependsOn:configurations.runtime) {
    baseName = project.name + '-with-dependencies'
    from { configurations.runtime.collect { it.isDirectory() ? it : zipTree(it) } }
    with jar
}
assemble.dependsOn fatJar

Create a Java source file that uses the client library to make a call. Replace APPLICATION_ID, PRIVATE_KEY_PATH, TO_NUMBER, and FROM_NUMBER with your values.

// src/main/java/mypackage/MakeCall.class
package mypackage;

import com.nexmo.client.NexmoClient;
import com.nexmo.client.auth.JWTAuthMethod;
import com.nexmo.client.voice.Call;

import java.nio.file.FileSystems;

public class MakeCall {
    public static void main(String[] args) throws Exception {
        NexmoClient client = new NexmoClient(new JWTAuthMethod(
                "APPLICATION_ID",
                FileSystems.getDefault().getPath("PRIVATE_KEY_PATH")
        ));
        client.getVoiceClient().createCall(new Call(
                "TO_NUMBER",
                "FROM_NUMBER",
                "https://nexmo-community.github.io/ncco-examples/first_call_talk.json"
        ));
    }
}

Build a JAR file containing the class and the nexmo client library:

gradle build

Run the application:

java -cp "build/libs/PROJECT-with-dependencies.jar" "mypackage.MakeCall"

Install the Nexmo PHP client

composer require nexmo/client:@beta

Create an index.php:

<?php 
require_once __DIR__ . '/../config.php';

require_once 'vendor/autoload.php';

$basic  = new \Nexmo\Client\Credentials\Basic(API_KEY, API_SECRET);
$keypair = new \Nexmo\Client\Credentials\Keypair(file_get_contents(PRIVATE_KEY), APPLICATION_ID);

$client = new \Nexmo\Client(new \Nexmo\Client\Credentials\Container($basic, $keypair));

$call = $client->calls()->create([
    'to' => [[
        'type' => 'phone',
        'number' => TO_NUMBER
    ]],
    'from' => [
        'type' => 'phone',
        'number' => FROM_NUMBER
    ],
    'answer_url' => ['https://nexmo-community.github.io/ncco-examples/first_call_talk.json'],
]);

error_log($call);

Run:

php index.php

Install the Nexmo Python package:

pip install nexmo

Create a call.py:

import nexmo

PRIVATE_KEY = open(PRIVATE_KEY_PATH, 'r').read()
client = nexmo.Client(key=API_KEY, secret=API_SECRET,
    application_id=APPLICATION_ID, private_key=PRIVATE_KEY)

response = client.create_call({
  'to': [{'type': 'phone', 'number': 'TO_NUMBER'}],
  'from': {'type': 'phone', 'number': 'FROM_NUMBER'},
  'answer_url': ['https://nexmo-community.github.io/ncco-examples/first_call_talk.json']
})

Run:

python call.py

Install the Nexmo Ruby library

gem install nexmo

Create app.rb

require 'nexmo'
PRIVATE_KEY = File.read(PRIVATE_KEY_PATH)

client = Nexmo::Client.new(
  application_id: APPLICATION_ID,
  private_key: PRIVATE_KEY
)

client.create_call(
  from: { type: 'phone', number: FROM_NUMBER },
  to: [{ type: 'phone', number: TO_NUMBER }],
  answer_url: [
    'https://nexmo-community.github.io/ncco-examples/first_call_talk.json'
  ]
)

Run the application:

ruby app.rb