Simple Callback API

Instead of holding the connection open while Nexiwave transcribes your voicemail to text, Nexiwave can issue a callback to your server when the audio was transcribed.

 

Two simple steps are required:

Nexiwave Callback Flow
Step 1: Post audio just like the synchronized request, but with an additional parameter "deliveryTarget" in the URL. The request will now return as soon as the audio is received.
Example: Post audio with wget:
wget -q --post-file /data/audio/test.wav --user=user@myemail.com --password=mypassword --header="Content-Type: audio/vnd.wav" -O - "https://api.nexiwave.com/SpeechIndexing/recording/?response=application/json&transcriptFormat=html&externalKey=MYKEY123&deliveryTarget=https://mycompany.com/nexiwave123"
The response to this call will be like the synchronized ones, but without the "text" field.
Example response
{"recordingId":12345,"status":"SEND_ON_FINISH"}
Step 2: As soon as the transcript is ready, Nexiwave will issue a HTTP Post call to the callback URL supplied, with the transcript encoded as parameter 'text' in the post body.
A sample Nexiwave HTTP Post CallBack (some HTTP headers omitted for clarity):
POST /nexiwave123?recordingId=12345&externalKey=MYKEY123&status=FINISHED HTTP/1.1
Host: mycompany.com
Content-Length: 50
Content-Type: application/x-www-form-urlencoded

text=Hi%2C+my+name+is+Carla+calling+with+quick.%0A

Your server can now easily decode the transcript and any other parameters in the callback.

 

 

 For more information, consult Nexiwave API document.

 


Terms of Use    © Copyright 2017 Nexiwave
Email:
   legal  
  legal  cancel