Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VEXT-2.md
T

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 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