Postfach (Kommunikationszentrale)

Ein abgespecktes Ticketsystem im Kundenportal: Studios beantworten WhatsApp, Facebook Messenger und Instagram Direct an einer Stelle. Dahinter steht derselbe Bot-Motor wie beim Website-Chatbot („Bot zuerst, Mensch übernimmt“), der Mensch kann jederzeit übernehmen. Renés Idee vom 28.08.2026. Technisch ist SIM Tech Provider mit einer eigenen Meta-App „SIM Postfach“, Kunden schließen WhatsApp per Embedded Signup an und sehen nie einen Token.

• Schritte 1 bis 3 live seit 28.08. (Hub v0.239.0 bis v0.242.0): Webhook mit Signaturprüfung, Portal-Seite /portal/postfach, Senden über die Cloud API mit 24-h-Fenster, Vorlagen, Medien-Download, Bot hinter der Studio-Nummer, Kundenakte-Karte, Datenlösch-Seite /datenloeschung, Testzugang meta-review@ (Portal-Konto auf SimGym).
• SimGym ist der Testkunde (Test-WABA, Kanal bot_zuerst); WhatsApp-Durchstich am 28.08. bestanden.
• 14.09. (Hub v0.298.1 bis v0.298.4): „Seite und Instagram verbinden“ scheiterte am Code-Tausch (Meta-Fehler 36008). Umbau auf eigenen OAuth-Dialog über /portal/postfach/meta-start und meta-rueckkehr (Commit db68b2c von Tobias), Netzwerkfehler-Retry (5be623b). Der erste echte Lauf kam sauber zurück, der Tausch scheiterte an einem Netz-Aussetzer des Hosts.
• 16.09. (v0.311.0): WhatsApp-Einstieg ohne Kennung in der Nachricht, Bot kommt bei neuem Einstieg zurück.
• 04.10. (v0.359.0 und v0.359.1): Nach „WhatsApp verbinden“ reicht der Hub die 15 Standard-Vorlagen selbst bei Meta ein; Checkliste für Studios und Ablaufliste für uns. Laut Auskunft von Tobias (04.10.) ist die App im Live-Modus, von der Schnittstelle aus nicht prüfbar.
• Für fremde Studios ist nur WhatsApp freigegeben; Messenger und Instagram erst nach Review Stufe 2 (sechs Berechtigungen, nie eingereicht).
• Offen im Meta-Dashboard am 28.08.: Review Stufe 1 war nicht eingereicht (Videos fehlten). Aktueller Review-Stand: prüfen.

• René Pilotstudio für den ersten echten Durchlauf nennen (der Dialog eines fremden Studios ist noch nie gelaufen).
• René Knopf „Seite und Instagram verbinden“ für fremde Studios ausblenden, bis Stufe 2 frei ist (Vorschlag).
• René AVV-Ergänzung, Löschfrist, Datenschutz-Baustein, Modulpreis.
• Partner Tobias Gerlach: Knopf „Seite und Instagram verbinden“ erneut als meta-review@ durchlaufen (erwartet „Verbunden: messenger studios in motion“), danach Video für die Berechtigung business_management (Stand 14.09., ob erledigt: prüfen).
• René /Partner: Review Stufe 2 (Pages und Instagram) und Tech-Provider-Freischaltung („Ohne Partner onboarden“ erscheint erst nach Freigabe), Stand prüfen.
• ich Schritt 4 laut Konzept: Portal-Push (fehlt grundsätzlich), Zuweisung, Schnellantworten, KI-Vorschlag, Sprachnachrichten transkribieren (später).
• ich Handover-Protokoll Messenger und Instagram nach Freigabe.

• 2026-08-28: Zwei Meta-Apps: SIM PostAgent (Instagram Login, Postiz) und SIM Postfach (Facebook Login). Eigenbau im Hub statt Chatwoot. Bestehendes verifiziertes Portfolio „Studios in motion“ behalten.
• 2026-08-28: Entscheidung 10: Bot zuerst, Mensch übernimmt, Start bei SimGym. Sprachnachrichten transkribieren ja, aber später.
• Renés Facebook-Profil ist seit 04.07.2023 dauerhaft eingeschränkt (kann keine Werbeassets oder Personen verwalten). Die Meta-Klickstrecke macht Tobias Gerlach (Mitarbeiter).
• Meta verbietet allgemeine KI-Assistenten auf der Plattform (seit 15.01.2026), ein studio-spezifischer Service-Bot ist erlaubt; Übergabe an Menschen ist Pflicht.
• ⛔ Kosten: Antworten im 24-h-Fenster sind kostenlos (Metas Preisseite, 04.10.2026 geprüft). Die frühere Notiz „ab 01.10.2026 kostenpflichtig“ war falsch. Kosten nur für selbst angestoßene Vorlagen (Größenordnung rund 5 Cent Service, rund 12 Cent Werbung).
• Webhook in Meta gespeichert heißt nicht Zustellung: beim Onboarding je Studio zwingend POST /{WABA}/subscribed_apps.
• Bei Meta-Status-Webhooks nie nur die Nachrichten-ID als Dedupe-Schlüssel (Statusupdates teilen sie).
• Geheimnisse (App-Secret, Systemnutzer-Token) nur in der .env und im Passwortmanager, nicht im Wiki.

1. 04.10.2026
   Standard-Vorlagen automatisch (d8d3ec5, Hub v0.359.0), Onboarding-Checkliste (100c398, v0.359.1). Falsche Kosten-Notiz korrigiert.
2. 16.09.2026
   WhatsApp-Einstieg überarbeitet, Hub v0.311.0 (f91f976).
3. 14.09.2026
   Seite und Instagram verbinden: Fix-Reihe v0.298.1 bis v0.298.4, Mail an Tobias.
4. 28.08.2026
   Abschluss-Stand: Meta-Dashboard geklärt, Review nicht eingereicht, Hub v0.243.2 (6876386), Wiedervorlage #11.
5. 28.08.2026
   Schritt 3 (Bot, Medien, Kundenakte), Hub v0.242.0 (ace9f0d). Schritt 2 (Verbinden, Datenlöschung), v0.240.0 (a09621f). Schritt 1 (Portal-Postfach), v0.239.0 (43ea2e9). Webhook v0.238.0 (6c3d054).
6. 28.08.2026
   Tobias fertig mit der Meta-Seite (App 1805084404268982, Test-WABA, Konfigurationen), Secrets abgelegt, WhatsApp-Webhook aktiv, erster Durchstich 11:49 UTC.
7. 28.08.2026
   Konzept, Anleitungen für Tobias, Ursache der Meta-Kontosperre geklärt.

• Code: /root/sim-ops/hub/src/postfach.ts, postfachCore.ts, metaPostfach.ts, metaPostfachCore.ts, anlassVorlagen.ts (vorlagenAutoLauf()); Portal-Skript portal-postfach.js.
• Tabellen: postfach_kanaele (u. a. bot_modus, vorlagen_auto), postfach_unterhaltungen, postfach_nachrichten, postfach_roh_events, postfach_eingang, postfach_vorlagen.
• Routen: Webhook manage.sim-tools.cloud/webhook/meta-postfach, Rückkehr /portal/postfach/meta-rueckkehr, Start /portal/postfach/meta-start, /datenloeschung; Admin GET /api/postfach/webhook-status, GET /api/postfach/eingang?html=1, POST /api/customers/<kunde>/postfach/vorlagen-auto.
• Umgebungsvariablen: META_POSTFACH_APP_ID, META_POSTFACH_VERIFY_TOKEN, META_POSTFACH_APP_SECRET, META_POSTFACH_SYSTEM_USER_TOKEN in /root/sim-ops/.env; Schlüsselsammlung /root/transfer/keys/meta-apps-2026-08.txt (nicht öffnen oder weitergeben).
• Meta: App SIM Postfach 1805084404268982, Test-WABA 104758912668074, Portfolio „Studios in motion“ 283271965394438.
• Unterlagen und Konzepte: /root/transfer/kommunikationszentrale/; Wiki 40-Projekte/Postfach Stand und To-Dos.md (lebende Seite), Kommunikationszentrale Postfach.md; Skill /postfach-meta für den Wiedereinstieg.
• Hilfe: hub/hilfe/whatsapp-anschluss.kunde.md, hub/hilfe/postfach.admin.md (Info-Knopf an der Karte Postfach der Kundenakte).