Wann nutze ich Portal, API oder Hosted Pages?

Die tebio Plattform bietet mit dem tebio Business-Portal, der API und den Hosted Pages drei verschiedene Zugangswege.

Dieser Artikel dient als Entscheidungshilfe, um für verschiedene Anwendungsfälle und Integrationsszenarien den passenden Zugang oder die beste Kombination auszuwählen.

Kurzentscheidung

Situation	Empfohlener Zugang
Ein interner Benutzer soll einen Vorgang manuell bearbeiten	Business-Portal
Ein Kunde soll selbst bestellen oder Daten verwalten	Hosted Pages
Ein externes System soll Daten automatisch übertragen	API
Ein eigenes Frontend soll tebio im Hintergrund nutzen	API
Ein Prozess soll schnell ohne eigene Entwicklung bereitgestellt werden	Hosted Pages
Ein Support- oder Finance-Team soll Vorgänge prüfen	Business-Portal

Wann nutze ich das tebio Business-Portal?

Das tebio Business-Portal eignet sich besonders, wenn Aufgaben manuell, fachlich oder operativ bearbeitet werden sollen.

Nutzen Sie das Portal zum Beispiel, wenn Sie:

Kunden oder Subscriptions einzeln verwalten möchten
Produkte und Optionen konfigurieren möchten
Rechnungen prüfen oder nachvollziehen möchten
Zahlungen, Gutschriften oder Erstattungen nachvollziehen möchten
Helpdesk-Tickets bearbeiten möchten
Einstellungen und Vorlagen pflegen möchten
Vertriebspartner verwalten möchten
Ereignisverläufe oder Dokumente einsehen möchten

Das Portal ist der richtige Einstieg für Business-User, Operations, Customer Care, Finance und Produktmanagement.

Wann nutze ich die API?

Die API eignet sich besonders, wenn Prozesse automatisiert oder mit anderen Systemen verbunden werden sollen.

Typische API-Anwendungsfälle sind:

Kunden aus einem CRM-System erstellen oder aktualisieren
Bestellungen aus einem eigenen Checkout an tebio übergeben
Subscriptions aus einem externen System synchronisieren
Nutzungsdaten für Usage-based Billing übermitteln
Rechnungen und Zahlungsstatus in ein ERP-System übertragen
Dokumente abrufen
Webhook-Events auswerten
eigene Portale oder Apps auf tebio Daten aufbauen

Die API ist der richtige Zugang für Entwickler, Integrationspartner und technische Teams.

Wann nutze ich Hosted Pages?

Hosted Pages eignen sich besonders, wenn Kunden, Vertriebspartner oder Affiliate-Partner selbst Prozesse ausführen sollen, ohne dass Sie dafür ein komplett eigenes Frontend entwickeln möchten.

Nutzen Sie Hosted Pages zum Beispiel, wenn Sie:

Bestellseiten im eigenen Branding bereitstellen möchten
ein Self-Care / Kundenportal ohne eigenes Frontend nutzen möchten
Vertriebspartnerprozesse digitalisieren möchten
Affiliate Pages bereitstellen möchten
Zahlungsmethoden, Einwilligungen oder Kundendaten erfassen möchten

Hosted Pages sind der richtige Zugang, wenn Kunden, Vertriebspartner oder Affiliate-Partner mit tebio-Prozessen interagieren sollen, die Oberfläche aber bereitgestellt werden soll.

Typische Kombinationsmuster

Häufig ist die beste Lösung eine Kombination der Zugänge.

Portal zuerst, API später

Viele Unternehmen starten mit dem tebio Business-Portal, um Produkte, Kunden, Subscriptions und Rechnungen manuell zu verwalten. Wenn Prozesse später wachsen oder stärker automatisiert werden sollen, kann die API ergänzt werden.

Dieses Muster eignet sich für Unternehmen, die schnell starten möchten und Integrationen schrittweise aufbauen.

API für Automatisierung, Portal für Kontrolle

Bei diesem Muster werden Kunden, Bestellungen oder Subscriptions automatisch über die API erstellt. Business-User verwenden das Portal, um Vorgänge zu prüfen, Ausnahmen zu bearbeiten oder Supportfälle zu klären.

Dieses Muster eignet sich für Unternehmen mit bestehenden CRM-, ERP-, Shop- oder Backend-Systemen.

Hosted Pages für Kunden, Portal für Backoffice

Bei diesem Muster nutzen Kunden Hosted Pages für Bestellungen, Self-Service oder Datenänderungen. Das Backoffice verwaltet die daraus entstehenden Prozesse im tebio Business-Portal.

Dieses Muster eignet sich für Unternehmen, die kundennahe Prozesse digitalisieren möchten, ohne ein eigenes Frontend vollständig selbst zu entwickeln.

Hosted Pages und API kombinieren

Hosted Pages können kunden- oder partnerseitige Prozesse abbilden, während die API externe Systeme über Ergebnisse informiert oder zusätzliche Daten synchronisiert.

Dieses Muster eignet sich, wenn Unternehmen schnell nutzbare Oberflächen benötigen, aber dennoch eine tiefe technische Integration in bestehende Systeme wünschen.

Partnerprozesse mit Hosted Pages und Portal

Vertriebspartner können über Partnerseiten, Affiliate Pages oder Vertriebspartnerportale in Prozesse eingebunden werden. Business-User verwalten Partner, Kunden, Subscriptions und Provisionsprozesse im Portal.

Dieses Muster eignet sich für Reseller-, Affiliate- oder mehrstufige Vertriebsmodelle.

Entscheidungshilfe

Frage	Empfohlener Zugang
Soll ein Business-User den Vorgang manuell bearbeiten?	tebio Business-Portal
Soll ein externes System den Vorgang automatisch auslösen?	API
Soll ein Kunde oder Vertriebspartner den Vorgang selbst ausführen?	Hosted Pages
Soll ein Prozess im eigenen Frontend stattfinden?	API
Soll schnell eine bereitgestellte Oberfläche im eigenen Branding genutzt werden?	Hosted Pages
Soll ein Vorgang geprüft, korrigiert oder nachvollzogen werden?	tebio Business-Portal
Soll ein Ereignis oder Status an externe Systeme gemeldet werden?	Webhook oder API

Rolle von Webhooks

Webhooks ergänzen die API, indem sie externe Systeme automatisch über Ereignisse informieren.

Während die API aktiv aufgerufen wird, sendet ein Webhook eine Benachrichtigung an eine vorkonfigurierte URL, sobald ein relevantes Ereignis eintritt.

Typische Ereignisse sind:

Kunde wurde erstellt oder aktualisiert
Subscription erstellt, geändert oder gekündigt
Bestellung erfasst oder verarbeitet
Rechnung erstellt
Zahlung wurde verarbeitet
Dokument erzeugt
Helpdesk-Ticket aktualisiert

Webhooks sind besonders nützlich, wenn externe Systeme zeitnah auf Änderungen in der tebio Plattform reagieren sollen.

Best Practices

Klare Systemverantwortung festlegen

Legen Sie früh fest, welches System führend für welche Daten ist. Zum Beispiel kann ein CRM-System führend für Kundendaten sein, während tebio führend für Subscriptions, Rechnungen und Zahlungen ist.

Portal und API nicht gegeneinander planen

Das Portal und die API sind keine Alternativen im engeren Sinn. Häufig ist die beste Lösung eine Kombination: Die API automatisiert Standardprozesse, das Portal unterstützt Kontrolle, Ausnahmen und manuelle Bearbeitung.

Hosted Pages für standardisierte externe Prozesse nutzen

Wenn Kunden oder Vertriebspartner Prozesse selbst ausführen sollen, sind Hosted Pages oft schneller und robuster als ein komplett eigenes Frontend. Ein eigenes Frontend ist sinnvoll, wenn Nutzerführung, Design oder Produktlogik vollständig individuell gesteuert werden sollen.

Ereignisse und Webhooks früh berücksichtigen

Bei Integrationen sollten Webhooks früh eingeplant werden. Sie helfen dabei, externe Systeme über Änderungen zu informieren und manuelle Synchronisation zu vermeiden.

Häufige Missverständnisse

Ist das tebio Business-Portal nur ein Admin-Frontend?

Nein. Das tebio Business-Portal ist die zentrale Arbeitsoberfläche für Business-User. Es dient nicht nur der Administration, sondern auch der operativen Bearbeitung von Kunden, Subscriptions, Bestellungen, Rechnungen, Zahlungen, Helpdesk-Tickets und Vertriebspartnern.

Muss ich die API nutzen, um mit tebio zu starten?

Nein. Viele Funktionen können direkt im tebio Business-Portal genutzt werden. Die API ist vor allem dann relevant, wenn Prozesse automatisiert oder externe Systeme integriert werden sollen.

Ersetzen Hosted Pages eine eigene Website oder ein eigenes Frontend?

Nicht vollständig. Hosted Pages bilden bestimmte Prozesse wie Bestellungen, Self-Care / Kundenportal oder Partnerprozesse ab. Eine öffentliche Marketing-Website, individuelle Produktseiten oder vollständig eigene Nutzerführung können weiterhin außerhalb von tebio umgesetzt werden.

Können Portal, API und Hosted Pages parallel genutzt werden?

Ja. Das ist sogar ein häufiger Anwendungsfall. Die drei Zugänge können kombiniert werden und arbeiten mit denselben zentralen Plattformdaten.