Programmable Voice

With Naxai, you can seamlessly integrate voice call capabilities into your application. We offer comprehensive documentation, code samples, helper libraries, and developer tools to support you every step of the way. Bring your creativity, and let's create something extraordinary together.

Get Started

With just a few lines of code, you'll make your first outgoing phone call with the Voice API Make Call. Choose your programming language to get started.

Purchase a number

Search for and purchase an available phone number capable of making outbound calls. When you initiate an outbound call, use this phone number as the From number.
Contact our sales team if the Buy Phone Numbers option is unavailable for your account.

Create Credentials

First, you must create your API Credentials. They consist of a Client ID and Secret.
Go to Integrations and API Credentials to set new credentials.

Make an outbound call

Now, we're ready to make an outbound call.

We first use the Client ID and Secret to get a Token

curl --request POST \
     --url https://auth.naxai.com/oauth2/token \
     --header 'accept: application/json' \
     --header 'content-type: application/x-www-form-urlencoded' \
     --data 'client_id={{ CLIENT_ID }}' \
     --data 'client_secret={{ SECRET }}' \
     --data grant_type=client_credentials

Next, we get the token from the response, and we perform an outbound call.

Focusing on a few key parameters is essential when making an outbound call.

from - the voice-enabled Naxai phone number you added to your account earlier.
to - the person you would like to call.
language - the Text To Speech (TTS) language used, e.g. fr-FR, nl-BE, ...
voice - the voice type used to play TTS (woman or man)

Request

curl --request POST \
     --url https://api.naxai.com/voice/call \
     --header 'accept: application/json' \
     --header 'authorization: Bearer {{TOKEN}} ' \
     --header 'content-type: application/json' \
     --data '
{
  "from": "3225505050",
  "to": "32478459098",
  "language": "en-UK",
  "voice": "woman",
  "welcome": {
    "say": "Hello World !"
  }
}
'`

Response

{
    "batchId": "",
    "count": 1,
    "calls": [
        {
            "callId": "e58e0a9c-ce89-427e-a317-867895ba3ed5",
            "to": "32478459098"
        }
    ]
}

Where to next?

You can retrieve your metrics for outbound calls or the Activity Logs related to your calls using our API or accessing the Voice Reports in your dashboard.