SignalWire.Relay.Calling.Call

1
AnswerResult resultAnswer = call.Answer();
2
if (resultAnswer.Successful) {
3
    // The call has been answered
4
}

1
ConnectResult resultConnect = call.Connect(new List<List<CallDevice>>
2
{
3
    new List<CallDevice>
4
    {
5
        new CallDevice
6
        {
7
            Type = CallDevice.DeviceType.phone,
8
            Parameters = new CallDevice.PhoneParams
9
            {
10
                ToNumber = "+18991114444",
11
                FromNumber = "+1YYYYYYYYYY",
12
                Timeout = 30,
13
            }
14
        }
15
    },
16
    new List<CallDevice>
17
    {
18
        new CallDevice
19
        {
20
            Type = CallDevice.DeviceType.phone,
21
            Parameters = new CallDevice.PhoneParams
22
            {
23
                ToNumber = "+18991114445",
24
                FromNumber = "+1YYYYYYYYYY",
25
                Timeout = 20,
26
            }
27
        }
28
    }
29
},
30
ringback: new List<CallMedia>
31
{
32
    new CallMedia
33
    {
34
        Type = CallMedia.MediaType.ringtone,
35
	Parameters = new CallMedia.RingtoneParams
36
        {
37
            Name = "us"
38
        }
39
    }
40
});
41
42
if (resultConnect.Successful) {
43
    // The call was connected, and is available at resultConnect.Call
44
}

1
ConnectResult resultConnect = call.Connect(new List<List<CallDevice>>
2
{
3
    new List<CallDevice>
4
    {
5
        new CallDevice
6
        {
7
            Type = CallDevice.DeviceType.phone,
8
            Parameters = new CallDevice.PhoneParams
9
            {
10
                ToNumber = "+18991114443",
11
                FromNumber = "+1YYYYYYYYYY",
12
                Timeout = 30,
13
            }
14
        }
15
    },
16
    new List<CallDevice>
17
    {
18
        new CallDevice
19
        {
20
            Type = CallDevice.DeviceType.phone,
21
            Parameters = new CallDevice.PhoneParams
22
            {
23
                ToNumber = "+18991114444",
24
                FromNumber = "+1YYYYYYYYYY",
25
                Timeout = 30,
26
            }
27
        },
28
        new CallDevice
29
        {
30
            Type = CallDevice.DeviceType.phone,
31
            Parameters = new CallDevice.PhoneParams
32
            {
33
                ToNumber = "+18991114445",
34
                FromNumber = "+1YYYYYYYYYY",
35
                Timeout = 20,
36
            }
37
        }
38
    },
39
    new List<CallDevice>
40
    {
41
        new CallDevice
42
        {
43
            Type = CallDevice.DeviceType.phone,
44
            Parameters = new CallDevice.PhoneParams
45
            {
46
                ToNumber = "+18991114446",
47
                FromNumber = "+1YYYYYYYYYY",
48
                Timeout = 30,
49
            }
50
        },
51
        new CallDevice
52
        {
53
            Type = CallDevice.DeviceType.phone,
54
            Parameters = new CallDevice.PhoneParams
55
            {
56
                ToNumber = "+18991114447",
57
                FromNumber = "+1YYYYYYYYYY",
58
                Timeout = 20,
59
            }
60
        }
61
    }
62
});
63
64
if (resultConnect.Successful) {
65
    // The call was connected, and is available at resultConnect.Call
66
}

1
ConnectAction actionConnect = call.ConnectAsync(new List<List<CallDevice>>
2
{
3
    new List<CallDevice>
4
    {
5
        new CallDevice
6
        {
7
            Type = CallDevice.DeviceType.phone,
8
            Parameters = new CallDevice.PhoneParams
9
            {
10
                ToNumber = "+18991114444",
11
                FromNumber = "+1YYYYYYYYYY",
12
                Timeout = 30,
13
            }
14
        }
15
    },
16
    new List<CallDevice>
17
    {
18
        new CallDevice
19
        {
20
            Type = CallDevice.DeviceType.phone,
21
            Parameters = new CallDevice.PhoneParams
22
            {
23
                ToNumber = "+18991114445",
24
                FromNumber = "+1YYYYYYYYYY",
25
                Timeout = 20,
26
            }
27
        }
28
    }
29
});
30
31
// Do other stuff while the call is being connected
32
33
if (actionConnect.Completed && actionConnect.Result.Successful) {
34
    // The call was connected, and is available at actionConnect.Result.Call
35
}

1
DetectResult resultDetect = call.Detect(
2
    new CallDetect
3
    {
4
        Type = CallDetect.DetectType.machine,
5
        Parameters = new CallDetect.MachineParams
6
        {
7
        }
8
    });
9
10
if (resultDetect.Successful)
11
{
12
    if (resultDetect.Type == DetectResultType.Human)
13
    {
14
        // ...
15
    }
16
}

1
DetectAction actionDetect = call.DetectAsync(
2
    new CallDetect
3
    {
4
        Type = CallDetect.DetectType.machine,
5
        Parameters = new CallDetect.MachineParams
6
        {
7
        }
8
    });
9
10
Thread.Sleep(5000);
11
12
actionDetect.Stop();

1
DetectResult resultDetect = call.DetectAnsweringMachine();

1
// within an asynchronous function ..
2
DetectAction actionDetect = call.DetectAnsweringMachineAsync();
3
4
Thread.Sleep(5000);
5
6
actionDetect.Stop();

1
DetectResult resultDetect = call.DetectDigit();

1
// within an asynchronous function ..
2
DetectAction actionDetect = call.DetectDigitAsync();
3
4
Thread.Sleep(5000);
5
6
actionDetect.Stop();

1
DetectResult resultDetect = call.DetectFax();

1
// within an asynchronous function ..
2
DetectAction actionDetect = call.DetectFaxAsync();
3
4
Thread.Sleep(5000);
5
6
actionDetect.Stop();

1
DetectResult resultDetect = call.DetectHuman();

1
// within an asynchronous function ..
2
DetectAction actionDetect = call.DetectHumanAsync();
3
4
Thread.Sleep(5000);
5
6
actionDetect.Stop();

1
DetectResult resultDetect = call.DetectMachine();

1
// within an asynchronous function ..
2
DetectAction actionDetect = call.DetectMachineAsync();
3
4
Thread.Sleep(5000);
5
6
actionDetect.Stop();

1
PhoneCall call = client.Calling.NewPhoneCall("+1XXXXXXXXXX", "+1YYYYYYYYYY");
2
DialResult resultDial = call.Dial();
3
if (resultDial.Successful) {
4
    // Call has been answered
5
}

1
FaxResult resultFax = call.FaxReceive();
2
3
if (resultFax.Successful)
4
{
5
    // ...
6
}

1
FaxAction actionFax = call.FaxSendAsync();
2
3
Thread.Sleep(5000);
4
5
actionFax.Stop();

1
FaxResult resultFax = call.FaxSend("https://cdn.signalwire.com/fax/dummy.pdf");
2
3
if (resultFax.Successful)
4
{
5
    // ...
6
}

1
FaxAction actionFax = call.FaxSendAsync("https://cdn.signalwire.com/fax/dummy.pdf");
2
3
Thread.Sleep(5000);
4
5
actionFax.Stop();

1
HangupResult resultHangup = call.Hangup();
2
if (resultHangup.Successful) {
3
    // Call has been disconnected with the default hangup reason
4
}

1
PlayResult resultPlay = call.Play(
2
    new List<CallMedia>
3
    {
4
        new CallMedia
5
        {
6
            Type = CallMedia.MediaType.tts,
7
            Parameters = new CallMedia.TTSParams
8
            {
9
                Text = "Listen to this awesome file!"
10
            }
11
        },
12
        new CallMedia
13
        {
14
            Type = CallMedia.MediaType.audio,
15
            Parameters = new CallMedia.AudioParams
16
            {
17
                URL = "https://cdn.signalwire.com/default-music/welcome.mp3"
18
            }
19
        },
20
        new CallMedia
21
        {
22
            Type = CallMedia.MediaType.silence,
23
            Parameters = new CallMedia.SilenceParams
24
            {
25
                Duration = 5
26
            }
27
        },
28
        new CallMedia
29
        {
30
            Type = CallMedia.MediaType.ringtone,
31
            Parameters = new CallMedia.RingtoneParams
32
            {
33
                Name = "us"
34
            }
35
        },
36
        new CallMedia
37
        {
38
            Type = CallMedia.MediaType.tts,
39
            Parameters = new CallMedia.TTSParams
40
            {
41
                Text = "Did you like it?"
42
            }
43
        }
44
    },
45
    volume: 4.0
46
);

1
PlayAction actionPlay = call.PlayAsync(
2
    new List<CallMedia>
3
    {
4
        new CallMedia
5
        {
6
            Type = CallMedia.MediaType.tts,
7
            Parameters = new CallMedia.TTSParams
8
            {
9
                Text = "Listen to this awesome file!"
10
            }
11
        },
12
        new CallMedia
13
        {
14
            Type = CallMedia.MediaType.audio,
15
            Parameters = new CallMedia.AudioParams
16
            {
17
                URL = "https://cdn.signalwire.com/default-music/welcome.mp3"
18
            }
19
        },
20
        new CallMedia
21
        {
22
            Type = CallMedia.MediaType.silence,
23
            Parameters = new CallMedia.SilenceParams
24
            {
25
                Duration = 5
26
            }
27
        },
28
        new CallMedia
29
        {
30
            Type = CallMedia.MediaType.ringtone,
31
            Parameters = new CallMedia.RingtoneParams
32
            {
33
                Name = "us"
34
            }
35
        },
36
        new CallMedia
37
        {
38
            Type = CallMedia.MediaType.tts,
39
            Parameters = new CallMedia.TTSParams
40
            {
41
                Text = "Did you like it?"
42
            }
43
        }
44
    },
45
    volume: 4.0
46
);
47
48
Thread.Sleep(5000);
49
50
actionPlay.Stop();

1
PlayResult resultPlay = call.PlayAudio("https://cdn.signalwire.com/default-music/welcome.mp3", volume: 4.0);

1
// within an asynchronous function ..
2
PlayAction actionPlay = call.PlayAudioAsync("https://cdn.signalwire.com/default-music/welcome.mp3", volume: 4.0);
3
4
Thread.Sleep(5000);
5
6
actionPlay.Stop();

1
PlayResult resultPlay = call.PlayRingtone("us");

1
PlayAction actionPlay = call.PlayRingtoneAsync("us", duration: 60);
2
3
if (agent.Available()) {
4
    actionPlay.Stop();
5
}

1
PlayResult resultPlay = call.PlaySilence(10);

1
PlayAction actionPlay = call.PlaySilenceAsync(60);
2
3
if (agent.Available()) {
4
    actionPlay.Stop();
5
}

1
PlayResult resultPlay = call.PlayTTS("Welcome to SignalWire!", gender: "male", volume: 4.0 });

1
PlayAction actionPlay = call.PlayTTSAsync("Welcome to SignalWire! Making communications easy for everyone!", gender: "male", volume: 4.0 })
2
3
Thread.Sleep(3000);
4
5
actionPlay.Stop();

1
PromptResult resultPrompt = call.Prompt(
2
    new List<CallMedia>
3
    {
4
        new CallMedia
5
        {
6
            Type = CallMedia.MediaType.tts,
7
            Parameters = new CallMedia.TTSParams
8
            {
9
                Text = "Welcome to SignalWire! Please enter your PIN",
10
            }
11
        }
12
    },
13
    new CallCollect
14
    {
15
        InitialTimeout = 10,
16
        Digits = new CallCollect.DigitsParams
17
        {
18
            Max = 4,
19
            DigitTimeout = 5,
20
        }
21
    },
22
    volume: 4.0);
23
24
if (resultPrompt.Successful)
25
{
26
    // The collected input is in resultPrompt.Result
27
}

1
PromptAction actionPrompt = call.PromptAsync(
2
    new List<CallMedia>
3
    {
4
        new CallMedia
5
        {
6
            Type = CallMedia.MediaType.tts,
7
            Parameters = new CallMedia.TTSParams
8
            {
9
                Text = "Welcome to SignalWire! Please enter your PIN",
10
            }
11
        },
12
        new CallMedia
13
        {
14
            Type = CallMedia.MediaType.audio,
15
            Parameters = new CallMedia.AudioParams
16
            {
17
                URL = "https://cdn.signalwire.com/default-music/welcome.mp3",
18
            }
19
        }
20
    },
21
    new CallCollect
22
    {
23
        InitialTimeout = 10,
24
        Digits = new CallCollect.DigitsParams
25
        {
26
            Max = 4,
27
            DigitTimeout = 5,
28
        }
29
    },
30
    volume: 4.0);
31
32
// Do other stuff
33
34
if (actionPrompt.Completed)
35
{
36
    if (actionPrompt.Result.Successful)
37
    {
38
        // The collected input is in actionPrompt.Result.Result
39
    }
40
}

1
PromptResult resultPrompt = call.PromptAudio(
2
    "https://cdn.signalwire.com/default-music/welcome.mp3",
3
    new CallCollect
4
    {
5
        InitialTimeout = 10,
6
        Digits = new CallCollect.DigitsParams
7
        {
8
            Max = 4,
9
            DigitTimeout = 5,
10
        }
11
    },
12
    volume: 4.0);
13
14
if (resultPrompt.Successful)
15
{
16
    // The collected input is in resultPrompt.Result
17
}

1
PromptAction actionPrompt = call.PromptAudioAsync(
2
    "https://cdn.signalwire.com/default-music/welcome.mp3",
3
    new CallCollect
4
    {
5
        InitialTimeout = 10,
6
        Digits = new CallCollect.DigitsParams
7
        {
8
            Max = 4,
9
            DigitTimeout = 5,
10
        }
11
    },
12
    volume: 4.0);
13
14
if (actionPrompt.Completed)
15
{
16
    if (actionPrompt.Result.Successful)
17
    {
18
        // The collected input is in actionPrompt.Result.Result
19
    }
20
}

1
PromptResult resultPrompt = call.PromptRingtone(
2
    "us",
3
    new CallCollect
4
    {
5
        InitialTimeout = 10,
6
        Digits = new CallCollect.DigitsParams
7
        {
8
            Max = 4,
9
            DigitTimeout = 5,
10
        }
11
    },
12
    volume: 4.0);
13
14
if (resultPrompt.Successful)
15
{
16
    // The collected input is in resultPrompt.Result
17
}

1
PromptAction actionPrompt = call.PromptRingtoneAsync(
2
    "us",
3
    new CallCollect
4
    {
5
        InitialTimeout = 10,
6
        Digits = new CallCollect.DigitsParams
7
        {
8
            Max = 4,
9
            DigitTimeout = 5,
10
        }
11
    },
12
    volume: 4.0);
13
14
if (actionPrompt.Completed)
15
{
16
    if (actionPrompt.Result.Successful)
17
    {
18
        // The collected input is in actionPrompt.Result.Result
19
    }
20
}

1
PromptResult resultPrompt = call.PromptTTS(
2
    "Welcome to SignalWire! Please enter your PIN",
3
    new CallCollect
4
    {
5
        InitialTimeout = 10,
6
        Digits = new CallCollect.DigitsParams
7
        {
8
            Max = 4,
9
            DigitTimeout = 5,
10
        }
11
    },
12
    gender: "male",
13
    volume: 4.0);
14
15
if (resultPrompt.Successful)
16
{
17
    // The collected input is in resultPrompt.Result
18
}

1
PromptAction actionPrompt = call.PromptTTSAsync(
2
    "Welcome to SignalWire! Please enter your PIN",
3
    new CallCollect
4
    {
5
        InitialTimeout = 10,
6
        Digits = new CallCollect.DigitsParams
7
        {
8
            Max = 4,
9
            DigitTimeout = 5,
10
        }
11
    },
12
    gender: "male",
13
    volume: 4.0);
14
15
if (actionPrompt.Completed)
16
{
17
    if (actionPrompt.Result.Successful)
18
    {
19
        // The collected input is in actionPrompt.Result.Result
20
    }
21
}

1
RecordResult resultRecord = call.Record(
2
    new CallRecord
3
    {
4
        Audio = new CallRecord.AudioParams
5
        {
6
            Stereo = true,
7
            Direction = CallRecord.AudioParams.AudioDirection.both,
8
        }
9
    });
10
11
if (resultRecord.Successful)
12
{
13
    // The URL for the recording is available in resultRecord.Url
14
}

1
RecordAction actionRecord = call.RecordAsync(
2
    new CallRecord
3
    {
4
        Audio = new CallRecord.AudioParams
5
        {
6
            Stereo = true,
7
            Direction = CallRecord.AudioParams.AudioDirection.both,
8
        }
9
    });
10
11
Thread.Sleep(5000);
12
13
actionRecord.Stop();

1
SendDigitsResult result = call.SendDigits("123w456W789");
2
3
if (result.Successful)
4
{
5
    // ...
6
}

1
SendDigitsAction action = call.SendDigits("123w456W789");
2
3
// Do other things

1
TapResult resultTap = call.Tap(
2
    new CallTap
3
    {
4
        Audio = new CallTap.AudioParams
5
        {
6
            Direction = CallTap.AudioParams.AudioDirection.both,
7
        }
8
    },
9
    new CallTapDevice
10
    {
11
        Type = CallTapDevice.DeviceType.rtp,
12
        Parameters = new CallTapDevice.RTPParams
13
        {
14
            Address = "1.2.3.4",
15
            Port = 12345,
16
        }
17
    });
18
19
if (resultTap.Successful)
20
{
21
    // The RTP data is flowing to the device
22
}

1
TapAction actionTap = call.TapAsync(
2
    new CallTap
3
    {
4
        Audio = new CallTap.AudioParams
5
        {
6
            Direction = CallTap.AudioParams.AudioDirection.both,
7
        }
8
    },
9
    new CallTapDevice
10
    {
11
        Type = CallTapDevice.DeviceType.rtp,
12
        Parameters = new CallTapDevice.RTPParams
13
        {
14
            Address = "1.2.3.4",
15
            Port = 12345,
16
        }
17
    });
18
19
Thread.Sleep(5000);
20
21
actionTap.Stop();

1
bool stateValid = call.WaitFor(null, CallState.answered);
2
if (stateValid) {
3
    // The call is answered
4
}

1
bool stateValid = call.WaitForAnswered();
2
if (stateValid) {
3
    // The call is answered
4
}

1
bool stateValid = call.WaitForEnded();
2
if (stateValid) {
3
    // The call is ended
4
}

1
bool stateValid = call.WaitForEnding();
2
if (stateValid) {
3
    // The call is ending
4
}

1
bool stateValid = call.WaitForRinging();
2
if (stateValid) {
3
    // The call is ringing
4
}