The document describes how to configure Push-to-talk feature for x-hoppers broadcast.
Created: May 2024
Permalink: https://wildix.atlassian.net/wiki/x/AQCIIg
Introduction
The feature allows to send Push-to-talk messages to x-hoppers broadcast from x-bees conversation. With this option, users can send voice messages to x-hoppers broadcast via mobile and receive broadcast messages to x-bees conversation on mobile, having them played automatically in Speaker mode.
Requirements
Configuration
Add the parameter --conf_recording or -ptt to the /etc/systemd/system/pbx-data-engine.service.d/override.conf file.
Example:[Service] ExecStart= ExecStart=/usr/sbin/pbx_data_engine.py --conf_recording --daemon --mode calls presence --env prod -e -l 4 --xhop_voice_login true
Restart the service to apply the changes:
systemctl daemon-reload systemctl restart pbx-data-engine
For the feature to work on mobile, make sure there is an included procedure pbxservice(Services codes dialplan) set in Dialplan:
- Create a conversation in x-bees, adding all members of x-hoppers broadcast, including all W-AIR headset users and all users of x-bees mobile app, that are going to use the Push-to-talk feature. The transcription and audio files of what was pronounced in x-hoppers broadcast will be added to this conversation.
Add the following lines to the /rw2/etc/pbx/x-hoppers.json file:
"audio_conf_id": 0, "xbees_channel_id": "a1b88b80-a287-4848-8d1a-9fb8721f"
Where:
“0” is the number of x-hopper conference
"a1b88b80-a287-4848-8d1a-9fb8721f" is the ID of x-bees conversation.
Restart the service to apply the changes:
systemctl daemon-reload systemctl restart pbx-data-engine
Usage on Mobile
On mobile, users need to:
Go to Settings -> Integrations -> enable the toggle next to Allow Push-to-talk option:
Find x-hoppers conversation on the Inbox tab -> press and hold the conversation icon:
On the pop-up screen that appears below, press the option “Enter x-hoppers group”:
To send a voice message to x-hoppers broadcast via mobile, user should press and hold the Push-to-talk button next to the message field:
The message is played to users in x-hoppers broadcast. Also, once mobile user enters the x-hoppers conversation, the group messages are automatically played on mobile in Speaker mode.