mirror of
https://github.com/lingble/chatwoot.git
synced 2025-11-01 03:27:52 +00:00
This PR delivers the first slice of the voice channel: inbound call handling. When a customer calls a configured voice number, Chatwoot now creates a new conversation and shows a dedicated call bubble in the UI. As the call progresses (ringing, answered, completed), its status updates in real time in both the conversation list and the call bubble, so agents can instantly see what’s happening. This focuses on the inbound flow and is part of breaking the larger voice feature into smaller, functional, and testable units; further enhancements will follow in subsequent PRs. references: #11602 , #11481 ## Testing - Configure a Voice inbox in Chatwoot with your Twilio number. - Place a call to that number. - Verify a new conversation appears in the Voice inbox for the call. - Open it and confirm a dedicated voice call message bubble is shown. - Watch status update live (ringing/answered); hang up and see it change to completed in both the bubble and conversation list. - to test missed call status, make sure to hangup the call before the please wait while we connect you to an agent message plays ## Screens <img width="400" alt="Screenshot 2025-09-03 at 3 11 25 PM" src="https://github.com/user-attachments/assets/d6a1d2ff-2ded-47b7-9144-a9d898beb380" /> <img width="700" alt="Screenshot 2025-09-03 at 3 11 33 PM" src="https://github.com/user-attachments/assets/c25e6a1e-a885-47f7-b3d7-c3e15eef18c7" /> <img width="700" alt="Screenshot 2025-09-03 at 3 11 57 PM" src="https://github.com/user-attachments/assets/29e7366d-b1d4-4add-a062-4646d2bff435" /> <img width="442" height="255" alt="Screenshot 2025-09-04 at 11 55 01 PM" src="https://github.com/user-attachments/assets/703126f6-a448-49d9-9c02-daf3092cc7f9" /> --------- Co-authored-by: Muhsin <muhsinkeramam@gmail.com>
162 lines
3.8 KiB
JavaScript
162 lines
3.8 KiB
JavaScript
import { computed, unref } from 'vue';
|
|
|
|
const CALL_STATUSES = {
|
|
IN_PROGRESS: 'in-progress',
|
|
RINGING: 'ringing',
|
|
NO_ANSWER: 'no-answer',
|
|
BUSY: 'busy',
|
|
FAILED: 'failed',
|
|
COMPLETED: 'completed',
|
|
CANCELED: 'canceled',
|
|
};
|
|
|
|
const CALL_DIRECTIONS = {
|
|
INBOUND: 'inbound',
|
|
OUTBOUND: 'outbound',
|
|
};
|
|
|
|
/**
|
|
* Composable for handling voice call status display logic
|
|
* @param {Ref|string} statusRef - Call status (ringing, in-progress, etc.)
|
|
* @param {Ref|string} directionRef - Call direction (inbound, outbound)
|
|
* @returns {Object} UI properties for displaying call status
|
|
*/
|
|
export function useVoiceCallStatus(statusRef, directionRef) {
|
|
const status = computed(() => unref(statusRef)?.toString());
|
|
const direction = computed(() => unref(directionRef)?.toString());
|
|
|
|
// Status group helpers
|
|
const isFailedStatus = computed(() =>
|
|
[
|
|
CALL_STATUSES.NO_ANSWER,
|
|
CALL_STATUSES.BUSY,
|
|
CALL_STATUSES.FAILED,
|
|
].includes(status.value)
|
|
);
|
|
const isEndedStatus = computed(() =>
|
|
[CALL_STATUSES.COMPLETED, CALL_STATUSES.CANCELED].includes(status.value)
|
|
);
|
|
const isOutbound = computed(
|
|
() => direction.value === CALL_DIRECTIONS.OUTBOUND
|
|
);
|
|
|
|
const labelKey = computed(() => {
|
|
const s = status.value;
|
|
|
|
if (s === CALL_STATUSES.IN_PROGRESS) {
|
|
return isOutbound.value
|
|
? 'CONVERSATION.VOICE_CALL.OUTGOING_CALL'
|
|
: 'CONVERSATION.VOICE_CALL.CALL_IN_PROGRESS';
|
|
}
|
|
|
|
if (s === CALL_STATUSES.RINGING) {
|
|
return isOutbound.value
|
|
? 'CONVERSATION.VOICE_CALL.OUTGOING_CALL'
|
|
: 'CONVERSATION.VOICE_CALL.INCOMING_CALL';
|
|
}
|
|
|
|
if (s === CALL_STATUSES.NO_ANSWER) {
|
|
return 'CONVERSATION.VOICE_CALL.MISSED_CALL';
|
|
}
|
|
|
|
if (isFailedStatus.value) {
|
|
return 'CONVERSATION.VOICE_CALL.NO_ANSWER';
|
|
}
|
|
|
|
if (isEndedStatus.value) {
|
|
return 'CONVERSATION.VOICE_CALL.CALL_ENDED';
|
|
}
|
|
|
|
return 'CONVERSATION.VOICE_CALL.INCOMING_CALL';
|
|
});
|
|
|
|
const subtextKey = computed(() => {
|
|
const s = status.value;
|
|
|
|
if (s === CALL_STATUSES.RINGING) {
|
|
return 'CONVERSATION.VOICE_CALL.NOT_ANSWERED_YET';
|
|
}
|
|
|
|
if (s === CALL_STATUSES.IN_PROGRESS) {
|
|
return isOutbound.value
|
|
? 'CONVERSATION.VOICE_CALL.THEY_ANSWERED'
|
|
: 'CONVERSATION.VOICE_CALL.YOU_ANSWERED';
|
|
}
|
|
|
|
if (isFailedStatus.value) {
|
|
return 'CONVERSATION.VOICE_CALL.NO_ANSWER';
|
|
}
|
|
|
|
if (isEndedStatus.value) {
|
|
return 'CONVERSATION.VOICE_CALL.CALL_ENDED';
|
|
}
|
|
|
|
return 'CONVERSATION.VOICE_CALL.NOT_ANSWERED_YET';
|
|
});
|
|
|
|
const bubbleIconName = computed(() => {
|
|
const s = status.value;
|
|
|
|
if (s === CALL_STATUSES.IN_PROGRESS) {
|
|
return isOutbound.value
|
|
? 'i-ph-phone-outgoing-fill'
|
|
: 'i-ph-phone-incoming-fill';
|
|
}
|
|
|
|
if (isFailedStatus.value) {
|
|
return 'i-ph-phone-x-fill';
|
|
}
|
|
|
|
// For ringing/completed/canceled show direction when possible
|
|
return isOutbound.value
|
|
? 'i-ph-phone-outgoing-fill'
|
|
: 'i-ph-phone-incoming-fill';
|
|
});
|
|
|
|
const bubbleIconBg = computed(() => {
|
|
const s = status.value;
|
|
|
|
if (s === CALL_STATUSES.IN_PROGRESS) {
|
|
return 'bg-n-teal-9';
|
|
}
|
|
|
|
if (isFailedStatus.value) {
|
|
return 'bg-n-ruby-9';
|
|
}
|
|
|
|
if (isEndedStatus.value) {
|
|
return 'bg-n-slate-11';
|
|
}
|
|
|
|
// default (e.g., ringing)
|
|
return 'bg-n-teal-9 animate-pulse';
|
|
});
|
|
|
|
const listIconColor = computed(() => {
|
|
const s = status.value;
|
|
|
|
if (s === CALL_STATUSES.IN_PROGRESS || s === CALL_STATUSES.RINGING) {
|
|
return 'text-n-teal-9';
|
|
}
|
|
|
|
if (isFailedStatus.value) {
|
|
return 'text-n-ruby-9';
|
|
}
|
|
|
|
if (isEndedStatus.value) {
|
|
return 'text-n-slate-11';
|
|
}
|
|
|
|
return 'text-n-teal-9';
|
|
});
|
|
|
|
return {
|
|
status,
|
|
labelKey,
|
|
subtextKey,
|
|
bubbleIconName,
|
|
bubbleIconBg,
|
|
listIconColor,
|
|
};
|
|
}
|