detect | SignalWire

Start a detector on an active call. Detectors can identify answering machines, fax tones, or DTMF digits. Returns a control_id for managing the detector.

Request

dialobjectRequired

updateobjectRequired

calling.endobjectRequired

calling.disconnectobjectRequired

calling.ai_holdobjectRequired

calling.ai_unholdobjectRequired

calling.ai_messageobjectRequired

calling.ai.stopobjectRequired

calling.playobjectRequired

calling.play.pauseobjectRequired

calling.play.resumeobjectRequired

calling.play.stopobjectRequired

calling.play.volumeobjectRequired

calling.recordobjectRequired

calling.record.pauseobjectRequired

calling.record.resumeobjectRequired

calling.record.stopobjectRequired

calling.collectobjectRequired

calling.collect.stopobjectRequired

calling.collect.start_input_timersobjectRequired

calling.detectobjectRequired

calling.detect.stopobjectRequired

calling.tapobjectRequired

calling.tap.stopobjectRequired

calling.streamobjectRequired

calling.stream.stopobjectRequired

calling.denoiseobjectRequired

calling.denoise.stopobjectRequired

calling.transcribeobjectRequired

calling.transcribe.stopobjectRequired

calling.live_transcribeobjectRequired

calling.live_translateobjectRequired

calling.transferobjectRequired

calling.send_fax.stopobjectRequired

calling.receive_fax.stopobjectRequired

calling.referobjectRequired

calling.user_eventobjectRequired

Response

Call LegobjectRequired

Fabric Subscriber Device LegobjectRequired

Response Example

Response

1 {
2   "id": "0e9c80d7-a149-4917-892d-420043709f45",
3   "from": "+12069708643",
4   "to": "+15550198765",
5   "direction": "outbound-api",
6   "source": "realtime_api",
7   "charge": 0,
8   "created_at": "2024-05-06T12:20:00Z",
9   "charge_details": [
10     {
11       "description": "Outbound Voice",
12       "charge": 0.004
13     }
14   ],
15   "status": "queued",
16   "type": "relay_pstn_call"
17 }

Examples

Answering Machine Detection

1 from signalwire.rest import RestClient
2 
3 client = RestClient(
4     project="your-project-id",
5     token="your-api-token",
6     host="your-space.signalwire.com",
7 )
8 
9 # Answering machine detection
10 result = client.calling.detect(
11     call_id="call-id-xxx",
12     detect={
13         "type": "machine",
14         "params": {
15             "initial_timeout": 4.5,
16             "end_silence_timeout": 1.0,
17         }
18     },
19     timeout=30.0,
20 )

Fax Detection

1 from signalwire.rest import RestClient
2 
3 client = RestClient(
4     project="your-project-id",
5     token="your-api-token",
6     host="your-space.signalwire.com",
7 )
8 
9 result = client.calling.detect(
10     call_id="call-id-xxx",
11     detect={"type": "fax", "params": {"tone": "CED"}}
12 )

Digit Detection

1 from signalwire.rest import RestClient
2 
3 client = RestClient(
4     project="your-project-id",
5     token="your-api-token",
6     host="your-space.signalwire.com",
7 )
8 
9 result = client.calling.detect(
10     call_id="call-id-xxx",
11     detect={"type": "digit", "params": {"digits": "0123456789#*"}}
12 )