规整的openAPI开放接口文档

规整的openAPI开放接口文档

miniSIPServer 提供开放的openAPI接口,客户可以在自己的系统中,通过这些接口操作、管理miniSIPServer。

以前的openAPI文档托管在GitBook网站上,目前我们已经重新移植回我们的官方网站,请访问以下链接获得最新的接口文档。

https://www.myvoipapp.com/cn/docs/mss_services/openapi/index.html

在新的文档中,我们开放了更多的接口,几乎覆盖了基本呼叫所需要的所有配置项,例如SIP中继、外线、路由等。

希望接口文档对您的解决方案有帮助。如果您希望我们开放更多的接口,请联系我们。我们欢迎任何建议!谢谢!

转接到下一个中继

转接到下一个中继

在使用SIP中继外呼时,有可能遇到对方无法呼出的情况,例如对方资源全忙等,此时如果用户配置有多条SIP中继、同时又是对接多个不同的服务商,MSS可以继续尝试另一个SIP中继进行外呼。

在MSS的SIP中继中配置“呼叫失败时尝试另一中继”,并指定后续处理的中继即可。如下图所示:

配置SIP中继的后续转接中继
SIP中继呼出失败时,转而尝试另一中继。
根据IP地址跟踪SIP呼叫

根据IP地址跟踪SIP呼叫

以前的miniSIPServer版本中有个维护工具“跟踪所有呼叫”,它可以被用来跟踪miniSIPServer收到或者发出的所有SIP呼叫。在我们开始部署VoIP网络初期阶段时,这个工具是非常有效的,然而在实际生产环境中几乎没有作用。

在实际生产环境中跟踪【所有】呼叫,实际是个非常危险的操作,因为这会跟踪到太多SIP外部消息以及对应的miniSIPServer内部的信息,严重情况下会影响到miniSIPServer本身的运行。所以通常我们会根据主叫号码或者被叫号码来过滤呼叫。在最新的V33版本中,我们去掉了这个“跟踪所有呼叫”的功能,取而代之的是“根据IP地址跟踪”功能,如下图所示。

根据IP地址跟踪
根据IP地址跟踪

使用这个工具时,我们可以指定某个特定而明确的IP地址,例如“10.0.0.101”,这样就只会跟踪该特定地址的SIP呼叫。我们也可以指定部分IP地址,从而跟踪某些IP地址的呼叫,例如我们可以设置为“10.0.0”,所有来自该前缀起始的IP地址的SIP呼叫(例如“10.0.0.101”,“10.0.0.102等等”)都会被跟踪。当然,我们也可以设置IPv6的地址。

现在这个工具不仅在实验室环境很有效,在实际生产环境中也非常有用。

发布长期支持版本V32!

发布长期支持版本V32!

我们终于正式发布V32(长期支持,LTS)版本了!自从发布首个V32测试版本以来,期间经历了数月的时间。在此之间,我们先后更新、优化了各类界面(包括web界面和GUi界面),优化了SIP内核、优化了呼叫基础模块等诸多方面。这是个非常令人兴奋的版本,重要的是,我们将提供长达5年的技术支持!

另一方面,最新的稳定版本V33也同时发布。最重要的一个改变是,从这个版本开始,miniSIPServer 不再支持 X86-32 架构的Debian、Ubuntu系统。新的业务、需求、特性开发将基于V33版本。

希望您能喜欢最新的这些版本!

 

外线配置

外线配置

部署VoIP网络时,我们常常会在miniSIPServer中配置外线连接VoIP运营商的服务器。考虑到市场中有大量的VoIP运营服务商,因此经常有客户咨询我们如果配置miniSIPServer来连接这些运营商的网络。

实际上在“小型企业建立IP-PBX系统指南”这篇指导文档中,我们已经提供了一个简单的外线配置,连接VoIP运营商“call centric”。您可以参考这篇文章了解VoIP网络和外线的相关细节。另一方面,我们在“常见问题”文档的“外线”章节,也给出了一些其他运营商的配置参考。如果您有兴趣或者需求的话,也可以参考这些文档,希望这些文档帮助您部署VoIP网络。

https://www.myvoipapp.com/cn/docs/faq/index.html

在Ubuntu 18.04上运行miniSIPServer

在Ubuntu 18.04上运行miniSIPServer

安装完Ubuntu后,从我们网站上下载miniSIPServer V32版本,直接点击安装,非常简单!稍微测试了一下,完美!

由于18.04版本是最新的长期支持版本,因此我们也强烈推荐客户使用这个版本来部署miniSIPServer。

miniSIPServer运行在 Ubuntu 18.04
miniSIPServer运行在 Ubuntu 18.04

关于云miniSIPServer注册邮箱的问题

关于云miniSIPServer注册邮箱的问题

我们要求必须使用 email 邮箱地址来注册、激活云 miniSIPServer 帐号(minisipserver.com),因为我们需要通过email及时反馈系统状况给您,有时候我们也需要发送一些必要的通知给您,比如账户余额的情况,确保您的系统能保持正常、稳定地运行,避免意外情况对您的 VoIP 系统造成不必要的冲击。

出于保护客户隐私的考虑,我们的服务器全部部署在有最严格法律规范约束的美国、德国两地。我们也承诺绝对不会泄漏您的email邮箱地址,也绝对不会用于营销等目的,仅仅是作为系统维护时的联系手段而已。

目前我们已经与全世界绝大多数邮件服务商都工作良好,唯一让我们感到困惑的是大陆地区的QQ邮箱。我们已经多次收到用户的抱怨,注册云miniSIPServer账户后,无法收到激活邮件。我们检查了自身系统的相关情况,发现QQ邮箱退回了我们的邮件,原因是我们的IP地址发送了过多的邮件。

根据我们的日志,大陆地区用户用QQ邮箱注册的情况并不多,频率大约是一周二三个而已,我们的邮件系统不可能频繁发送激活邮件。我们完全有理由相信,QQ 邮箱简单粗暴地过滤了海外邮箱地址。我们尝试联系 QQ 邮箱的支持部门进行沟通,但是很遗憾,没有获得反馈,状况也没有改善。

因此,如果您是大陆地区用户,建议您不用QQ邮箱注册云miniSIPServer帐号。我们推荐采用163或者outlook邮箱,这些都没有任何问题。当然,如果您有海外邮箱帐号,比如gmail、yahoo等,那就更没有问题。

miniSIPServer 更新(树莓派版本)

miniSIPServer 更新(树莓派版本)

今日我们重新构建了 miniSIPServer 在树莓派上的版本,基于最新的 Raspbian 系统重新进行了版本编译和发布。

也就是说,目前最新的 miniSIPServer 正式支持 Raspberry (Stretch)系统。如果您的树莓派系统还是Jessie版本或者更旧的版本,建议在升级 MSS 之前先升级树莓派到Stretch系统。

如果您目前使用Pi1或者Pi2,或者不愿意升级到最新的系统版本,您可以试试MSS旧的版本。例如:

V31 https://www.myvoipapp.com/download/backup/mss_v31/pi/mss_v31_pi_u20.deb

V30 https://www.myvoipapp.com/download/backup/mss_v30/pi/mss_v30_pi_u20.deb

SIP中继转发媒体流

SIP中继转发媒体流

在某些VoIP网络部署中,我们需要采用“SIP中继”与其他VoIP服务器或者网关进行互联。在媒体处理方面,我们希望(1)本地分机之间的媒体流不经过MSS服务器,而(2)与其他VoIP服务器对接的呼叫中希望能通过MSS转发媒体流。

为解决这个需求,我们更新了V32版本,在“SIP中继”的“出呼叫”配置中,可以单独设置是否需要MSS来转发媒体。请参考下图:

SIP 中继转发媒体流配置
SIP 中继转发媒体流配置

请注意,目前仅支持转发语音流,不会转发视频流。