Views: 2270 (Data available since 06.02.2017)

The SIP Connector module will permit connecting an office PBX to Bitrix24. You have free minutes available for testing the functionality. If you plan to use your PBX for outbound calls, you have to pay for the license by clicking the button Pay for outbound call module connection. The amount of free minutes and the active license term are displayed on the page Balance and Statistics in the Telephony section.

The behavior of SIP Connector is as follows:

  • When making an outbound call from the portal, Bitrix24 will try to connect to the server you specified in the section Outbound calls of the Settings form and, after authorization with the login/password, make the call.
  • In order to receive an inbound call at the portal, a trunk must be created at own SIP PBX with the parameters provided to you in the section Inbound calls of the Settings form; all calls coming to PBX must be sent to this trunk.

In order to make sure the calls are processed properly, in addition to the Bitrix24 settings, setting up the office PBX and firewall of your local network will be necessary.

  • Office PBX settings
  • Local network’s firewall settings
  • The setup procedure for cloud and office PBX is different. A specific button is used to set each one:

    Settings in Bitrix24

    Click the button Connect office PBX and fill in the form fields for connection:

    where:

    • Connection name – is a number that you use for calls from your PBX.
    • Server Address – is the IP address of your PBX.
    • Login and Password – PBX access data.

    Click Connect. The data will be saved, and the system will go to the routing settings.

    Setting Up an Office PBX

    Let us consider setting up an office PBX using Asterisk as an example. For PBX setting the data from the block Incoming calls:

    • Creating trunk. The following entry must be made in the file sip.conf:

      [voximplant]
      dtmfmode=rfc2833
      ;; then instead of youraccount, type the name of your account in the Server field (see the figure above).
      fromdomain= youraccount
      type=friend
      host= youraccount
      ; the value of the Login
      fromuser=asterisk
      username=asterisk
      ; as a password value the value from the field Password is used
      secret=mypass
      insecure=port,invite
      conext=contex-internal
      disallow=all
      nat=yes
      allow=ulaw&alaw
      

      In this entry, the values must be changed only for domain, password, and the nat parameter, which must be set to yes/no, depending on whether you have an NAT network or not.

      As an example, below is a sample setting where the data from the figure above are used:

      [voximplant]
      
      dtmfmode=rfc2833
      fromdomain=ip.b24-2729-1386056980.voximplant.com
      type=friend
      host=ip.b24-2729-1386056980.voximplant.com
      fromuser=sip1
      username=sip1
      secret=e349429f63f7e4d7025fcd32d477ea05
      insecure=port,invite
      conext=contex-internal
      disallow=all
      nat=yes
      allow=ulaw&alaw
      Attention! Prior to module version 15.1.3 the settings of your Office PBX used incoming instead of ip value in the Server field (e.g.: incoming.b24-6864-1386141129.bitrixphone.com). You can continue using this value, but the module will work much slower.

      The settings are applied using the command in the Asterisk console:

      sip reload
    • Setting up calls from Asterisk to VoxImplant. Calls are placed using the following command, which must be included in the file extensions.conf:

      Dial(SIP/voximplant/${EXTEN})

      In this case, it will be sent to Bitrix24 as a call to the number to which it has been originally placed in Asterisk.

      The settings are applied using the command in the Asterisk console:

      dialplan reload

    Firewall Settings

    By default, port 5060 is used for SIP, and ports 10000-20000 are used for media (RTP). However, there is no general recommendation for this, because port 5060 can be both TCP and UDP. It depends on the current settings of the local network.

    Normally, SIP requires that the outbound traffic be permitted (from PBX, for example), and inbound connections will work automatically. RTP is usually used as UDP (so data can still be transmitted although packets are lost).

    The ports themselves can be set up in the PBX properties: the port that is indicated in the properties must also be opened in Firewall.



    Chapter contents:


    Courses developed by «Bitrix», Inc.