← Back to projects

Intranet / Telephony

Connecting the phonebook and phone system.

The telephone module connects a shared phonebook with the phone system’s call history. It matches different number formats to contacts while keeping the original number, phonebook value and callback format separate.

Intranet / TelephonySample data

Call history · Example

  • Example contact AIncoming · 0+49 …
  • Example contact BOutgoing · +49 …
  • No contact matchMissed · +49 …
Example contact AContact matched
Original
0+49 …
Phonebook
+49 …
Callback
Phone-system format

Keep the original. Derive the right value for each purpose.

  1. Exact matchCompare cleaned values
  2. Canonical matchReconcile number formats
  3. Legacy fallbackReject ambiguous aliases
Schematic illustration with masked example values. No real contacts or call records. The callback format depends on the phone system’s rules.

The problem

One number, several formats

The phone system and phonebook represent the same number differently. A single transformed value does not serve display, contact matching and redial equally well.

The decision

Each value has a purpose

The original value is preserved. A dedicated matcher derives suitable phonebook and callback values, prioritizing precise matches over legacy mapping rules.

The result

Consistent mapping in the history

The initial view and later refreshes use the same processing. A contact can be matched while the original value from the phone system remains visible.

The decisions behind it

1. Prefer precise matches

Lookup checks exact numbers first, then canonical formats, then legacy aliases. Country codes are retained. Ambiguous legacy fallback matches are not automatically assigned to a contact.

2. Use the right contact context

Call history is loaded for the signed-in user’s extension. Contact matching considers personal, global and accessible department contacts.

3. Refresh without changing meaning

History refreshes periodically, with overlapping refresh requests prevented. Filters distinguish incoming, outgoing and missed calls. An unanswered outgoing call is not treated as a missed incoming call.

Tech stack

Symfony · Doctrine DBAL · Twig · Stimulus · Phone-number matching · Phone-system integration

This module belongs to the same internal Symfony intranet as the manufacturing workflow and the other modules shown here.