Merge pull request #54 from zeddee/implement-onfinish-recording

implemented onFinish attribute for CallFlowRecordStep

voice/callflow.go

@@ -443,6 +443,20 @@ type CallFlowRecordStep struct {
 	//
 	// Allowed values: de-DE, en-AU, en-UK, en-US, es-ES, es-LA, fr-FR, it-IT, nl-NL, pt-BR.
 	TranscribeLanguage string
+
+	// (Optional) OnFinish contains the URL to get a new CallFlow from when the recording terminates and this CallFlowRecordStep ends.
+	//
+	// The URL must contain a schema e.g. http://... or https://...
+	// This attribute is used for chaining call flows. When the current step ends,
+	// a POST request containing information about the recording is sent to the URL specified.
+	// This gets a new callflow from the URL specified, but re-uses the original Call ID and Leg ID i.e. it's the same Call.
+	//
+	// To get at the recording information from the POST request body, you must call (instead of relying on req.Form):
+	// ```go
+	// body,_ := ioutil.ReadAll(req.Body)
+	// recordingInfo := string(body[:])
+	// ```
+	OnFinish string
 }
 
 type jsonCallFlowRecordStep struct {
@@ -454,6 +468,7 @@ type jsonCallFlowRecordStep struct {
 		FinishOnKey        string `json:"finishOnKey"`
 		Transcribe         bool   `json:"transcribe"`
 		TranscribeLanguage string `json:"transcribeLanguage"`
+		OnFinish           string `json:"onFinish"`
 	} `json:"options"`
 }
 
@@ -467,6 +482,7 @@ func (step *CallFlowRecordStep) MarshalJSON() ([]byte, error) {
 	data.Options.FinishOnKey = step.FinishOnKey
 	data.Options.Transcribe = step.Transcribe
 	data.Options.TranscribeLanguage = step.TranscribeLanguage
+	data.Options.OnFinish = step.OnFinish
 	return json.Marshal(data)
 }
 
@@ -483,6 +499,7 @@ func (step *CallFlowRecordStep) UnmarshalJSON(data []byte) error {
 		FinishOnKey:        raw.Options.FinishOnKey,
 		Transcribe:         raw.Options.Transcribe,
 		TranscribeLanguage: raw.Options.TranscribeLanguage,
+		OnFinish:           raw.Options.OnFinish,
 	}
 	return nil
 }