55 lines
3.4 KiB
Markdown
55 lines
3.4 KiB
Markdown
# Designer-Brief · P33 — Telefonie-Erweiterung (HalloPetra)
|
|
|
|
**Phase:** 33/34 · **Modul:** M105 · **Owner-Dev:** Raffael (VR-P33) · **Designer:** David (D-Telefonie-Erw.)
|
|
**Aktive Quellen:** zugehörige Ticket-Docs · `ROADMAP.md`/`ROADMAP-V2.md` · `REQUIREMENTS.md` · `ENTITY-MODEL.md`.
|
|
**Subframe:** Pflicht je Route. Setup-/Binding-Flächen + Call-Session-Detail.
|
|
|
|
> ✅ **VEXT-2 geschlossen (01.08.2026):** HalloPetra wird per API-Key verbunden; ein manueller
|
|
> `post_call`-Webhook liefert abgeschlossene Inbound-Anrufe. Es gibt im erhobenen Vertrag keinen belegten
|
|
> Outbound-Trigger, keine Provider-User-Ressource und keine garantierte Recording-URL. AirCall bleibt daher
|
|
> der Cold-Calling-Provider; HalloPetra nutzt Click-to-Call als `tel:`-Fallback. Voicemail-Transkription
|
|
> entfällt nach AD-26.
|
|
|
|
## Was dieses Modul tut (Kurzfassung)
|
|
|
|
Bindet HalloPetra als zusätzlichen Provider hinter dem bestehenden `TelephonyProviderInterface` an — ohne Kern-Umbau. Eingehende Webhooks werden auto-gematcht (auf Contact/Lead/Projekt), landen im Activity-Stream und triggern Automationen (`call.*`). Click-to-Call, Inbound und Logging bleiben providerunabhängig: E.164-Normalisierung, Match-Confidence, Notiz-Editor. Aus Tenant-Sicht ist HalloPetra einfach eine weitere wählbare Telefonie-Anbindung neben AirCall.
|
|
|
|
## Benötigte Screens
|
|
|
|
| Screen [Route] | Kern-Inhalt | Archetyp |
|
|
|---|---|---|
|
|
| Telefonie-Setup [`/:tenant/settings/integrations/telephony`] | Provider-Connect (HalloPetra API-Key neben AirCall OAuth), Verbindungs-Test, einmalige HalloPetra-Webhook-Konfiguration | A6 + Connect |
|
|
| User-Bindings [im Telefonie-Setup] | AirCall-User ↔ Telefonie-Nummer/-Account; für HalloPetra mangels Provider-User-Ressource ausgeblendet | A2/A6 |
|
|
| Call-Session-Detail [`/:tenant/calls/:id`] | Anruf-Daten (Richtung, Dauer, Provider, Match auf Contact/Lead/Projekt, Match-Confidence), optionaler Aufnahme-Link, Notiz-Editor | A3 |
|
|
|
|
*(Click-to-Call ist ein Quick-Action-Element auf Contact/Lead/Projekt-Detail-Views aus v1 — providerunabhängig, kein neuer Screen.)*
|
|
|
|
## Geplante Features (muss abgedeckt sein)
|
|
|
|
- [ ] HalloPetra-Adapter implementiert `TelephonyProviderInterface` ohne Kern-Änderung
|
|
- [ ] Webhook-Auto-Match auf Contact/Lead/Projekt → Activity + Automation-Trigger (`call.*`)
|
|
- [ ] Click-to-Call + Inbound + Logging providerunabhängig (E.164-Normalisierung, Match-Confidence, Notiz-Editor)
|
|
- [ ] Provider-Auswahl/-Wechsel im Setup (HalloPetra neben AirCall)
|
|
- [ ] Recording-Abruf über `getRecordingUrl` (sofern HalloPetra-API liefert)
|
|
- [ ] ⚠ Vorlauf-Spec (API-Vertrag) vor Bau erheben
|
|
|
|
## Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
|
|
|
|
Provider-Auswahl/-Connect-Karte (HalloPetra inbound/AirCall Cold Calling), maskierte API-Key-/OAuth-Eingabe,
|
|
Verbindungs-Test mit Status, einmalig sichtbare Webhook-URL + `Authorization`-Header, AirCall-Binding-Liste,
|
|
Call-Session-Detail (Richtung/Dauer/Status/Provider), Match-Anzeige mit Confidence-Indikator, optionaler
|
|
Aufnahme-Link, Notiz-Editor, Click-to-Call-Quick-Action und Klartext-States.
|
|
|
|
## Davids Delta (David füllt aus)
|
|
|
|
- [ ] Überschriebene/geänderte Spec-Punkte:
|
|
- [ ] Neue UI/UX-Entscheidungen:
|
|
- [ ] Subframe-Screen-Link(s):
|
|
- [ ] Offene Fragen an Dev:
|
|
|
|
## Dev-Nachzug (wir nach Davids Delta)
|
|
|
|
- [ ] Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
|
|
- [ ] REQUIREMENTS/ROADMAP nachgezogen:
|
|
- [ ] Plane-Ticket (VR-P33) aktualisiert:
|