TalenthafenOS Dev

POST /v1/creatives/generate startet den Job (CreativeWorker). Status und Vorschau über GET /v1/creatives/get — enthält bei status: completed ein frisches image_url (signierte Storage-URL, 1 h gültig).

queued

image_url wird bei jedem Abruf von GET /creatives/get neu erzeugt (1 h).

Bild in neuem Tab öffnen

Abgeschlossene Creatives aus GET /v1/creatives/list wählen, Anweisung eingeben, dann POST /v1/creatives/edit ({ id, prompt }).

Creative (Quelle) * — Creatives laden… —

Quellbild öffnen

Bearbeitungsanweisung *

Creative bearbeiten Status aktualisieren Job-Stream öffnen

queued

Neues Creative — image_url via GET /creatives/get (1 h).

Ergebnis öffnen

Creatives aus GET /v1/creatives/list (optional include_insights=true&campaign_id=); Kennzahlen gebündelt via GET /v1/creatives/insights?campaign_id= oder einzeln creative_id= (Tabelle creative_insights, nur DB). Testdaten: POST /v1/dev/mock-creative-insights.

Ausgewähltes Creative

Von

Bis

Tage (Schnellauswahl)

Mock-Daten erzeugen

Bild öffnen

Keine Insights in der DB für dieses Creative (noch kein Meta-Sync).

Datum	Impressions	Clicks	Spend	Reach	CTR	CPM	CPC	Leads

PATCH /v1/campaigns/edit?campaign_id=… — Meta-Konto, Page, Job-Link und weitere Kampagnenfelder.

POST /v1/campaigns/publish?campaign_id=… — Lineup (includeCreativeIds / excludeCreativeIds) und Stub-Worker enqueue (202). Creatives zuerst auswählen.

POST /v1/dev/meta/import-campaign — Import in bestehenden Client (synchron).
POST /v1/dev/meta/import-bootstrap — Neuer Client aus Meta-Kampagnenname + OB + Kampagne + Meta-Import (async Worker, keine IA1–IA4-Generierung).

GET /v1/dev/meta/campaign-raw?campaign_id=… — ungefilterte Meta-Antwort (Ad Sets, Ads, Creatives).

POST /v1/dev/optimizer/run — Optimizer-Worker starten; Fortschritt über GET /v1/stream (Status + Milestones). Review nur Status in DB.

POST /v1/dev/notifications — erscheint im Client-Dashboard unter „Updates“ und wird live über GET /v1/stream (type: notification) ausgeliefert.

—

LeadTable External API v3 — Leads aus einem Zeitraum nach THOS importieren (GET /lead/campaign/{campaignID}). Meta-IDs werden wie bei Webhooks extrahiert. Erfordert LEADTABLE_API_KEY und LEADTABLE_API_EMAIL in der API-.env. Worker: LeadTableSyncWorker (leadtableSyncWorkQueue).

Bei aktiviertem Zufalls-Creative: THOS-Kampagne wählen (Fallback), damit Leads einem Creative der Kampagne zugeordnet werden.

POST /v1/dev/mock-campaign-leads — legt synthetische Leads in public.leads an (origin=dev_mock). Pro Lead wird zufällig ein Creative der gewählten THOS-Kampagne gewählt (image_generations).

public.accounts.id = auth.users.id (1:1). E-Mail kommt aus Supabase Auth; optionaler Anzeigename in accounts.display_name.

Auth-User verknüpfen

Accounts

—

Manager zuweisen

Löscht einen Client über DELETE /v1/clients/delete.

Demo-Modus setzt feste KPI-Werte auf dem Haupt-Dashboard in der App (181 Kunden, 420 Kampagnen, 100.178 € Werbebudget, 156 Einstellungen). „Time to Hire“ bleibt unverändert (37 Tage in der App). Diagramme und Listen bleiben real.

Mock-Kunden

Namen aus Meta-Kampagnen laden, durchsuchen, auswählen und bearbeiten — dann ausgewählte Mock-Clients anlegen (ohne Onboarding-Job).

Live von GET /v1/stream (globale Job-Status) und optional GET /v1/stream/{id} (Kanal-Ausgabe).