SIP对接指引

更新时间:
复制为 MD 格式

SIP对接指引文档。

前提条件

  1. 已经开通云联络中心。

  2. 与产品商务在对接费用上达成一致。

客户方的SIP设备的要求

  • 客户方设备需要完整支持SIP协议,支持松散路由。

  • 客户方需要确保在SIP协议中透传真实的主被叫号码。

  • 客户方的设备需要具备固定的公网IP地址。

  • 客户方需要具备合格的SIP运维工程师来从事对接以及后续的运维工作。

  • 客户方需要自己保证本方设备的高可用。

  • 客户方开启OPTIONS探测机制,当云联络中心机器不响应OPTIONS时可以将这台机器从呼入负载中移除,保障新呼入话务正常。

操作步骤

步骤一:提供客户侧SIP服务信息

联系云联络中心-售后支持(13148375146)钉钉服务号,提供客户侧SIP服务信息给阿里云

服务信息

样例

SIP服务(主)

110.110.xx.xx

5060

SIP服务(备)

10.27.xx.xx

5060

SP标示

Weiniya

英文字母

号码

95566

客户的阿里云UID

步骤二:配置SIP服务信息

在自己的SIP网关配置云联络中心SIP服务信息

image001.png

云联络中心侧的SIP服务信息如下:

  1. 客户网关对接的云联络中心侧的SIP服务地址如下,协议UDP:

    • IP:联系云联络中心-售后支持(13148375146)钉钉服务号索要SIP服务器IP信息。

    • 端口:

      • 公网入端口:8000。

      • 公网出端口:8000。

  2. 客户需要保证通过公网访问上述协议、地址和端口。

  3. 注意:网关信令需要原路转发回sbc,即发回SIP信令来源地址(1中的其中一个地址)。

  4. BYEreq_uri值为invite信令中的contact(对应是fs的地址,5080端口)BYE消息中req_uri的值需要设置为INVITE消息中的Contact地址和端口。

    • Figure 1 Invite消息

      INVITE消息中Contact字段的地址和端口将作为后续BYE消息Request-URI的值。

      Request-Line: INVITE sip:15613626661@60.10.29.117:5060 SIP/2.0
      Message Header
        Record-Route: <sip:172.19.155.24:5160;r2=on;lr;did=cff.c432>
        Record-Route: <sip:106.14.3.154:8000;r2=on;lr;did=cff.c432>
        Record-Route: <sip:106.15.101.40:8000;r2=on;lr;did=cff.36b1>
        Record-Route: <sip:11.218.96.97:5160;r2=on;lr;did=cff.36b1>
        Via: SIP/2.0/UDP 172.19.155.24:5160;branch=z9hG4bKe0db.294361bb992e0fafdb45d477a8331e06.0
        Via: SIP/2.0/UDP 106.15.101.40:8000;branch=z9hG4bKe0db.582b6891355577d1a895da5160ef41cd.0
        Via: SIP/2.0/UDP 11.193.108.93:5080;received=11.193.108.93;rport=5080;branch=z9hG4bKZSQU5K59HSm9F
        Max-Forwards: 67
        From: "4006408888" <sip:4006408888@11.193.108.93>;tag=aHXXr6j8p0pym
        To: <sip:15613626661@11.218.96.97:5160>
        Call-ID: c2613d5d-7177-1237-d090-00163e003196
        CSeq: 131576684 INVITE
        Contact: <sip:4006408888@11.193.108.93:5080;transport=udp;gw=sbc_proxy2>
        User-Agent: ACC_FS_SERVER
        Allow: INVITE, ACK, BYE, CANCEL, OPTIONS, MESSAGE, INFO, UPDATE, REGISTER, REFER, NOTIFY

      其中Contact字段值 sip:4006408888@11.193.108.93:5080 即为BYE消息中req_uri所使用的地址和端口。

    • Figure 2 客户侧返回的BYE消息BYE 消息的 Request-URI 地址 sip:4006408888@106.14.3.154:5160 填写有误,应使用 INVITE 消息 Contact 中的地址和端口,即 sip:4006408888@11.193.108.93:5080。BYE 消息抓包内容:

      Session Initiation Protocol (BYE)
        Request-Line: BYE sip:4006408888@106.14.3.154:5160;transport=udp;gw=sbc_proxy2 SIP/2.0
        Message Header
          Via: SIP/2.0/UDP 60.10.29.117:5060;branch=z9hG4bK3518834241
          Route: <sip:172.19.155.24:5160;r2=on;lr;did=cff.c432>
          Route: <sip:106.14.3.154:8000;r2=on;lr;did=cff.c432>
          Route: <sip:106.15.101.40:8000;r2=on;lr;did=cff.36b1>
          Route: <sip:11.218.96.97:5160;r2=on;lr;did=cff.36b1>
          From: <sip:15613626661@11.218.96.97:5160>;tag=2362619223
          To: "4006408888" <sip:4006408888@11.193.108.93>;tag=aHXXr6j8p0pym
          Call-ID: c2613d5d-7177-1237-d090-00163e003196
          CSeq: 131576685 BYE
          Contact: <sip:15613626661@60.10.29.117:5060>
          Max-Forwards: 70
  5. 200 OKackreq_uri值为200OK中的contact(对应是fs地址,5080端口)200 OK消息的响应(ACK)消息中req_uri设置为200 OK消息中的Contact地址。

    • Figure 3 200 OK消息

      200 OK 响应中,需记住 Contact 地址 sip:2431002@11.193.49.137:5080;transport=udp,该地址用于后续 SIP 服务配置。完整抓包解析内容:

      User Datagram Protocol, Src Port: 8000, Dst Port: 5060
      Session Initiation Protocol (200)
        Status-Line: SIP/2.0 200 OK
        Message Header
          Via: SIP/2.0/UDP 60.10.29.117:5060;branch=z9hG4bK784754574
          Record-Route: <sip:11.218.96.68:5160;r2=on;lr;did=d.b913>
          Record-Route: <sip:106.15.101.44:8000;r2=on;lr;did=d.b913>
          Record-Route: <sip:106.14.3.154:8000;lr;did=d.d7b2>
          From: <sip:13031429623@60.10.29.117>;tag=3550207602
          To: <sip:2431002@106.14.3.154:8000>;tag=873eS48HN2t5j
          Call-ID: 4256233336@60.10.29.117
          CSeq: 20 INVITE
          Contact: <sip:2431002@11.193.49.137:5080;transport=udp>
          User-Agent: ACC_FS_SERVER
          Allow: INVITE, ACK, BYE, CANCEL, OPTIONS, MESSAGE, INFO, UPDATE, REGISTER, REFER, NOTIFY
    • Figure 4 200 OK的响应消息(ACK)ACK请求的Request-URI应填写为200 OK消息中的Contact地址(即2431002@106.14.3.154:8000)。以下为ACK消息示例:

      User Datagram Protocol, Src Port: 5060, Dst Port: 8000
      Session Initiation Protocol (ACK)
        Request-Line: ACK sip:2431002@106.14.3.154:8000;transport=udp SIP/2.0
        Message Header
          Via: SIP/2.0/UDP 60.10.29.117:5060;branch=z9hG4bK1834151321
          Route: <sip:106.14.3.154:8000;lr;did=d.d7b2>
          Route: <sip:106.15.101.44:8000;r2=on;lr;did=d.b913>
          Route: <sip:11.218.96.68:5160;r2=on;lr;did=d.b913>
          From: <sip:13031429623@60.10.29.117>;tag=3550207602
          To: <sip:2431002@106.14.3.154:8000>;tag=873eS48HN2t5j
  6. 客户侧SIP网关支持松散路由。

步骤三:完成实例配置

完成云联络中心实例的配置,用于业务测试

  1. 创建一个云联络中心实例。

  2. 在号码管理中为该实例选择号码,并绑定到SIP对接测试IVR。

  3. 配置技能组和坐席,能够接收SIP对接测试IVR中的转人工请求。

步骤四:申请对接测试

  1. 联系云联络中心-售后支持钉钉服务号,预约测试时间。

  2. 双方完成配置,并在客户SIP网关和云联络中心侧开启网络抓包软件。

  3. 执行如下测试用例,进行测试:

    1

    坐席使用账户登录云联络中心坐席工作台

    2

    呼入

    移动号码

    联通号码

    电信号码

    能否发起呼叫

    IVR中能否正常收单位按键

    IVR中能否正常收多位按键

    能否被坐席接听

    能否持续10分钟不被异常挂断

    3

    呼出

    云联络中心侧能发起呼叫

    能否被客户电话正常接听

    通话能否持续10分钟不被异常挂断