VoiceNotify API is an API that triggers outbound AI voice calls automatically. Send a POST request to the endpoint, and the AI speaks the message you provide to each recipient.
One request can include multiple calls. Each call is set with a message, a caller ID, a recipient phone number and a language, such as "ja" for Japanese or "en" for English. A time zone reference is used for scheduling and processing the call.
When a call completes, the results are sent to the callback URL you provide. A callback token lets you match each result to your own records. The result includes a call result code that shows whether the call was answered, went to voicemail, was declined, or failed. You can use the codes for reporting, retry logic or automation workflows.
- Endpoint
- POST https://api-v1.delight.fit/voicenotify
- Content type
- application/x-www-form-urlencoded
- Authentication
- Private access_token sent with each request
- Request fields
- access_token, rows
- Call fields (rows)
- message, caller, phone, language, UTC, callback_token, callback_url
- Batch calls
- Multiple calls in one request
- Languages
- Set per call, e.g. "ja" (Japanese), "en" (English)
- Response fields
- success, date, result (count, success_count, errors_count, message)
- Callback fields
- callee, caller, call_result_code
- Result code 200
- Call answered
- Result code 1
- Voicemail detected
- Result code 2
- Initiated by the callee (callee ended the call)
- Result code 3
- End of the scenario (automated calls)
- Result code 486
- Number is busy
- Result codes 408, 487, 500
- Callee didn't answer
- Result code 603
- Call declined
- Result code 404
- Invalid number
- Result code 480
- Callee is unavailable
- Result code 403
- Call not allowed (Do Not Call list or dialing restriction)
- Result code 0
- No call performed
- Campaign types
- Automated and Agent