Customer Service

Generate embeddable self-service widgets for customer portals (reduces call center load by 30-40%)

Generate embeddable self-service widgets that dramatically reduce call center load and improve customer satisfaction. Business Impact: 30-40% reduction in support calls = 450-600 min/month saved = 4,800-6,600 €/year savings per 100 monthly support requests.

8 Widget Types:

  1. installation_lookup: Find installation by address or postal code

    • Use case: "Where is my solar system registered?"
    • Reduces: 25% of lookup calls

  2. installation_overview: Quick info dashboard for customer

    • Shows: MaStR number, capacity, commissioning date, grid operator
    • Reduces: 30% of "What are my installation details?" calls

  3. operator_change_wizard: Step-by-step operator change guide

    • Use case: House purchase, inheritance, company restructuring
    • Reduces: 40% of operator change calls (most complex process)
    • Provides: Checklist, deadlines, required documents, forms

  4. storage_calculator: Storage worthiness check

    • Inputs: PV capacity, consumption, electricity price
    • Output: ROI calculation, payback period, optimal storage size
    • Drives: Upsell opportunities (storage retrofit)

  5. eeg_end_helper: Post-EEG guidance (after 20 years)

    • CRITICAL for installations ≥18 years old!
    • Options: Full feed-in (market price), self-consumption, direct marketing
    • Regulatory: EEG 2023 changes, market value calculation

  6. faq_embedded: Top 10 frequently asked questions

    • Auto-answers: "Can I increase capacity?", "How to change operator?", "What if my system breaks?"
    • Reduces: 15-20% of routine questions

  7. contact_finder: Find VNB, BNetzA, Finanzamt by postal code

    • Shows: Contact details, opening hours, online portals, forms
    • Reduces: "Who is responsible for...?" calls

  8. document_templates: Download forms (operator change, capacity increase, decommissioning)

    • Self-service: No waiting for email/post
    • Reduces: Document request calls

Display Modes:

  • compact (300x400px): Sidebar widget
  • full: Full-page integration
  • modal: Popup overlay (triggered by button)
  • embedded: Inline integration in page flow

Integration:

  • HTML/CSS/JavaScript snippet (copy-paste ready)
  • iframe or Web Component
  • REST API for custom implementations
  • Responsive design (mobile-friendly)
  • Light/dark theme support
  • Multi-language (de/en)

Business Benefits:

  • 24/7 availability (no waiting for callback)
  • Instant answers (higher customer satisfaction)
  • Reduced peak-time call center load (mornings, Mondays)
  • Scalable (serves unlimited customers simultaneously)
  • Measurable impact (track widget usage vs. call reduction)

ROI Example:

  • Before: 100 support calls/month @ 15 min/call = 1,500 min/month
  • After: 60-70 calls/month (30-40% self-service) = 900-1,050 min/month
  • Savings: 450-600 min/month = 7.5-10 hours/month
  • Cost savings: 4,800-6,600 €/year (assuming 40 €/hour loaded labor cost)
  • Customer satisfaction: +15-25% (instant help vs. callback wait)
post/api/customer-service/portal-widget

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/customer-service/portal-widget
  • Auth: none declared

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

widgetType'installation_lookup' | 'installation_overview' | 'operator_change_wizard' | 'storage_calculator' | 'eeg_end_helper' | 'faq_embedded' | 'contact_finder' | 'document_templates' required

Type of widget to generate

mode'compact' | 'full' | 'modal' | 'embedded'

Display mode

theme'light' | 'dark' | 'auto'
language'de' | 'en'
outputFormat'html' | 'json' | 'markdown'

Output format for the widget

mastrNummerstring

Optional: MaStR number for personalized widgets

postalCodestring

Optional: Customer postal code for location-based help

installationAgenumber

Optional: Installation age in years

maxHeightnumber

Maximum widget height in pixels

includeBrandingboolean
includeContactCTAboolean
tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "widgetType": "installation_lookup",
  "mastrNummer": "SEE123456789012",
  "postalCode": "80331",
  "installationAge": 18
}

Response

Successful response

object required

Changes

No recorded changes to this operation across all 2 revisions of this API.