Send Voice Message
Base URL:
POST: https://api.smsgatewayapi.com/v1/voice/send
| Parameter | Input | Description | |
|---|---|---|---|
| client_id | API client ID | Login and go to 'Developer' - 'API & Webhooks' - 'API-credentials' to find the API keys | Required |
| client_secret | API client secret | Login and go to 'Developer' - 'API & Webhooks' - 'API-credentials' to find the API keys | Required |
| message | message | the message to be sent | Required |
| to | destination number | the number(s) that will receive the message in international format (eg: 324xx, 316xx, ...) | Required |
| date | Date and time the message will be sent | Format: yyyy-MM-dd HH:mm. If not provided, the message will be sent as soon as possible | Optional |
| reference | custom reference | String of max. 255 characters | Optional |
| language | Language of voice message | possible languages: en-GB (default), en-US, en-CA, en-IE, en-AU, nl-NL, nl-BE, fr-FR, fr-BE, fr-CH, fr-CA, de-DE, de-AT, de-CH, es-ES, it-IT, pt-PT, pt-BR, pl-PL, da-DK, fi-FI, nb-NO, sv-SE, tr-TR, cs-CZ, sr-RS. The short codes en, nl, be, fr, fr_be, de, es, it, pt and pl are still accepted but deprecated. | Optional |
| gender | Gender of the voice | possible genders: 'Female' (default), 'Male' | Optional |
| test | true/false | The system will check all parameters but will not send an VOICE message (no funds used). | Optional |
<?php //PHP - cURL $ch = curl_init(); $url = "https://api.smsgatewayapi.com/v1/voice/send"; $client_id = "XXX"; // Your API client ID (required) $client_secret = "YYY"; // Your API client secret (required) $data = [ 'message' => "Hello World", //Message (required) 'to' => "31681234567", //Receiver (required)
]; curl_setopt($ch, CURLOPT_URL, "$url"); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_VERBOSE, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-Client-Id: $client_id", "X-Client-Secret: $client_secret", "Content-Type: application/json", ]); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); $response = curl_exec($ch); ?>
Example request single receiver:
{
"message": "Hello World",
"to": "{nr}",
"date":"2024-01-01 15:30",
}
Example response single receiver:
{
"messageid": "h2md1ewkyzjkuyn9ak7pryw1evtyw3x"
}
Example request multiple receivers:
{
"message": "Hello World",
"to": ["{nr1}", "{nr2}"],
}
Example response multiple receivers:
{
"messageids": [
"h2md1ewkyzjkuyn9ak7pryw1evtyw3x",
"678rjqhrjwg3r7t78te1yxfda9u3yt6"
]
}
