Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/EXT-08.md
T

2.0 KiB

EXT-08 · AirCall-Konto + API + Webhooks (kein Sandbox — an P15 gekoppelt)

Typ Setup (External)
Owner Raffael
Cycle/Fenster direkt vor P15-Bau (AK-P15a, start 2026-06-30) · fällig 2026-06-30
Status geplant (erst kurz vor P15 ausführen)

Wichtig: AirCall hat KEINE Sandbox (geprüft 2026-06-21)

Offizielle AirCall-Doku: „Currently, Aircall does not offer a dedicated sandbox environment for testing." Anders als Stripe/Google/PandaDoc gibt es kein gratis Sandbox-Testen:

  • Getestet wird im echten/Trial-Account mit Test-Usern + Test-Nummern (als „TEST" labeln, danach löschen).
  • Test-Nummern + Seats kosten ggf. Geld → mit AirCall-Account-Manager Konditionen klären.
  • AirCall-Trial = nur 7 Tage → läuft lange vor P15 ab, wenn man jetzt auf Vorrat anlegt.

→ Konsequenz: NICHT jetzt auf Vorrat aufsetzen. Konto + Test-Nummern + API-Key + Webhooks direkt vor dem P15-Bau (AK-P15a, ab 2026-06-30) anlegen, damit keine ungenutzten Nummern bezahlt werden.

Was zu tun ist (kurz vor P15)

  • AirCall-Konto (Trial oder bezahlt) anlegen; falls nötig Test-Nummer(n) buchen (kostenpflichtig).
  • API-Key (api_id/api_token, Basic-Auth) erzeugen, in Coolify-Env (staging/prod) hinterlegen.
  • Webhooks konfigurieren (Call-Events/Click-to-Dial) auf staging-api/api, HMAC-Signaturprüfung + Rate-Limit.

Warum / was es blockt

Telefonie-Integration (Call-Events, Click-to-Dial) braucht API-Zugang + Webhooks.

  • Blocks: P15 (Telefonie, AK-P15a)

Abhängigkeiten

  • blocked-by: — (aber bewusst an P15-Timing gekoppelt; kostenpflichtig, daher Just-in-time)
  • blocks: P15 (AK-P15a)

Definition of Done

  • AirCall-Konto + (ggf. kostenpflichtige) Test-Nummer(n)
  • API-Key in Coolify-Env (staging/prod)
  • Webhooks konfiguriert (HMAC + Rate-Limit)

Hinweis

„Sandbox" aus dem alten Ticket-Titel gestrichen — existiert bei AirCall nicht. Quelle: AirCall Help Center „Aircall Sandbox" + developer.aircall.io.