From 57b600551740a5c960d73b43bd9030c5cbbfce14 Mon Sep 17 00:00:00 2001
From: Joas Schilling <coding@schilljs.com>
Date: Wed, 25 Mar 2026 18:09:27 +0100
Subject: [PATCH 1/3] feat(hint): SIP calls

Signed-off-by: Joas Schilling <coding@schilljs.com>
---
 lib/Config.php                                |  2 +-
 src/components/LeftSidebar/LeftSidebar.vue    | 17 +++++++++++-
 .../Participants/ParticipantsTab.vue          | 26 ++++++++++++++++++-
 src/components/SelectPhoneNumber.vue          | 24 ++++++++++++++++-
 src/services/CapabilitiesManager.ts           | 10 +++++++
 tests/php/CapabilitiesTest.php                |  4 +--
 6 files changed, 77 insertions(+), 6 deletions(-)

diff --git a/lib/Config.php b/lib/Config.php
index 5153ea00dc1..a3dd01a365e 100644
--- a/lib/Config.php
+++ b/lib/Config.php
@@ -42,7 +42,7 @@ class Config {
 	/**
 	 * 1. Call recording, …
 	 */
-	public const FEATURE_HINT = 1;
+	public const FEATURE_HINT = 34;
 
 	/**
 	 * Currently limiting to 1k users because the user_status API would yield
diff --git a/src/components/LeftSidebar/LeftSidebar.vue b/src/components/LeftSidebar/LeftSidebar.vue
index 17a7d2d8c7a..eea4bfbb567 100644
--- a/src/components/LeftSidebar/LeftSidebar.vue
+++ b/src/components/LeftSidebar/LeftSidebar.vue
@@ -124,6 +124,15 @@
 							</template>
 							{{ t('spreed', 'Call a phone number') }}
 						</NcActionButton>
+						<NcActionButton
+							v-else-if="hintSipDialOut"
+							disabled
+							:description="t('spreed', 'SIP backend is not installed')">
+							<template #icon>
+								<IconPhoneOutline :size="20" />
+							</template>
+							{{ t('spreed', 'Call a phone number') }}
+						</NcActionButton>
 					</NcActions>
 				</TransitionWrapper>
 
@@ -348,7 +357,11 @@ import { useArrowNavigation } from '../../composables/useArrowNavigation.js'
 import { useGetToken } from '../../composables/useGetToken.ts'
 import { ATTENDEE, CONVERSATION } from '../../constants.ts'
 import BrowserStorage from '../../services/BrowserStorage.js'
-import { getTalkConfig, hasTalkFeature } from '../../services/CapabilitiesManager.ts'
+import {
+	getTalkConfig,
+	hasTalkFeature,
+	showTalkFeatureHint,
+} from '../../services/CapabilitiesManager.ts'
 import {
 	createLegacyConversation,
 	fetchNoteToSelfConversation,
@@ -372,6 +385,7 @@ const canModerateSipDialOut = hasTalkFeature('local', 'sip-support-dialout')
 	&& getTalkConfig('local', 'call', 'sip-enabled')
 	&& getTalkConfig('local', 'call', 'sip-dialout-enabled')
 	&& getTalkConfig('local', 'call', 'can-enable-sip')
+const hintSipDialOut = !canModerateSipDialOut && showTalkFeatureHint(34)
 const canNoteToSelf = hasTalkFeature('local', 'note-to-self')
 const supportsArchive = hasTalkFeature('local', 'archived-conversations-v2')
 const supportThreads = hasTalkFeature('local', 'threads')
@@ -458,6 +472,7 @@ export default {
 			talkHashStore,
 			isMobile,
 			canModerateSipDialOut,
+			hintSipDialOut,
 			canNoteToSelf,
 			supportsArchive,
 			supportThreads,
diff --git a/src/components/RightSidebar/Participants/ParticipantsTab.vue b/src/components/RightSidebar/Participants/ParticipantsTab.vue
index 5ac678896a3..4df2a0e57ec 100644
--- a/src/components/RightSidebar/Participants/ParticipantsTab.vue
+++ b/src/components/RightSidebar/Participants/ParticipantsTab.vue
@@ -29,6 +29,10 @@
 				v-if="canAddPhones"
 				v-model:value="searchText"
 				@submit="addParticipants(participantPhoneItem)" />
+			<DialpadPanel
+				v-else-if="hintAddPhones"
+				:title="t('spreed', 'SIP backend is not installed')"
+				disabled />
 		</div>
 
 		<SelectPhoneNumber
@@ -72,6 +76,14 @@
 				:noResults="noResults"
 				:searchText="searchText"
 				@click="addParticipants" />
+
+			<SelectPhoneNumber
+				v-if="hintAddPhones"
+				v-model:participantPhoneItem="participantPhoneItem"
+				:name="t('spreed', 'Add a phone number')"
+				:value="searchText"
+				:hintAddPhones="true"
+				@select="addParticipants" />
 		</div>
 	</div>
 </template>
@@ -99,7 +111,11 @@ import { useGetToken } from '../../../composables/useGetToken.ts'
 import { useIsInCall } from '../../../composables/useIsInCall.js'
 import { useSortParticipants } from '../../../composables/useSortParticipants.js'
 import { ATTENDEE, CONVERSATION } from '../../../constants.ts'
-import { getTalkConfig, hasTalkFeature } from '../../../services/CapabilitiesManager.ts'
+import {
+	getTalkConfig,
+	hasTalkFeature,
+	showTalkFeatureHint,
+} from '../../../services/CapabilitiesManager.ts'
 import { autocompleteQuery } from '../../../services/coreService.ts'
 import { EventBus } from '../../../services/EventBus.ts'
 import { addParticipant } from '../../../services/participantsService.js'
@@ -227,6 +243,14 @@ export default {
 			return canModerateSipDialOut && this.conversation.canEnableSIP
 		},
 
+		hintAddPhones() {
+			const canModerateSipDialOut = hasTalkFeature(this.token, 'sip-support-dialout')
+				&& getTalkConfig(this.token, 'call', 'sip-enabled')
+				&& getTalkConfig(this.token, 'call', 'sip-dialout-enabled')
+				&& getTalkConfig(this.token, 'call', 'can-enable-sip')
+			return !canModerateSipDialOut && showTalkFeatureHint(34)
+		},
+
 		isSearching() {
 			return this.searchText !== ''
 		},
diff --git a/src/components/SelectPhoneNumber.vue b/src/components/SelectPhoneNumber.vue
index 43840b326df..752874e2d4a 100644
--- a/src/components/SelectPhoneNumber.vue
+++ b/src/components/SelectPhoneNumber.vue
@@ -7,7 +7,20 @@
 	<ul v-if="value">
 		<NcAppNavigationCaption :name="t('spreed', 'Phone numbers')" />
 		<NavigationHint v-if="errorHint" :hint="errorHint" />
-		<template v-if="libPhoneNumber">
+		<template v-if="hintAddPhones && libPhoneNumber">
+			<NcListItem :name="name" @click="selectPhoneNumber">
+				<template #icon>
+					<IconPhoneOutline :size="AVATAR.SIZE.DEFAULT" fillColor="var(--color-text-maxcontrast)" />
+				</template>
+				<template #name>
+					<em>{{ participantPhoneItem.phoneNumber }}</em>
+				</template>
+				<template #subname>
+					{{ t('spreed', 'SIP backend is not installed') }}
+				</template>
+			</NcListItem>
+		</template>
+		<template v-else-if="libPhoneNumber">
 			<NcListItem :name="name" @click="selectPhoneNumber">
 				<template #icon>
 					<IconPhoneOutline :size="AVATAR.SIZE.DEFAULT" />
@@ -57,6 +70,11 @@ export default {
 			type: Object,
 			required: true,
 		},
+
+		hintAddPhones: {
+			type: Boolean,
+			default: false,
+		},
 	},
 
 	emits: ['select', 'update:participantPhoneItem'],
@@ -118,6 +136,10 @@ export default {
 	methods: {
 		t,
 		selectPhoneNumber() {
+			if (this.hintAddPhones) {
+				return
+			}
+
 			this.$emit('select', this.participantPhoneItem)
 		},
 	},
diff --git a/src/services/CapabilitiesManager.ts b/src/services/CapabilitiesManager.ts
index 7f70d57fccb..a7c7afa6b5e 100644
--- a/src/services/CapabilitiesManager.ts
+++ b/src/services/CapabilitiesManager.ts
@@ -98,6 +98,16 @@ export function getTalkConfig<
 	}
 }
 
+/**
+ * Check whether the feature hint should be shown
+ *
+ * @param featureHint FEATURE_HINT threshold according to lib/Config.php (e.g. Nextcloud version when hint or feature was introduced)
+ */
+export function showTalkFeatureHint(featureHint: number): boolean {
+	return (getTalkConfig('local', 'feature-hints', 'current') ?? 0) >= featureHint
+		&& (getTalkConfig('local', 'feature-hints', 'hidden') ?? 0) < featureHint
+}
+
 /**
  * Check whether the app has capabilities published
  *
diff --git a/tests/php/CapabilitiesTest.php b/tests/php/CapabilitiesTest.php
index 5370b7f7ca8..498837076de 100644
--- a/tests/php/CapabilitiesTest.php
+++ b/tests/php/CapabilitiesTest.php
@@ -234,7 +234,7 @@ public function testGetCapabilitiesGuest(): void {
 						'enabled' => 0,
 					],
 					'feature-hints' => [
-						'current' => 1,
+						'current' => 34,
 						'hidden' => 999,
 					],
 					'permissions' => [
@@ -448,7 +448,7 @@ public function testGetCapabilitiesUserAllowed(bool $isNotAllowed, bool $canCrea
 						'enabled' => 0,
 					],
 					'feature-hints' => [
-						'current' => 1,
+						'current' => 34,
 						'hidden' => 1,
 					],
 					'permissions' => [

From eac2f851412861d3f0a8b1b30732b5591a151b84 Mon Sep 17 00:00:00 2001
From: Joas Schilling <coding@schilljs.com>
Date: Wed, 25 Mar 2026 18:09:45 +0100
Subject: [PATCH 2/3] feat(hint): Call recordings

Signed-off-by: Joas Schilling <coding@schilljs.com>
---
 .../MediaSettings/MediaSettings.vue           | 16 +++++++++++++-
 src/components/TopBar/TopBarMenu.vue          | 22 ++++++++++++++++++-
 2 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/src/components/MediaSettings/MediaSettings.vue b/src/components/MediaSettings/MediaSettings.vue
index 04147b73a13..e3f1a7bb3af 100644
--- a/src/components/MediaSettings/MediaSettings.vue
+++ b/src/components/MediaSettings/MediaSettings.vue
@@ -205,6 +205,13 @@
 						class="checkbox">
 						{{ t('spreed', 'Start recording immediately with the call') }}
 					</NcCheckboxRadioSwitch>
+					<NcCheckboxRadioSwitch
+						v-else-if="hintRecordingOption"
+						:description="t('spreed', 'Recording backend is not installed')"
+						disabled
+						class="checkbox">
+						{{ t('spreed', 'Start recording immediately with the call') }}
+					</NcCheckboxRadioSwitch>
 					<!-- Notify call option-->
 					<NcCheckboxRadioSwitch
 						v-if="showNotifyCallOption"
@@ -271,7 +278,10 @@ import { useGetToken } from '../../composables/useGetToken.ts'
 import { useIsInCall } from '../../composables/useIsInCall.js'
 import { ATTENDEE, AVATAR, CALL, CONFIG, PARTICIPANT, VIRTUAL_BACKGROUND } from '../../constants.ts'
 import BrowserStorage from '../../services/BrowserStorage.js'
-import { getTalkConfig } from '../../services/CapabilitiesManager.ts'
+import {
+	getTalkConfig,
+	showTalkFeatureHint,
+} from '../../services/CapabilitiesManager.ts'
 import { useActorStore } from '../../stores/actor.ts'
 import { useGuestNameStore } from '../../stores/guestName.ts'
 import { useSettingsStore } from '../../stores/settings.ts'
@@ -516,6 +526,10 @@ export default {
 			return !this.hasCall && this.canModerateRecording && this.isBeforeJoinCall
 		},
 
+		hintRecordingOption() {
+			return !this.hasCall && this.canFullModerate && !(getTalkConfig(this.token, 'call', 'recording') || false) && this.isBeforeJoinCall && showTalkFeatureHint(34)
+		},
+
 		showUpdateChangesButton() {
 			return (this.isDeviceCheck
 				|| this.isInCall)
diff --git a/src/components/TopBar/TopBarMenu.vue b/src/components/TopBar/TopBarMenu.vue
index 77db024a79d..d2ce97e77d0 100644
--- a/src/components/TopBar/TopBarMenu.vue
+++ b/src/components/TopBar/TopBarMenu.vue
@@ -61,6 +61,18 @@
 						{{ t('spreed', 'Stop recording') }}
 					</NcActionButton>
 				</template>
+				<template v-else-if="hintRecording">
+					<NcActionButton
+						disabled
+						:description="t('spreed', 'Recording backend is not installed')">
+						<template #icon>
+							<NcIconSvgWrapper
+								:svg="IconScreenRecordOutline"
+								:size="20" />
+						</template>
+						{{ t('spreed', 'Start recording') }}
+					</NcActionButton>
+				</template>
 
 				<NcActionSeparator v-if="!isOneToOneConversation || canModerateRecording" />
 			</template>
@@ -174,7 +186,11 @@ import {
 } from '../../composables/useDocumentFullscreen.ts'
 import { useIsInCall } from '../../composables/useIsInCall.js'
 import { CALL, CONVERSATION, PARTICIPANT } from '../../constants.ts'
-import { getTalkConfig, hasTalkFeature } from '../../services/CapabilitiesManager.ts'
+import {
+	getTalkConfig,
+	hasTalkFeature,
+	showTalkFeatureHint,
+} from '../../services/CapabilitiesManager.ts'
 import { generateAbsoluteUrl } from '../../utils/handleUrl.ts'
 import { callParticipantCollection } from '../../utils/webrtc/index.js'
 
@@ -284,6 +300,10 @@ export default {
 			return getTalkConfig(this.token, 'call', 'recording') || false
 		},
 
+		hintRecording() {
+			return !this.canModerateRecording && showTalkFeatureHint(34)
+		},
+
 		canConfigureBreakoutRooms() {
 			if (this.conversation.type !== CONVERSATION.TYPE.GROUP || !this.canFullModerate) {
 				return false

From 2fb49b7027caccb67d8d97b7f0041fd374d95f03 Mon Sep 17 00:00:00 2001
From: Joas Schilling <coding@schilljs.com>
Date: Wed, 25 Mar 2026 18:09:56 +0100
Subject: [PATCH 3/3] feat(hint): Live transcription and translation

Signed-off-by: Joas Schilling <coding@schilljs.com>
---
 src/components/CallView/BottomBar.vue         | 60 ++++++++++++++++++-
 .../ConversationSettingsDialog.vue            | 23 ++++++-
 2 files changed, 80 insertions(+), 3 deletions(-)

diff --git a/src/components/CallView/BottomBar.vue b/src/components/CallView/BottomBar.vue
index b3b72fcccbf..187f0b781d3 100644
--- a/src/components/CallView/BottomBar.vue
+++ b/src/components/CallView/BottomBar.vue
@@ -37,7 +37,10 @@ import {
 } from '../../composables/useDocumentFullscreen.ts'
 import { useGetToken } from '../../composables/useGetToken.ts'
 import { CONVERSATION, PARTICIPANT } from '../../constants.ts'
-import { getTalkConfig } from '../../services/CapabilitiesManager.ts'
+import {
+	getTalkConfig,
+	showTalkFeatureHint,
+} from '../../services/CapabilitiesManager.ts'
 import { useActorStore } from '../../stores/actor.ts'
 import { useBreakoutRoomsStore } from '../../stores/breakoutRooms.ts'
 import { useCallViewStore } from '../../stores/callView.ts'
@@ -77,7 +80,9 @@ const canModerate = computed(() => [PARTICIPANT.TYPE.OWNER, PARTICIPANT.TYPE.MOD
 	.includes(conversation.value.participantType))
 
 const isLiveTranscriptionSupported = computed(() => getTalkConfig(token.value, 'call', 'live-transcription') || false)
+const hintTranscriptionSupported = computed(() => !isLiveTranscriptionSupported.value && showTalkFeatureHint(34))
 const isLiveTranslationSupported = computed(() => getTalkConfig(token.value, 'call', 'live-translation') || false)
+const hintTranslationSupported = computed(() => !isLiveTranslationSupported.value && showTalkFeatureHint(34))
 
 const liveTranscriptionButtonLabel = computed(() => {
 	if (callViewStore.isLiveTranscriptionEnabled && languageType.value === LanguageType.Original) {
@@ -87,6 +92,10 @@ const liveTranscriptionButtonLabel = computed(() => {
 	return t('spreed', 'Enable live transcription (generated by AI)')
 })
 
+const hintTranscriptionButtonLabel = computed(() => {
+	return t('spreed', 'Enable live transcription (Live transcriptions app is not installed)')
+})
+
 const liveTranslationButtonLabel = computed(() => {
 	if (callViewStore.isLiveTranscriptionEnabled && languageType.value === LanguageType.Target) {
 		return t('spreed', 'Disable live translation')
@@ -95,6 +104,14 @@ const liveTranslationButtonLabel = computed(() => {
 	return t('spreed', 'Enable live translation (generated by AI)')
 })
 
+const hintOriginalButtonLabel = computed(() => {
+	return t('spreed', 'Original language')
+})
+
+const hintTranslationButtonLabel = computed(() => {
+	return t('spreed', 'Live translations app is not installed')
+})
+
 const originalLanguageButtonLabel = computed(() => {
 	const languageId = conversation.value.liveTranscriptionLanguageId || 'en'
 
@@ -557,7 +574,7 @@ useHotKey('r', toggleHandRaised)
 					:variant="callViewStore.isLiveTranscriptionEnabled ? 'secondary' : 'tertiary'"
 					:disabled="isLiveTranscriptionLoading"
 					:class="{
-						'translation-button': isLiveTranslationSupported,
+						'translation-button': isLiveTranslationSupported || hintTranslationSupported,
 					}"
 					@click="toggleLiveTranscriptionAndTranslation">
 					<template #icon>
@@ -604,6 +621,45 @@ useHotKey('r', toggleHandRaised)
 						{{ targetLanguageButtonLabel }}
 					</NcActionButton>
 				</NcActions>
+				<NcActions
+					v-else-if="hintTranslationSupported"
+					class="language-selector-button">
+					<template #icon>
+						<IconChevronUp :size="16" />
+					</template>
+					<NcActionButton
+						class="language-selector__action"
+						type="radio"
+						:modelValue="languageType"
+						:value="LanguageType.Original"
+						:title="hintOriginalButtonLabel">
+						{{ hintOriginalButtonLabel }}
+					</NcActionButton>
+					<NcActionSeparator />
+					<NcActionButton
+						class="language-selector__action"
+						type="radio"
+						disabled
+						:modelValue="languageType"
+						:value="LanguageType.Target"
+						:title="hintTranslationButtonLabel">
+						{{ hintTranslationButtonLabel }}
+					</NcActionButton>
+				</NcActions>
+			</div>
+			<div
+				v-else-if="hintTranscriptionSupported"
+				class="live-transcription-button-wrapper">
+				<NcButton
+					:title="hintTranscriptionButtonLabel"
+					:aria-label="hintTranscriptionButtonLabel"
+					variant="secondary"
+					disabled>
+					<template #icon>
+						<IconSubtitlesOutline
+							:size="20" />
+					</template>
+				</NcButton>
 			</div>
 
 			<NcButton
diff --git a/src/components/ConversationSettings/ConversationSettingsDialog.vue b/src/components/ConversationSettings/ConversationSettingsDialog.vue
index da1bd98fcbd..517603b3e0d 100644
--- a/src/components/ConversationSettings/ConversationSettingsDialog.vue
+++ b/src/components/ConversationSettings/ConversationSettingsDialog.vue
@@ -65,6 +65,17 @@
 				:name="t('spreed', 'Live transcription')">
 				<LiveTranscriptionSettings :token="token" />
 			</NcAppSettingsSection>
+			<NcAppSettingsSection
+				v-else-if="hintLiveTranscription"
+				id="live-transcription"
+				:name="t('spreed', 'Live transcription')">
+				<NcCheckboxRadioSwitch
+					:description="t('spreed', 'Live transcriptions app is not installed')"
+					type="switch"
+					disabled>
+					{{ t('spreed', 'Enable live transcription') }}
+				</NcCheckboxRadioSwitch>
+			</NcAppSettingsSection>
 
 			<!-- Breakout rooms -->
 			<NcAppSettingsSection
@@ -144,7 +155,11 @@ import NotificationsSettings from './NotificationsSettings.vue'
 import RecordingConsentSettings from './RecordingConsentSettings.vue'
 import SipSettings from './SipSettings.vue'
 import { CALL, CONFIG, CONVERSATION, PARTICIPANT } from '../../constants.ts'
-import { getTalkConfig, hasTalkFeature } from '../../services/CapabilitiesManager.ts'
+import {
+	getTalkConfig,
+	hasTalkFeature,
+	showTalkFeatureHint,
+} from '../../services/CapabilitiesManager.ts'
 import { useActorStore } from '../../stores/actor.ts'
 
 // FIXME Should use remote not local
@@ -267,6 +282,12 @@ export default {
 				&& this.selfIsOwnerOrModerator
 		},
 
+		hintLiveTranscription() {
+			return !this.isLiveTranscriptionSupported
+				&& this.selfIsOwnerOrModerator
+				&& showTalkFeatureHint(34)
+		},
+
 		canConfigureBreakoutRooms() {
 			return this.canFullModerate
 				&& (getTalkConfig(this.token, 'call', 'breakout-rooms') || false)