40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
# 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.
|