2.8 KiB
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
TelephonyProviderInterfacegemappt (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 #2ROADMAP.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