Escalation Contact Card

WHAT IT DOES

Escalation Contact Card is a browser extension that automatically scans the current webpage for contact information, team member names, roles, phone numbers, email addresses, and escalation paths. It detects contact-related elements by examining class names, IDs, data attributes, and text patterns for keywords like "contact", "team", "member", "person", "owner", "escalation", "role", "phone", or "email". The extension adds a floating "save contact" button (📇) next to each detected contact element, allowing you to capture contact details, role, escalation level, and custom notes with a single click. Clicking the button opens a panel where you can review the captured information, add notes about contact preferences, response times, availability, escalation procedures, special instructions, or any other relevant details, and save it to your local database. The extension maintains a complete escalation contact database per person or role with contact history, notes, and escalation paths for each tracked contact. The main panel displays all saved contacts, showing the name, role, escalation level, entry count, and latest note. All data is stored locally in your browser using GM_setValue, ensuring your contact tracking information persists across page reloads and browser sessions. This helps DevOps teams, SRE teams, support teams, and incident response teams track escalation contacts, maintain communication paths, and document contact preferences across different services and environments.

WHERE IT RUNS

This extension runs on any webpage that displays contact information, team member details, roles, phone numbers, email addresses, or escalation paths – including team pages, organizational charts, escalation policy documents, runbooks, documentation sites, internal wikis, team directories, and any page containing contact information. The extension intelligently adapts to different page structures and supports a wide range of common contact display patterns. No manual configuration is required per site; the extension automatically detects contact elements using a flexible pattern matching system. This makes it ideal for teams managing escalation procedures, incident response contacts, and cross-team communication paths.

HOW TO USE

Simply install the extension and navigate to any webpage displaying contact information. The extension automatically detects contact elements and places a small "save contact" button (📇) next to each one. Click any of these buttons to open the contact save panel with name, role, phone, email, and escalation level pre-filled where detected. Add a note about availability, response times, special instructions, or any other relevant detail, then click "Save Contact" to store it in your local database. A floating button (👤) appears in the bottom-right corner of the page – click this to open the main panel. The main panel shows all saved contacts, sorted by most recent entry, with contact name, role, escalation level, entry count, and latest note displayed. Click any contact card to view detailed history, including all logged entries with timestamps, phone numbers, email addresses, escalation levels, and notes. Use the settings section to enable or disable auto-detection. The "Clear All Contacts" button removes all tracking data when needed.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension employs a multi-layered detection system that identifies contact information with high accuracy. First, it scans the DOM using a comprehensive set of CSS selectors targeting common contact-related class patterns, IDs, and data attributes like "contact", "team", "member", "person", "owner", "escalation", "role", "phone", and "email". Second, it uses a TreeWalker to examine text nodes for contact-related text patterns, capturing contact information that may not be wrapped in typical contact elements. The name extraction uses pattern matching with heuristics to identify person names following keywords like "name:", "contact:", or from data attributes. The role extraction identifies job titles and positions using pattern matching and common role keywords. The phone number extraction uses a flexible regex that matches various phone formats including international, national, and extension formats. The email extraction identifies email addresses using standard regex patterns and mailto: links. The escalation level extraction detects tier indicators, level numbers, and keywords like "primary", "secondary", or "on-call". Each tracked contact is assigned a unique ID based on the person name and role, ensuring that history stays correctly associated even when the same person appears in different contexts. A MutationObserver detects dynamic content updates and re-scans only when new contact elements appear, balancing real-time accuracy with system performance.

THE PANEL – DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The contact tracking panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during incident response or team coordination. The extension remembers your preferred position per website, so the panel opens in the same location each time you return to that domain. The panel supports snap-to-edge behavior – when dragged near screen edges, it gently snaps into place for a tidy workspace layout. You can collapse the panel down to just its title bar by clicking the collapse button, keeping it accessible without taking up screen space. The contact list and history are contained within a scrollable body, ensuring all content remains accessible even on smaller screens. Pressing the Escape key closes the panel instantly, returning you to your workflow.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and enabled, as it relies on BotGentz's userscript injection and GM_* API shims for cross-browser compatibility. Websites frequently update their HTML structures and class names, which may cause contact detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all contact data, contact history, timestamps, and notes exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server or third party. You are responsible for backing up your contact tracking data if you switch browsers or clear your storage. The extension does not read, modify, or interfere with any communication systems, contact directories, or site functionality – it operates solely on the static page content and stores only metadata (names, roles, contact details, and notes) that you explicitly create. Use this tool responsibly for internal team coordination and escalation tracking purposes.