Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

The document describes how to configure Push-to-talk feature for x-hoppers broadcast on mobile.

Download mobile app:

Created: June 2024

Updated: December 2024

Permalink: https://x-hoppers.atlassian.net/wiki/x/AYAx

Table of Contents
stylenone

Introduction

The feature allows you to send Push-to-talk messages to x-hoppers broadcast from x-bees conversationa group conversation on mobile. With this option, users can send voice messages to x-hoppers broadcast via mobile and receive broadcast messages to x-bees conversation conversations on mobile, having them played automatically in Speaker mode. 

Requirements

Configuration

  1. Add the parameter  --conf_recording or -ptt cr to the /etc/systemd/system/pbx-data-engine.service.d/override.conf file.

    Example: 

    Code Block
    vi  /etc/systemd/system/pbx-data-engine.service.d/override.conf
    
    [Service]
    
    ExecStart=
    
    ExecStart=/usr/sbin/pbx_data_engine.py --conf_recordingdaemon --daemoncr
  2. Restart the service to apply the changes: 

    Code Block
    systemctl daemon-reload 
    
    systemctl restart pbx-data-engine
  3. For the feature to work on mobile, make sure there is an included procedure pbxservicepbxservices (Services codes dialplan) set in Dialplan:

...

  1. 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.

  2. Add the following lines to the /rw2/etc/pbx/x-hoppers.json file: 

    Code Block
    [
        {
            "audio_conf_id": 0,
            "xbees_channel_id": "a1b88b80-a287-4848-8d1a-9fb8721f"
        }
    ]

    Where:

    1. “0” is the ID number of x-hopper conferencebroadcast

    2. "a1b88b80-a287-4848-8d1a-9fb8721f" is the ID of x-bees conversation

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#E3FCEF
Tip

Note: The conversation ID is available in the conversation URL: 

  1. Restart the service to apply the changes: 

    Code Block
    systemctl daemon-reload 
    
    systemctl restart pbx-data-engine

Usage on Mobile 

...

Usage 

To start using this feature:

  1. Go to mobile app Settings -> Integrations -> enable the toggle next to Allow Push-to-talk option:

...

#E3FCEF
Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor
Tip

Note: The Push-to-Talk button under Allow Push-to-Talk can currently be used to connect Jabra Perform 45 headset. 

Note

Important: On Android, it is necessary to allow "Nearby Devices" permission for x-bees the mobile app for the Push-to-talk feature to work. 

...

  1. 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:

...

Note

Current limitation: PTT messages should not be longer than 3 minutes in case of x-hoppers broadcast with transcription of in-store conversations enabled.

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.
What is pronounced in x-hoppers broadcast is added as a message from the relevant user with a transcription and audio file:

...

  1. To exit the broadcast, go to the Inbox tab ->  press > press and hold the relevant conversation -> on the pop-up screen that appears below, press the option Exit x-hoppers group:

...