bauplatform docs

Website-Chat-Agent

Der bauplatform Website-Assistent ist ein Dialogflow CX Agent mit generativem Playbook. Er erklärt Features und kann Kontaktnachrichten (Leads) über public-gateway-function an eure Organisation senden — gleiches Muster wie der Fortschritts-Telefonagent, aber für die Product Site.

Architektur

  1. Besucher chattet über Dialogflow Messenger auf /features / /docs.
  2. Playbook beantwortet Produktfragen oder sammelt Name, E-Mail, Nachricht.
  3. Tool submit_website_lead_tool ruft public-gateway-function mit Google ID-Token auf (CAPTCHA wird übersprungen).
  4. Pub/Sub public-gateway-form-submission → gateway-service: Public Log, Topic, E-Mail an Team + Bestätigung an den Besucher.

Terraform anwenden

Variablen 
export TF_VAR_bauplatform_website_leads_organization_id="<org-uuid>"
export TF_VAR_bauplatform_website_leads_notify_email="info@bauplatform.com"
# dann terraform apply (dialog_flow_website.tf)

Outputs: dialogflow_website_leads_agent_name (für Messenger), dialogflow_website_leads_playbook_id (als Start-Playbook setzen).

Console-Schritte (einmalig)

  1. Dialogflow CX → Agent bauplatform Website Agent [TF].
  2. Start-Playbook auf bauplatform Website Generative Playbook setzen.
  3. Integration Dialogflow Messenger aktivieren / veröffentlichen.
  4. In apps/shell-webui/src/assets/product/website-chat-agent.config.js: agentId setzen und enabled: true.

Payload (Lead)

{
  "username": "Max Mustermann",
  "email": "max@firma.de",
  "telephonenumber": "+49…",
  "company": "Muster GmbH",
  "message": "Interesse an Offer Constructor Demo",
  "interest": "offer-constructor",
  "sourcePage": "/features/offer-constructor/",
  "bpOrganizationId": "<org-uuid>",
  "bpFormKind": "bauplatform_website",
  "submissionJson": "{…}"
}

Lokal testen

yarn nx run shell-webui:serve-product-site → http://localhost:4321/features/. Chat erscheint nur wenn Chat erscheint nur nach Cookie-Einwilligung (Kategorie „Funktionale Cookies / KI-Chat“) und Klick auf Chat starten. Config: enabled und agentId gesetzt.

Weiter: KI & Assistenten