### 使用 Python 实现 FreeSWITCH 外呼接口 #### 通过 ESL 接口实现外呼 利用 Event Socket Library (ESL)，可以通过 Python 脚本连接至 FreeSWITCH 并执行命令来发起呼叫。这种方式允许开发者编写灵活的应用逻辑，同时保持与 FreeSWITCH 的高效交互[^1]。 ```python from switchy import Client def make_call(from_number, to_number): client = Client() # Connect to the FreeSWITCH server using ESL with client.connect('127.0.0.1', 8021, 'ClueCon') as conn: uuid = conn.api(f'originate user/{to_number} &bridge(user/{from_number})').body.strip() return uuid ``` 此代码片段展示了如何建立到 FreeSWITCH 的连接并通过 `originate` 命令启动一个新的会话。这里假设已经正确设置了 FreeSWITCH 和相应的用户账号[^3]。 #### 配置 dialplan 支持 Python 脚本 为了使 FreeSWITCH 可以调用 Python 编写的处理程序，在拨号计划(dialplan)里定义特定的扩展名，并指定要运行的 Python 函数名称[^4]： ```xml <extension name="outbound_call"> <condition field="destination_number" expression="^\d+$"> <action application="set" data="effective_caller_id_name=Outbound Call"/> <action application="set" data="effective_caller_id_number=${caller_id_number}"/> <action application="python" data="make_outbound_call ${destination_number}"/> </condition> </extension> ``` 上述 XML 片段中的 `<action>` 元素指定了当匹配目标号码时应触发名为 `make_outbound_call` 的 Python 方法。 #### 创建完整的 Python 控制器用于自动化外呼流程 对于更复杂的场景，比如批量读取联系人列表并逐一尝试拨打，则可能涉及到更多业务逻辑的设计以及状态管理等功能。下面是一个简单的例子展示怎样构建这样一个控制器[^5]: ```python import time from microsip_auto_dialer import MicroSIPDialer # 自动化工具类 class OutboundCaller: def __init__(self, number_list_file_path): self.dialer = MicroSIPDialer() # 初始化 SIP 客户端实例 self.numbers_to_call = [] try: with open(number_list_file_path, 'r') as file: lines = file.readlines() for line in lines: stripped_line = line.strip() if stripped_line and not stripped_line.startswith('#'): self.numbers_to_call.append(stripped_line) except FileNotFoundError: print("File not found.") def start(self): while len(self.numbers_to_call)>0: next_num = self.numbers_to_call.pop(0) result = self.dialer.call(next_num) if result['status'] == 'success': print(f'Successfully dialed {next_num}.') time.sleep(result.get('duration', 60)) # 等待通话结束后再继续下一个 elif result['error']: print(f'Failed to call {next_num}: ',result['message']) continue if __name__ == '__main__': caller = OutboundCaller('./numbers.txt') caller.start() ``` 这段代码实现了从文本文件加载电话号码列表的功能，并逐个进行呼叫直到全部完成为止。它还包含了基本错误处理机制以应对可能出现的问题情况。