很多时候我们打电话到公司前台,会听到类似“欢迎致电XXX,办公电话请直拨分机,咨询XX请按1,咨询YY请按2”这样的语音提示。在一些特定流程中,系统自动发起呼叫打到前台,希望实现自动按键(即:不用人手动按键),FreeSwitch提供了2个基本命令: send_dtmf及uuid_send_dtmf ,这2个基本功能一样,send_dtmf常用于ESL Outbound外联模式,不需要指定uuid,而uuid_send_dtmf则需要指定uuid.
以uuid_send_dtmf为例,演示下基本用法:(FreeSwitch控制台模式下)
1、先发起一个呼叫
1 freeswitch@xxx> create_uuid 2 4841d610-fba3-46b3-9432-4a4ebc164b36 3 4 freeswitch@xxx> originate {origination_uuid=4841d610-fba3-46b3-9432-4a4ebc164b36}user/1000 &park()
先生成一个uuid(方便后面uuid_send_dtmf时指定),然后用这个uuid,向内置用户1000发起呼叫,接通后park住,这样就有一个进行的通话了
2、模拟按键
uuid_send_dtmf 4841d610-fba3-46b3-9432-4a4ebc164b36 12
上图是freeswitch控制台的输出,有几个细节注意一下:
a) 按键是1个1个送出去的,即先送完1,再送2
b) 单个key发送完,会默认delay 40ms.
看上去很简单,对吧?继续折腾,uuid_send_dtmf 命令在按键后,还可以附加一个可选参数 tone_duration,
可以试下效果:
uuid_send_dtmf 4841d610-fba3-46b3-9432-4a4ebc164b36 12 300
猜猜是啥效果?
相当于发送了12300,是不是有点意外?
再试一下:
uuid_send_dtmf 4841d610-fba3-46b3-9432-4a4ebc164b36 12 @5000
这时候输出的内容太多,就不截完整的图了,输出片段如下:
---------------------------------------------------------------------------
freeswitch@xxx> uuid_send_dtmf 4841d610-fba3-46b3-9432-4a4ebc164b36 12 @5000
-ERR no reply
2021-08-29 16:27:05.188770 [DEBUG] switch_core_io.c:1894 sofia/internal/1000@10.32.26.25:64045 send dtmf
digit=1 ms=5000 samples=40000
2021-08-29 16:27:05.188770 [DEBUG] switch_core_io.c:1894 sofia/internal/1000@10.32.26.25:64045 send dtmf
digit=2 ms=5000 samples=40000
freeswitch@xxx> 2021-08-29 16:27:05.199769 [DEBUG] switch_rtp.c:5228 Send start packet for [1] ts=247200 dur=160/160/40000 seq=21903 lw=247200
2021-08-29 16:27:05.218781 [DEBUG] switch_rtp.c:5127 Send middle packet for [1] ts=247200 dur=320/320/40000 seq=21904 lw=247360
2021-08-29 16:27:05.238804 [DEBUG] switch_rtp.c:5127 Send middle packet for [1] ts=247200 dur=480/480/40000 seq=21905 lw=247520
2021-08-29 16:27:05.258771 [DEBUG] switch_rtp.c:5127 Send middle packet for [1] ts=247200 dur=640/640/40000 seq=21906 lw=247680
...
2021-08-29 16:27:10.178511 [DEBUG] switch_rtp.c:5127 Send end packet for [1] ts=247200 dur=40000/40000/40000 seq=22154 lw=286880
2021-08-29 16:27:10.178511 [DEBUG] switch_rtp.c:5075 Queue digit delay of 40ms
2021-08-29 16:27:10.579417 [DEBUG] switch_rtp.c:5228 Send start packet for [2] ts=287360 dur=160/160/40000 seq=22155 lw=287360
2021-08-29 16:27:10.598623 [DEBUG] switch_rtp.c:5127 Send middle packet for [2] ts=287360 dur=320/320/40000 seq=22156 lw=287520
2021-08-29 16:27:10.619422 [DEBUG] switch_rtp.c:5127 Send middle packet for [2] ts=287360 dur=480/480/40000 seq=22157 lw=287680
2021-08-29 16:27:10.639406 [DEBUG] switch_rtp.c:5127 Send middle packet for [2] ts=287360 dur=640/640/40000 seq=22158 lw=287840
...
---------------------------------------------------------------------------
指定了@5000后,每个按键的持续时间就变成了5秒了。
最后1个细节,实际使用中可能会遇到对方收的按键丢失,通常是发送太快,特别是号码中间有连续数字时,比如: 700001,发过去后,对方可能收到的是70001(少1个0)
uuid_send_dtmf Send DTMF digits to <uuid> Usage: uuid_send_dtmf <uuid> <dtmf digits>[@<tone_duration>] Use the character w for a .5 second delay and the character W for a 1 second delay. Default tone duration is 2000ms .
再反复阅读这段惜墨如金的官网文档(也没个示例,确实有点高深晦涩),其实这里给出了1个方法,在每个键后加小写w,可以在每次按键后,多delay 0.5s,如果是W,则多delay 1s,把刚才发送的按键12,改成1w2W试下
从图上看,1发送完后,多延时了500ms,而2发送完后,多延时了1000ms
参考:https://freeswitch.org/confluence/display/FREESWITCH/mod_commands