Record call in the background. Unlike the [record method](./record.mdx), the record_call method will start the recording and continue executing the SWML script while allowing the recording to happen in the background. To stop call recordings started with record_call, use the [stop_call_record](./stop_record_call.mdx) method. | Name | Type | Default | Description | |:|:|:--|:--| | record_callRequired | object | - | An object that accepts the [record_call parameters](#record_call-parameters). | ## **record_call Parameters** | Name | Type | Default | Description | |:--|:-|:|:-| | control_idOptional | string | Auto-generated and saved to record_control_id variable | Identifier for this recording, to use with [stop_record_call](./stop_record_call.mdx) | | stereoOptional | boolean | false | Whether to record in stereo mode | | formatOptional | string | wav | Format (wav or mp3) | | directionOptional | string | both | Direction of the audio to record: speak for what party says, listen for what party hears, both for what the party hears and says | | terminatorsOptional | string | - | String of digits that will stop the recording when pressed | | beepOptional | boolean | false | Whether to play a beep before recording | | input_sensitivityOptional | number | 44.0 | How sensitive the recording voice activity detector is to background noise? A larger value is more sensitive. Allowed values from 0.0 to 100.0. | | initial_timeoutOptional | number | 0 | How long, in seconds, to wait for speech to start? | | end_silence_timeoutOptional | number | 0 | How much silence, in seconds, will end the recording? | ## **Variables** Set by the method: - **record_call_url:** (out) the URL of the newly started recording. - **record_call_result:** (out) success | failed. ## **Examples** ### Start an MP3 recording of the call yaml andJson version: 1.0.0 sections: main: - record_call: format: mp3 ### Record and play back #### Record both sides of the conversation: yaml andJson version: 1.0.0 sections: main: - record_call: beep: true terminators: # - play: urls: - say:Leave your message now - silence:10 - stop_record_call: {} - play: urls: - say:Playing back - %{record_call_url} #### Record only the speakers side yaml andJson version: 1.0.0 sections: main: - record_call: beep: true direction: speak - play: urls: - say:Leave your message now - silence:10 - stop_record_call: {} - play: urls: - say:Playing back - %{record_call_url}