WhatsApp BSP-Migration auf 360dialog

Warum

Onboarding neuer Kunden via Meta-Direct ist Krampf: Meta Business Manager, Phone-Number-Verify, App Review (1-3 Wochen), Tech-Provider-Antrag, Webhook-Hosting. 360dialog (Berliner BSP) abstrahiert das hinter API + Embedded-Signup. Ziel: „API-Call + Kunde klickt 3x → WABA live” statt aktuell „zwei Wochen Meta-UI-Tanz pro Kunde”.

Erster Auftakt: Icking (Dachhandwerk, will WhatsApp-AI fuer Kundenanfrage → Angebot → Buchung → Lager), zweiter Kunde nach Friseur im Sueden. „Es ist immer das gleiche” → Productizing-Move auf receptionist-Plattform mit zweitem Vertical-Adapter.

Detail-Recherche: _index

Endzustand

• mcp-whatsapp multi-tenant gegen 360dialog Cloud API (Base-URL + Auth via per-Tenant API-Key aus DDB)
• Direct-Meta-Pfad als Fallback erhalten (Friseur laeuft zunaechst weiter direkt)
• Onboarding-Page onboarding.agenticventures.de mit Integrated Embedded Signup (ab Partner-Plan)
• Receptionist-Customer-Config in receptionist-customers DDB erweitert um provider: meta-direct | 360dialog + provider_credentials_secret_arn
• Vertical-Adapter dachhandwerk (icking) baut auf receptionist auf, analog hairdresser (friseur)

Phasen

Phase 0 — Compliance + Eval (deutlich schneller als gedacht)

[Update 2026-05-18] DPA ist oeffentlich downloadbar in Docs (4 EN + 2 DE PDFs), keine Email-Schleife noetig. Plus Local-Storage-Setting EU(Germany) pro Phone-Number ist DSGVO-Gold.

• DPA-PDFs von Legal Information runterladen + lesen (DE-Version), 4 Punkte pruefen: Vertragspartner, Sub-Prozessor-Liste, SCC-Klauseln, Server-Standort des 360dialog-Hub-Layers
• Nur falls Server-Standort im DPA fehlt: gezielte Email an legal@360dialog.com mit dieser einen Frage (kein Open-Ended-Fragenkatalog)
• Direct-Client-Sandbox-Account 360dialog anlegen (kein Partner-Plan-Commit)
• Sandbox-WABA mit Test-Nummer aufsetzen, Test-Nachricht senden via curl, Webhook-Empfang testen
• Local-Storage-Setting auf „EU (Germany)” pruefen — als Onboarding-Default fuer alle Customers festlegen
• Exit-Kriterium: DPA gelesen + akzeptabel ODER 1 offene Frage geklaert, plus Sandbox-Smoke gruen

Phase 1 — mcp-whatsapp Multi-Provider-Refactor (0.5-1 Tag)

• WhatsappTransport-Interface einziehen mit zwei Implementierungen: MetaDirectTransport, Dialog360Transport
• Auswahl per Env-Var WHATSAPP_PROVIDER=meta|360dialog (initial), spaeter per-Tenant aus DDB
• Auth-Helper an Transport binden (Bearer vs D360-API-KEY-Header)
• Phone-Number-ID nur bei Meta-Direct im Path, bei 360dialog nicht
• Unit-Test fuer beide Transports (Mock-HTTP)
• Integration-Test gegen 360dialog-Sandbox (Phase-0-Sandbox)
• Exit-Kriterium: Test-Nachricht ueber 360dialog-Transport erfolgreich raus, Inbound im Inbox-Table

Phase 2 — Icking als erster 360dialog-Tenant (Pilot)

• Icking-Onboarding manuell: 360dialog Direct-Client-Account fuer Icking, WABA + Phone-Number, API-Key generieren
• API-Key in AWS Secrets Manager: receptionist/tenant/icking/360dialog-api-key
• Receptionist-Customer-Config-Schema erweitern um provider + provider_credentials_secret_arn
• Brain-Lambda anpassen: pro Tenant das richtige Secret laden + an mcp-whatsapp-Tool-Call mitgeben
• Vertical-Adapter dachhandwerk skizzieren: was sind die Tools? (list_services, request_quote, check_stock, book_appointment?). Pairing-Call mit Icking noetig zur Tool-Liste.
• System-Prompt-Template lambdas/receptionist-brain/prompts/dachhandwerk.md
• Smoke: End-Kunde sendet WA an Icking-Nummer → Brain antwortet
• Exit-Kriterium: Icking-Pilot live, mindestens 5 End-to-End-Conversations dokumentiert

Phase 3 — Partner-Plan + Integrated Onboarding (Path C, parallel zu Phase 1-2)

Trigger-Update 2026-05-18 (Brainstorm-Sequencing Path C): Trigger gelockert von „Kunde 2 unterschrieben” auf „heisser Lead in 4-6 Wochen + Partner-Antrag laeuft parallel”. Begruendung: Antrag kostet nichts bis Aktivierung, Bauzeit Onboarding-Page = ~3-4 Wochen, deckt sich mit Lead-3-Closing-Fenster. Lead-3-Pitch profitiert von „Self-Service-Onboarding kommt in 4 Wochen”-Story. €500/Mo Partner-Plan-Cost faellt erst bei Vertragsaktivierung an, also rechtzeitig vor Lead-3-Go-Live.

Bedingungen die jetzt gelten:

1. Heisser Lead 3 in aktiver Verhandlung (Stand 2026-05-18: gegeben)
2. Phase 1 (mcp-whatsapp Refactor) abgeschlossen vor Partner-Hub-Cutover
3. Partner-Vertrag erst signen wenn Lead 3 ≥80% Closing-Wahrscheinlichkeit

Direct-Client bleibt fuer Icking bis Partner-Hub live (Migration Direct→Hub = 1 Tag Arbeit, Phone-Number-Portierung nicht zero-downtime — bei Icking-Anforderungen OK, bei Friseur waere es nicht so). Vorteile Partner-Plan: Reseller-Billing (eigene Rechnung mit Marge), Channel-Lizenz €25 statt €49, Partner Hub + API, Self-Hosted Embedded Signup auf eigener Domain, Partner-led Business Verification (Meta-Verification fuer Kunden uebernehmen).

• Pre-Trigger-Check: sind alle drei Bedingungen erfuellt? Sonst Phase 3 verschieben.
• Partner-Plan Growth bei 360dialog abschliessen
• Bestehende Direct-Client-Channels migrieren auf Partner-Hub (Migration-Doc 360dialog)
• Onboarding-Page onboarding.agenticventures.de (Next.js, Cloudflare-Pages oder im av-website-Repo) mit Self-Hosted-Embedded-Signup
• Partner-API-Integration: client_id via POST /partners/{pid}/clients anlegen, Webhook bei Channel-Aktivierung → AWS Secrets Manager auto-populate, Customer-Config-Eintrag in receptionist-customers automatisch
• Onboarding-Flow-Doc fuer Sales (was muss Kunde mitbringen, was passiert)

Phase 4 — Friseur-Migration auf 360dialog (optional, wenn Partner-Plan steht)

• Phone-Number-Portierung von Direct-Meta zu 360dialog-Channel (Down-Time 30-60 Min kalkulieren)
• Tenant-Config umstellen provider: meta-direct → 360dialog
• Direct-Meta-Pfad in mcp-whatsapp behalten als Resilienz-Hedge (kein Decommission)

Sequencing (Path C, beschlossen im Brainstorm 2026-05-18)

Logik: Bauzeit Phase 3 ist ~3-4 Wochen + 1-2 Wochen Partner-Antrag-Vorlauf. Wenn beides parallel startet, ist Phase 3 ready wenn Lead 3 unterschreibt. €500/Mo Partner-Plan-Risiko ist 0 bis Vertragsaktivierung — Antrag stellen kostet nur Zeit.

Verworfene Sequencing-Alternativen:

• Path A (alles jetzt aktivieren): spart 1-2 Wochen, aber €500-1000 Cost-Risiko bei Lead-3-Drop-out
• Path B (plan-original, erst nach Lead-3-Signed bauen): sicher, aber Lead-3-Pitch leidet unter „2 Wochen Setup”-Story

Naechster Schritt

1. Partner-Antrag bei 360dialog stellen (Email an partner@360dialog.com, Antrag-Form auf https://hub.360dialog.com/partner-signup) — faellig diese Woche
2. mcp-whatsapp Multi-Provider-Refactor starten (siehe Phase 1, eh noetig — 0.5-1 Tag)
3. Implementierungs-Plan fuer Phase 3 via /plan direkt im Anschluss

Faellig: 2026-05-20

Wirtschaft

Bei Margenrechnung: Wenn jeder Kunde €100-300/Mo zahlt fuer Receptionist-Service, sind €575/Mo Fixkosten ab 3 Kunden tragbar. Erst bei <€200/Customer-ARPU wird Partner-Plan zur Last.

Risiken

• AV-Antwortzeit von 360dialog unbekannt — koennte Phase 1 verzoegern. Mitigation: parallel Sandbox testen, AV blockt nur Production-Go-Live.
• Server-Standort nicht EU → Notausgang noetig (eigenes Hosting). Erwartung aber EU.
• Phone-Number-Portierung Meta→360dialog ist Standard-Prozess aber nicht zero-downtime. Bei Friseur mit Audit-Trail-Anforderung sorgfaeltig planen.
• Meta-Policy-Aenderungen koennen jederzeit BSPs treffen — Direct-Meta-Pfad als Fallback erhalten, kein Decommission.

Related

• Plattform: receptionist
• MCP: whatsapp + Repo mcp-whatsapp
• Customer 1 (Friseur, bleibt erstmal Meta-Direct): _index
• Customer 2 (Icking, neuer Vertical „dachhandwerk”): _index
• Hosting-Pattern: mcp-hosting-fargate-tunnel
• Trigger nach Abschluss Phase 1: ChannelTransport-Verallgemeinerung + Voice als zweiter Channel — Brainstorm 2026-05-18 2026-05-18-multi-channel-receptionist-requirements.md. Receptionist-Roadmap-Abschnitt roadmap—multi-channel referenziert hierher zurueck.