You are here:
Customize the Billing and Usage Tab Components in Communications Service Console
Customize the FlexCards in the Billing and Usage tab to meet your business requirements.
The Billing and Usage tab is built using FlexCards that use various Integration Procedures (IPs) to fetch and save the required data.
Here's information about the FlexCards used in each section or subtab of the tab. You can customize the tab by adding or removing FlexCards or by modifying the IPs that are used as the data source by various FlexCards.
Use this information to plan your tab customizations.
| Flexcard | Data Source | Required Input | Sample Input | Used In |
|---|---|---|---|---|
| SFIBillingInquiryOverview | sfi_GetOverviewData | NA | NA | Overview subtab |
| SFIBillingInquiryOverviewBalance | sfi_GetOverviewData | NA | NA | Billing Account Details section on the Overview subtab |
| SFIBillingInquiryUsageDetailsContainer | sfi_GetUsageConsumptionData | NA | NA | Current Service Usage Details section on the Overview subtab |
| SFIBillingInquiryUsageDetailsProgressBar | sfi_GetUsageConsumptionData | NA | NA | Current Service Usage Details section on the Overview subtab |
| SFIBillingInquiryInvoiceoverview | sfi_GetOverviewData | NA | NA | Last Bill Details section on the Overview subtab |
| SFIBillingInquiryPaymentOverview | sfi_GetOverviewData | NA | NA | Last Payment Details section on the Overview subtab |
| SFIBillingInquiryUsageRecordsContainer | sfi_GetUsageRecordsData | Pagination attributes including offset and pageSize. |
|
Service Usage subtab |
| SFIBillingInquiryUsageRecordsDataTable | sfi_GetUsageRecordsData | Pagination attributes including offset and pageSize, and totalRows. | |
Service Usage subtab |
| SFIBillingInquiryInvoices | sfi_GetInvoices | NA | NA | Bills subtab |
| SFIBillingInquiryPaymentsSummary | sfi_GetPayments | NA | NA | Payments subtab |
Customize the Current Service Usage Details Section on the Overview Subtab on the Billing and Usage Tab
To customize the information in the Current Service Usage Details section, configure the sfi_GetUsageConsumptionData Integration Procedure.
| REQUIRED EDITIONS |
|---|
| Available in: Lightning Experience |
| Available in: Enterprise, Unlimited, and Developer Editions |
| REQUIRED USER PERMISSIONS | |
|---|---|
| To configure Omnistudio components: | Omnistudio Admin |
This Integration Procedure uses the TM Forum 677 API to retrieve information about a billing account's service usage.
-
Configure the request path that retrieves the real consumption data.
- In the sfi_GetUsageConsumptionData Integration Procedure, go to the TransformUsageConsumptionData section.
- Expand the SEND/RESPONSE TRANSFORMATIONS section.
- In Send JSON Path, replace the default value with your customized remote action.
- Save your changes.
-
Configure the counter types associated with your usage plans.
- In the sfi_GetUsageConsumptionData Integration Procedure, go to the UsageConsumptionConfig section.
-
In the Element Value Map section, add counter types as comma separated values.
The default counter type is
used.For example, you can set the counter types as sms and voice:"counterType": "sms,voice". - Save your changes.
-
Configure thresholds for your counter types.
- In the sfi_GetUsageConsumptionData Integration Procedure, go to the UsageConsumptionConfig section.
- Click Edit as JSON.
-
Add your required objects, each with a threshold and a color node.
With thresholds, you can provide your service agents with a visual representation of data.For example, green can suggest that the customer used less than 50% of the minutes allocated to them in their plan, and red can indicate that the customer exceeded their data plan limit.Here's the default configuration:
"thresholds": [ { "threshold": 74, "color": "#2E844A" }, { "threshold": 99, "color": "#FCC003" }, { "threshold": 100, "color": "#BA0517" } ] - Save your changes.
Customize the Service Usage Subtab on the Billing and Usage Tab in Communications Service Console
To customize the Service Usage subtab, configure the sfi_GetUsageRecordsData Integration Procedure.
| REQUIRED EDITIONS |
|---|
| Available in: Lightning Experience |
| Available in: Enterprise, Unlimited, and Developer Editions |
| REQUIRED USER PERMISSIONS | |
|---|---|
| To configure Omnistudio components: | Omnistudio Admin |
This Integration Procedure uses the TM Forum 635 API to retrieve service usage records.
-
Configure the request path that retrieves the service usage records.
- In the sfi_GetUsageRecordsData Integration Procedure, go to the TransformUsageRecordsData section.
- Expand the SEND/RESPONSE TRANSFORMATIONS section.
- In Send JSON Path, replace the default value with your customized remote action.
-
Modify the mock TM Forum 635 API data.
- In the sfi_GetUsageRecordsData Integration Procedure, go to the UsageRecordsStub section.
- Expand the RESPONSE TRANSFORMATIONS section.
- In Response JSON Path, replace the default value with your customized remote action.
-
Customize the maximum number of service usage records retrieved at a time.
By default, 20 records are retrieved.
- In the sfi_GetUsageRecordsData Integration Procedure, go to the UsageRecordsResponse section.
- Expand the ADDITIONAL OUTPUT RESPONSE section.
- Update UsageRecordsCount with your custom API response count.
Customize Options for Your Service Agents to View and Download Bills
Configure the SFIBillingInquiryInvoices Flexcard to customize file types for bills.
| REQUIRED EDITIONS |
|---|
| Available in: Lightning Experience |
| Available in: Enterprise, Unlimited, and Developer Editions |
| REQUIRED USER PERMISSIONS | |
|---|---|
| To configure Omnistudio components: | Omnistudio Admin |
-
Update the
commsBillingInquiryActionMenuItemsLightning Web Component (LWC) in the SFIBillingInquiryInvoices Flexcard:For information on how to edit Flexcards, see FlexCards Versioning and Cloning.-
Click the
commsBillingInquiryActionMenuItemsLWC. - Click the Properties tab.
-
In the Attributes section, update the value of the documentTypeMapping attribute.
With the default configuration, your service agents can view and download bills in the PDF, CSV, HTML, and Text formats.
{ "PDF": "application/pdf", "CSV": "text/csv", "HTML": "text/html", "Text": "text/plain" }
-
Click the
- Save your changes.
Your service agents can view and download bills in your customized formats.

