RocketChat · aleksandernsilva · May 11, 2026 · May 14, 2026 · hacktron-app · May 26, 2026
diff --git a/.changeset/fuzzy-terms-brake.md b/.changeset/fuzzy-terms-brake.md
@@ -0,0 +1,12 @@
+---
+'@rocket.chat/media-calls': minor
+'@rocket.chat/model-typings': minor
+'@rocket.chat/ui-voip': minor
+'@rocket.chat/models': minor
+'@rocket.chat/i18n': minor
+'@rocket.chat/core-typings': minor
+'@rocket.chat/rest-typings': minor
+'@rocket.chat/meteor': minor
+---
+
+Adds name and avatar resolution for external voice calls
diff --git a/ee/packages/media-calls/src/sip/providers/IncomingSipCall.ts b/ee/packages/media-calls/src/sip/providers/IncomingSipCall.ts
@@ -439,39 +439,44 @@ export class IncomingSipCall extends BaseSipCall {
 		throw new SipError(SipErrorCodes.NOT_FOUND);
 	}
 
-	private static async getRocketChatCallerFromInvite(req: SrfRequest): Promise<MediaCallContact | null> {
-		logger.debug({
-			msg: 'IncomingSipCall.getRocketChatCallerFromInvite',
-			callingNumber: req.callingNumber,
-			calledNumber: req.calledNumber,
-		});
+	private static getDisplayNameFromInvite(req: SrfRequest): string | undefined {
+		const removeQuotes = (str?: string): string | undefined => str?.replace(/^"|"$/g, '').trim();
 
-		if (req.callingNumber && typeof req.callingNumber === 'string') {
-			const userContact = await mediaCallDirector.cast.getContactForExtensionNumber(req.callingNumber, { preferredType: 'sip' });
-			if (userContact) {
-				return userContact;
+		if (req.has('X-RocketChat-Caller-Name')) {
+			const headerValue = req.get('X-RocketChat-Caller-Name');
+			if (headerValue) {
+				return headerValue;
 			}
 		}
 
-		return null;
+		if (req.has('p-asserted-identity')) {
+			const pAssertedIdentity = removeQuotes(req.getParsedHeader('p-asserted-identity')?.name);
+			if (pAssertedIdentity) {
+				return pAssertedIdentity;
+			}
+		}
+
+		if (req.has('from')) {
+			const fromHeader = removeQuotes(req.getParsedHeader('from')?.name);
+			if (fromHeader) {
+				return fromHeader;
+			}
+		}
+
+		return undefined;
 	}
 
 	private static async getCallerContactFromInvite(sessionId: string, req: SrfRequest): Promise<MediaCallSignedContact<'sip'>> {
 		logger.debug({ msg: 'IncomingSipCall.getCallerContactFromInvite' });
-		const callerBase = await this.getRocketChatCallerFromInvite(req);
 
-		const displayNameFromHeader = req.has('X-RocketChat-Caller-Name') && req.get('X-RocketChat-Caller-Name');
+		const displayName = this.getDisplayNameFromInvite(req);
 		const usernameFromHeader = req.has('X-RocketChat-Caller-Username') && req.get('X-RocketChat-Caller-Username');
-
-		const displayName = displayNameFromHeader || callerBase?.displayName || req.from;
-		const username = usernameFromHeader || callerBase?.username || req.callingNumber;
-
 		const sipExtension = req.callingNumber;
 
 		const defaultContactInfo: MediaCallContactInformation = {
-			username,
 			sipExtension,
 			displayName: displayName || sipExtension,
+			...(usernameFromHeader && { username: usernameFromHeader }),
 		};
 
 		const contact = await mediaCallDirector.cast.getContactForExtensionNumber(sipExtension, { requiredType: 'sip' }, defaultContactInfo);

diff --git a/packages/ui-voip/src/components/PeerInfo/ExternalUser.tsx b/packages/ui-voip/src/components/PeerInfo/ExternalUser.tsx
@@ -0,0 +1,18 @@
+import InternalUser from './InternalUser';
+import PhoneNumber from './PhoneNumber';
+
+export type ExternalUserProps = {
+	number: string;
+	displayName?: string;
+	avatarUrl?: string;
+};
+
+const ExternalUser = ({ number, displayName, avatarUrl }: ExternalUserProps) => {
+	if (displayName) {
+		return <InternalUser displayName={displayName} avatarUrl={avatarUrl} callerId={number} />;
+	}
+
+	return <PhoneNumber number={number} />;
+};
+
+export default ExternalUser;
diff --git a/packages/ui-voip/src/components/PeerInfo/InternalUser.tsx b/packages/ui-voip/src/components/PeerInfo/InternalUser.tsx
@@ -3,7 +3,7 @@ import { Avatar, Box, Icon, StatusBullet } from '@rocket.chat/fuselage';
 
 import type { Slot } from './useInfoSlots';
 
-type InternalUserProps = {
+export type InternalUserProps = {
 	displayName: string;
 	status?: UserStatus;
 	avatarUrl?: string;

diff --git a/packages/ui-voip/src/components/PeerInfo/PeerInfo.stories.tsx b/packages/ui-voip/src/components/PeerInfo/PeerInfo.stories.tsx
@@ -62,5 +62,30 @@ export const InternalUserWithRemoteStatus: StoryFn<typeof PeerInfo> = () => {
 };
 
 export const ExternalUser: StoryFn<typeof PeerInfo> = () => {
-	return <PeerInfo number='1234567890' />;
+	return <PeerInfo external number='1234567890' />;
+};
+
+export const ExternalUserWithDisplayName: StoryFn<typeof PeerInfo> = () => {
+	return <PeerInfo external number='1234567890' displayName='Jane Doe' />;
+};
+
+export const ExternalUserWithDisplayNameAndAvatar: StoryFn<typeof PeerInfo> = () => {
+	return (
+		<PeerInfo
+			external
+			number='1234567890'
+			displayName='Jane Doe'
+			avatarUrl='data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC
+              4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMj
+              IyMjIyMjIyMjIyMjIyMjL/wAARCAAoACgDASIAAhEBAxEB/8QAGwAAAgIDAQAAAAAAAAAAAAAAAAcEBgIDBQj/xAAuEAACAQQAAwcEAQUAAA
+              AAAAABAgMABAUREiExBhMUIkFRYQcWcYGhFTJSgpH/xAAYAQADAQEAAAAAAAAAAAAAAAACAwQBAP/EAB4RAAIBBQEBAQAAAAAAAAAAAAABAg
+              MREiExE0HR/9oADAMBAAIRAxEAPwBuXuIkhBuMe5ib/AHQP49q4L3mLitryTLTSpOiHQI5k/HzXa/qbFOEudVTu1dumWvcTaNCZYZ7vU6g6L
+              xqjOU/24dfs1Ouh9FnkMpd3Reeyx83hAxZZEhkdV9/MBrX71WGPvJcqrJBGveKATtuXXqNU0pu02bTHXD/AGvJAluyxxRd6F4x00o+NdKoVr
+              jbzJdvVe1t5cVLc2ck8qjnohgpPtz2v7G6JtPQ2VJwjlcw+37mchpnK6GtIuv5NFWeTsLNPvxWTvpfjvOEfwKKzEVkSct2vscS/BIzSN0YRk
+              eX81UpPqO8masJETu7OOccY4dswYFQeftv096XV5knuJGdm2T1+agvMXj8jEaHX905QihabvcbuS7X566mLWLwSY8PuRnk/u4eZ0deTl71Ef
+              6hY+0yM88TzeNZY4luYwpVYyduOfrvhPTnr0pXSX9y5mCsyJMdyxxvwq599em+taItqCSNc90ChvZRUruUcT0JiO18Elpk7t8v41LWzacxkB
+              SuvjQ/FFJayjDWrCTepAQ2vUH0oo/Jk3ovpwJJeVCP5CN+lFFaaMqy+nAyuChvrTI2kN9JAsi2ZOy4IBHMnkSCP+iqBexSWdxLazoUljJVlP
+              UH2oorkV10pRc7b1zXb/hZOzuJvM86QWEXeELxOzHSIPcmiiiunVlF2RNTpRkrs//Z'
+		/>
+	);
 };
diff --git a/packages/ui-voip/src/components/PeerInfo/PeerInfo.tsx b/packages/ui-voip/src/components/PeerInfo/PeerInfo.tsx
@@ -1,14 +1,15 @@
-import type { ComponentProps } from 'react';
+import { ExternalUser, InternalUser } from '.';
+import type { ExternalUserProps } from './ExternalUser';
+import type { InternalUserProps } from './InternalUser';
 
-import { InternalUser, PhoneNumber } from '.';
-
-export type PeerInfoProps = ComponentProps<typeof InternalUser> | ComponentProps<typeof PhoneNumber>;
+export type PeerInfoProps = (InternalUserProps & { external?: false }) | (ExternalUserProps & { external: true });
 
 const PeerInfo = (props: PeerInfoProps) => {
-	if ('displayName' in props) {
-		return <InternalUser {...props} />;
+	if (props.external) {
+		return <ExternalUser {...props} />;
 	}
-	return <PhoneNumber {...props} />;
+
+	return <InternalUser {...props} />;
 };
 
 export default PeerInfo;
diff --git a/packages/ui-voip/src/components/PeerInfo/__snapshots__/PeerInfo.spec.tsx.snap b/packages/ui-voip/src/components/PeerInfo/__snapshots__/PeerInfo.spec.tsx.snap
@@ -23,6 +23,107 @@ exports[`renders ExternalUser without crashing 1`] = `
 </body>
 `;
 
+exports[`renders ExternalUserWithDisplayName without crashing 1`] = `
+<body>
+  <div>
+    <div
+      class="rcx-box rcx-box--full rcx-css-omrq7i"
+      id="rcx-media-call-widget-caller-info"
+    >
+      <div
+        class="rcx-box rcx-box--full rcx-css-1rtu0k9"
+      >
+        <i
+          aria-hidden="true"
+          class="rcx-box rcx-box--full rcx-icon--name-user rcx-icon rcx-css-4pvxx3"
+        >
+          
+        </i>
+      </div>
+      <div
+        class="rcx-box rcx-box--full rcx-css-jgzlgu"
+      >
+        <div
+          class="rcx-box rcx-box--full rcx-css-1jbbtow"
+        >
+          <span
+            class="rcx-box rcx-box--full rcx-css-ilfe77"
+          >
+            <div
+              class="rcx-box rcx-box--full rcx-css-nc7kyx"
+            >
+              Jane Doe
+            </div>
+          </span>
+        </div>
+        <div
+          class="rcx-box rcx-box--full rcx-css-1m7ucy6"
+        >
+          1234567890
+        </div>
+      </div>
+    </div>
+  </div>
+</body>
+`;
+
+exports[`renders ExternalUserWithDisplayNameAndAvatar without crashing 1`] = `
+<body>
+  <div>
+    <div
+      class="rcx-box rcx-box--full rcx-css-omrq7i"
+      id="rcx-media-call-widget-caller-info"
+    >
+      <div
+        class="rcx-box rcx-box--full rcx-css-1rtu0k9"
+      >
+        <figure
+          class="rcx-box rcx-box--full rcx-avatar rcx-avatar--x20"
+        >
+          <img
+            alt=""
+            class="rcx-avatar__element rcx-avatar__element--x20"
+            src="data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC
+              4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMj
+              IyMjIyMjIyMjIyMjIyMjL/wAARCAAoACgDASIAAhEBAxEB/8QAGwAAAgIDAQAAAAAAAAAAAAAAAAcEBgIDBQj/xAAuEAACAQQAAwcEAQUAAA
+              AAAAABAgMABAUREiExBhMUIkFRYQcWcYGhFTJSgpH/xAAYAQADAQEAAAAAAAAAAAAAAAACAwQBAP/EAB4RAAIBBQEBAQAAAAAAAAAAAAABAg
+              MREiExE0HR/9oADAMBAAIRAxEAPwBuXuIkhBuMe5ib/AHQP49q4L3mLitryTLTSpOiHQI5k/HzXa/qbFOEudVTu1dumWvcTaNCZYZ7vU6g6L
+              xqjOU/24dfs1Ouh9FnkMpd3Reeyx83hAxZZEhkdV9/MBrX71WGPvJcqrJBGveKATtuXXqNU0pu02bTHXD/AGvJAluyxxRd6F4x00o+NdKoVr
+              jbzJdvVe1t5cVLc2ck8qjnohgpPtz2v7G6JtPQ2VJwjlcw+37mchpnK6GtIuv5NFWeTsLNPvxWTvpfjvOEfwKKzEVkSct2vscS/BIzSN0YRk
+              eX81UpPqO8masJETu7OOccY4dswYFQeftv096XV5knuJGdm2T1+agvMXj8jEaHX905QihabvcbuS7X566mLWLwSY8PuRnk/u4eZ0deTl71Ef
+              6hY+0yM88TzeNZY4luYwpVYyduOfrvhPTnr0pXSX9y5mCsyJMdyxxvwq599em+taItqCSNc90ChvZRUruUcT0JiO18Elpk7t8v41LWzacxkB
+              SuvjQ/FFJayjDWrCTepAQ2vUH0oo/Jk3ovpwJJeVCP5CN+lFFaaMqy+nAyuChvrTI2kN9JAsi2ZOy4IBHMnkSCP+iqBexSWdxLazoUljJVlP
+              UH2oorkV10pRc7b1zXb/hZOzuJvM86QWEXeELxOzHSIPcmiiiunVlF2RNTpRkrs//Z"
+          />
+        </figure>
+      </div>
+      <div
+        class="rcx-box rcx-box--full rcx-css-jgzlgu"
+      >
+        <div
+          class="rcx-box rcx-box--full rcx-css-1jbbtow"
+        >
+          <span
+            class="rcx-box rcx-box--full rcx-css-ilfe77"
+          >
+            <div
+              class="rcx-box rcx-box--full rcx-css-nc7kyx"
+            >
+              Jane Doe
+            </div>
+          </span>
+        </div>
+        <div
+          class="rcx-box rcx-box--full rcx-css-1m7ucy6"
+        >
+          1234567890
+        </div>
+      </div>
+    </div>
+  </div>
+</body>
+`;
+
 exports[`renders InternalUser without crashing 1`] = `
 <body>
   <div>

diff --git a/packages/ui-voip/src/components/PeerInfo/index.ts b/packages/ui-voip/src/components/PeerInfo/index.ts
@@ -1,4 +1,5 @@
 export { default as InternalUser } from './InternalUser';
+export { default as ExternalUser } from './ExternalUser';
 export { default as PhoneNumber } from './PhoneNumber';
 export { default as PeerInfo } from './PeerInfo';
 export { type PeerInfoProps } from './PeerInfo';
diff --git a/packages/ui-voip/src/context/definitions.d.ts b/packages/ui-voip/src/context/definitions.d.ts
@@ -2,6 +2,7 @@ import type { UserStatus } from '@rocket.chat/core-typings';
 import type { CallFeature } from '@rocket.chat/media-signaling';
 
 export type InternalPeerInfo = {
+	external: false;
 	displayName: string;
 	userId: string;
 	username?: string;
@@ -11,7 +12,10 @@ export type InternalPeerInfo = {
 };
 
 export type ExternalPeerInfo = {
+	external: true;
 	number: string;
+	displayName?: string;
+	avatarUrl?: string;
 };
 
 export type ConnectionState = 'CONNECTED' | 'CONNECTING' | 'RECONNECTING';

diff --git a/packages/ui-voip/src/context/usePeekMediaSessionPeerInfo.spec.tsx b/packages/ui-voip/src/context/usePeekMediaSessionPeerInfo.spec.tsx
@@ -73,7 +73,7 @@ describe('usePeekMediaSessionPeerInfo', () => {
 				wrapper: createWrapper(instance),
 			});
 
-			expect(result.current).toEqual({ number: '+5511999999999' });
+			expect(result.current).toEqual({ external: true, number: '+5511999999999' });
 		});
 
 		it('returns internal peer info for user contact', () => {
@@ -98,6 +98,7 @@ describe('usePeekMediaSessionPeerInfo', () => {
 			});
 
 			expect(result.current).toEqual({
+				external: false,
 				displayName: 'John Doe',
 				userId: 'userId123',
 				username: 'johndoe',
@@ -131,7 +132,7 @@ describe('usePeekMediaSessionPeerInfo', () => {
 				wrapper: createWrapper(instance),
 			});
 
-			expect(result.current).toEqual({ number: '+5511999999999' });
+			expect(result.current).toEqual({ external: true, number: '+5511999999999' });
 
 			act(() => {
 				instanceState = null;
@@ -155,6 +156,7 @@ describe('usePeekMediaSessionPeerInfo', () => {
 			});
 
 			expect(result.current).toEqual({
+				external: false,
 				displayName: 'Jane Smith',
 				userId: 'userId456',
 				username: undefined,

diff --git a/packages/ui-voip/src/context/usePeerAutocomplete.spec.tsx b/packages/ui-voip/src/context/usePeerAutocomplete.spec.tsx
@@ -119,7 +119,7 @@ describe('hook', () => {
 
 	it('should return value when peerInfo has userId', () => {
 		mockGetAutocompleteOptions.mockResolvedValue([]);
-		const peerInfo: PeerInfo = { userId: 'user1', displayName: 'User 1' };
+		const peerInfo: PeerInfo = { external: false, userId: 'user1', displayName: 'User 1' };
 
 		const { result } = renderHook(() => usePeerAutocomplete(mockOnSelectPeer, peerInfo), {
 			wrapper: appRoot(),
@@ -130,7 +130,7 @@ describe('hook', () => {
 
 	it('should return undefined value when peerInfo has no userId', () => {
 		mockGetAutocompleteOptions.mockResolvedValue([]);
-		const peerInfo: PeerInfo = { number: '123456' };
+		const peerInfo: PeerInfo = { external: true, number: '123456' };
 
 		const { result } = renderHook(() => usePeerAutocomplete(mockOnSelectPeer, peerInfo), {
 			wrapper: appRoot(),
@@ -165,7 +165,7 @@ describe('hook', () => {
 				result.current.onChangeValue('rcx-first-option-123456');
 			});
 
-			expect(mockOnSelectPeer).toHaveBeenCalledWith({ number: '123456' });
+			expect(mockOnSelectPeer).toHaveBeenCalledWith({ external: true, number: '123456' });
 		});
 
 		it('should call onSelectPeer with full peer info when value matches option', async () => {
@@ -187,6 +187,7 @@ describe('hook', () => {
 			});
 
 			expect(mockOnSelectPeer).toHaveBeenCalledWith({
+				external: false,
 				userId: 'user1',
 				displayName: 'User 1',
 				avatarUrl: 'avatar.jpg',
@@ -247,7 +248,7 @@ describe('hook', () => {
 			const mockUseUserPresence = useUserPresence as jest.MockedFunction<typeof useUserPresence>;
 
 			mockGetAutocompleteOptions.mockResolvedValue([]);
-			const peerInfo: PeerInfo = { userId: 'user1', displayName: 'User 1', status: UserStatus.ONLINE };
+			const peerInfo: PeerInfo = { external: false, userId: 'user1', displayName: 'User 1', status: UserStatus.ONLINE };
 
 			mockUseUserPresence.mockReturnValue({ _id: 'user1', status: UserStatus.AWAY, statusText: '' });
 
@@ -268,7 +269,7 @@ describe('hook', () => {
 			const mockUseUserPresence = useUserPresence as jest.MockedFunction<typeof useUserPresence>;
 
 			mockGetAutocompleteOptions.mockResolvedValue([]);
-			const peerInfo: PeerInfo = { userId: 'user1', displayName: 'User 1', status: UserStatus.ONLINE };
+			const peerInfo: PeerInfo = { external: false, userId: 'user1', displayName: 'User 1', status: UserStatus.ONLINE };
 
 			mockUseUserPresence.mockReturnValue({ _id: 'user1', status: UserStatus.ONLINE, statusText: '' });
 
@@ -302,7 +303,7 @@ describe('hook', () => {
 			const mockUseUserPresence = useUserPresence as jest.MockedFunction<typeof useUserPresence>;
 
 			mockGetAutocompleteOptions.mockResolvedValue([]);
-			const peerInfo: PeerInfo = { number: '123456' };
+			const peerInfo: PeerInfo = { external: true, number: '123456' };
 
 			mockUseUserPresence.mockReturnValue({ _id: 'user1', status: UserStatus.ONLINE, statusText: '' });
 
@@ -320,7 +321,7 @@ describe('hook', () => {
 			const mockUseUserPresence = useUserPresence as jest.MockedFunction<typeof useUserPresence>;
 
 			mockGetAutocompleteOptions.mockResolvedValue([]);
-			const peerInfo: PeerInfo = { userId: 'user1', displayName: 'User 1', status: UserStatus.ONLINE };
+			const peerInfo: PeerInfo = { external: false, userId: 'user1', displayName: 'User 1', status: UserStatus.ONLINE };
 
 			mockUseUserPresence.mockReturnValue(undefined);