Configure with an active PBX server

If you have:

  1. An active PBX server

  2. Asterisk manager configured

You can start to configure the voice channel Rocket.Chat workspace.

1. Enable Voice Channel

  1. Navigate to Administration > Workspace > Settings > Voice Channel

  2. Enable voice channel, as shown below:

Rocket.Chat establishes two connections with Asterisk, one via AMI to read configuration and list extensions, queues, and some other things, and the second one is the WebRTC SIP registration.

2. Configure AMI connection

  • Navigate to Administration > Workspace > Settings > Voice Channel > Settings > Asterisk Manager Interface (AMI).

  • Fill the form with the FQDN of your server and the username/password gotten as shown here, or it should be provided to you by your Asterisk manager.

2.1 Test AMI Connection

To test AMI connection, turn to the Extensions tab. Here you should see a list of the existing extensions in Asterisk:

Also enabling the AMI debug you may see connections coming and the RC AMI user connected:

manager set debug on
manager show connected

If you see it, your Rocket.Chat is connected to Asterisk’s AMI.

3. Configure WebSocket Server Connection

Rocket.Chat needs a WebSocket connection to forward calls from Asterisk to Rocket.Chat.

The parameters for a FreePBX connection are:

Change them according to your Asterisk server conditions. Then in the Settings tab, assign at least one extension to a Rocket.Chat user. When that user logs in to Rocket.Chat the webphone will try to connect to Asterisk.

3.1 Test WebSocket Connection

To test the WebSocket Connection, you just need to log in with a user associated with an extension and check if the extension registers successfully.

The phone icon with a slash over means that the WebSocket connection is possible, Rocket.Chat could send a SIP Options packet to Asterisk, and it was successfully answered. Click on the phone icon, and it will turn green. Now the user is ready to receive calls, and in Asterisk, you should have received a SIP register packet, and the extension should be properly registered. Validate it with:

pjsip show endpoints

Congratulations! You have successfully configured Rocket.Chat with Asterisk!

The next step now is to associate your Rocket.Chat agents with Asterisk extensions.

Last updated

Rocket.Chat versions receive support for six months after release.