# VEXT-2 · HalloPetra-Spec erheben (API-Vertrag) | | | |---|---| | **Typ** | Setup (Externals — `typ:external`) | | **Owner** | Raffael | | **Phase** | Phase 33 (v2-P11) — Telefonie-Erweiterung (Vorlauf) | | **Cycle/Fenster** | Backlog/agil (Trigger, Ziel 2026-07-29) | | **Status** | geplant · 🟠 **block-2 (Partner-API offen, agil — Spec offen)** | > 🟠 **block-2 — Partner-API offen, agil (Spec offen):** Dies ist der Vorlauf-Task, der den Spec-Gap von HalloPetra schließt. HalloPetra kommt in **keiner Spec** vor — M12 ist eine reine AirCall-Spec. Mechanisch ist HalloPetra ein zweiter Telefonie-Provider hinter dem v1-`TelephonyProviderInterface`, inhaltlich aber unspezifiziert. Agil vorziehbar, sobald der API-Vertrag steht. ## Was zu tun Den **HalloPetra-API-Vertrag erheben** und auf das vorhandene `TelephonyProviderInterface` mappen. Konkret klären: - **Auth** (API-Key / OAuth2 / Webhook-Secret?) → für `connect` - **Webhook-Events** (welche Call-Lifecycle-Events: ringing/answered/ended/missed/voicemail?) → für `subscribeToWebhooks`/`parseWebhookEvent` - **Recording** (liefert HalloPetra eine Aufnahme-URL? Auth-Modus?) → für `getRecordingUrl` - **Call-Lifecycle** (Outbound-Trigger-Endpoint, Status-Übergänge) → für `triggerOutboundCall` - **Signaturprüfung** (Webhook-Signatur-Schema) → für `verifyWebhookSignature` Das Ergebnis ist eine kurze Vorlauf-Spec, die VR-P33 baufähig macht. Der AirCall-Adapter (v1-P15) ist die Referenz für Aufbau und Methodensatz. ## Warum / blockt Ohne den erhobenen API-Vertrag ist der HalloPetra-Adapter (VR-P33) nicht baubar — die Interface-Methoden lassen sich nicht implementieren, solange Auth/Webhook-Events/Recording/Lifecycle offen sind. Schließt einen der beiden in ROADMAP-V2 explizit benannten Specs-Gaps (neben Memberspot/Boobora). ## Abhängigkeiten - **Blocked by:** — (extern: HalloPetra-Hersteller/Vertrag) - **Blocks:** `VR-P33` (HalloPetra-Adapter — braucht den erhobenen Vertrag) - **Parallel:** v1-`TelephonyProviderInterface` + AirCall-Adapter (AK-P15a) stehen als Referenz bereit. ## Definition of Done - [ ] **HalloPetra-API-Vertrag erhoben** (Auth/Webhook-Events/Recording/Call-Lifecycle) - [ ] **auf `TelephonyProviderInterface` gemappt** (connect/triggerOutboundCall/subscribeToWebhooks/verifyWebhookSignature/parseWebhookEvent/getRecordingUrl) - [ ] Vorlauf-Spec abgelegt, VR-P33 baufähig markiert ## Quellen (granular) - `ROADMAP-V2.md` → §v2-P11 (Telefonie-Teil) + §Zwei Gaps (HalloPetra M105) + §Offene Vorlauf-Tasks #2 - `ROADMAP.md` → Phase 33 · `PHASE-SOURCES.md` → Phase 33 (M105, Block-2) - `designer-briefs/P33-telefonie-hallopetra.md` (Provider-Interface-Methodensatz, Vorlauf-Hinweis) - `_bmad-output/specs/M12-telefonie.md` (AirCall als Referenz, Provider-Pattern) - abhängig-für: `ticket-docs/VR-P33.md`