Entwicklerintegration

Venanto auf Kundenseiten einbinden ohne Umwege.

Nutzen Sie das Web-Widget, das WordPress-Plugin oder die REST-API. API-Schlüssel bleiben in Ihrem Backend; WordPress nutzt Connect Venanto, während eigene Browser-Widgets widerrufbare Installationsschlüssel verwenden.

API-Schlüssel erstellen OpenAPI JSON

Schnellauswahl

Wählen Sie die kleinste Integration, die den Zweck erfüllt.

Statische oder eigene Website Aufwand: Mittel

Erzeugen Sie einen Installationsschlüssel, fügen Sie ein Script-Tag ein und testen Sie anschließend über die Live-Domain.

Am besten, wenn Ihr Team den Website-Code bearbeiten und die exakte Live-Domain freigeben kann.

<script src="https://venanto.com/static/widget.js" data-bot-id="BOT_ID" data-install-key="YOUR_INSTALL_KEY"></script>

WordPress Aufwand: Einfach

Installieren Sie das Plugin, klicken Sie in den WordPress-Einstellungen auf Connect Venanto, melden Sie sich an und wählen Sie den Assistenten für die Website.

Am besten, wenn der Kunde WordPress-Adminzugang hat und möglichst wenige manuelle Schritte möchte.

https://venanto.com/static/downloads/vilrio-chat.zip?v=0.2.6

Eigene App oder Backend Aufwand: Fortgeschritten

Bewahren Sie den API-Schlüssel serverseitig auf und rufen Sie `/api/v1/chat` aus Ihrem eigenen Dienst auf.

Am besten, wenn ein Entwickler Auth, Serveraufrufe, Logging und Rollout-Tests verantwortet.

Authorization: Bearer YOUR_VILRIO_KEY

We set it up for you Difficulty: None for you

Hand it over with a setup request — FAQ cleanup, theme matching, hosting access, cPanel, SSH, or private system work.

Am besten, wenn der Kunde Launch-Hilfe braucht oder der Zugriffsweg nicht standardisiert ist.

Console > Channels > Setup request

Web-Widget

Einen begrenzten Installationsschlüssel erzeugen.

Use an API key from Console > Tools. `allowed_origin` should be the exact browser origin that will host the widget.

curl -X POST https://venanto.com/api/v1/install-keys \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": 123,
    "label": "Main website",
    "allowed_origin": "https://www.example.com"
  }'

Die Antwort enthält einen einmaligen Installationsschlüssel, das Widget-Snippet und die Script-URL für eigene Websites.

WordPress

Nutzen Sie das Plugin, wenn möglichst wenige bewegliche Teile gewünscht sind.

Laden Sie `vilrio-chat.zip` aus der Konsole oder unter `/static/downloads/vilrio-chat.zip?v=0.2.6` herunter.
Laden Sie es unter WordPress-Plugins hoch und aktivieren Sie anschließend `Venanto Chat`.
Open Settings > Venanto Chat and click `Connect Venanto`.
Melden Sie sich bei Venanto an, wählen Sie den Bot für diese Website und kehren Sie zu WordPress zurück.
Wählen Sie Titel, Akzentfarbe, Vorschläge und ob sich der Chat automatisch öffnet.
Senden Sie auf der Live-Seite eine Testnachricht und prüfen Sie die Installationsaktivität in Venanto.

Manuelle Verbindungsfelder bleiben im Plugin nur als erweiterte Fallback-Option verfügbar.

REST API

Backend-Chat nutzt denselben Bot, dasselbe Wissen, dieselben Tools und dieselbe Audit-Historie.

Bevorzugen Sie `Authorization: Bearer YOUR_VILRIO_KEY`. Bestehende Serverintegrationen können auch `X-Venanto-Api-Key: YOUR_VILRIO_KEY` senden. Erstellen Sie den engsten Schlüssel, der zur Integration passt.

curl -X POST https://venanto.com/api/v1/chat \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": 123,
    "message": "What are your hours?",
    "external_user_ref": "customer-42"
  }'

Endpunkt	Verwendung
GET /api/v1/integration-guide	Maschinenlesbare Quickstart-Metadaten.
GET /api/v1/bots	Bot-IDs im Arbeitsbereich finden.
POST /api/v1/install-keys	Einen begrenzten Installationsschlüssel für eine eigene Website erstellen.
POST /api/v1/chat	Backend-gesteuerte Chatnachrichten senden.
POST /api/v1/knowledge	Text, FAQ, Richtlinien oder Serviceinhalte indexieren.
POST /api/v1/answer-test	Vor dem Launch prüfen, welche Quellabschnitte eine Anfrage beantworten.

Verfügbare API-Berechtigungen umfassen Bot-Suche, Erstellung von Installationsschlüsseln, Chat, Wissensupdates und Antworttests.

Wissen

Zuerst indexieren, dann Antworten testen, danach veröffentlichen.

curl -X POST https://venanto.com/api/v1/knowledge \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": 123,
    "title": "Service FAQ",
    "content": "Emergency requests should be handed to staff immediately.",
    "source_type": "api"
  }'

curl -X POST https://venanto.com/api/v1/answer-test \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bot_id":123,"query":"What happens in an emergency?"}'

Sicherheitsgrenze

Halten Sie mächtige Zugangsdaten von Browsern fern.

API-Schlüssel nur auf Servern verwenden

Venanto-API-Schlüssel können Bots auflisten, chatten, Wissen indexieren und Installationsschlüssel erstellen. Liefern Sie sie nicht in JavaScript, WordPress oder mobilen Apps aus.

Installationsschlüssel für öffentliche Flächen verwenden

Installationsschlüssel sind auf einen Bot begrenzt und können an einen Origin gebunden, nachverfolgt und widerrufen werden, ohne den Konto-API-Schlüssel zu rotieren.

Setup help has a clear scope

Theme matching, knowledge preparation, hosting access, and custom CRM work are handled as a setup request with a defined scope and price up front.

Keine Secrets in Setup-Formularen senden

Nutzen Sie Formulare für Zugriffsmethode und nicht geheime Kontextinformationen. Passwörter, private Zugangsdaten und Zugriffscodes benötigen eine separate sichere Übergabe.