Integration · Marketing

Claude & ChatGPT mit Roster verbinden

Frage deine KI, welche Botschafter die meisten Verkäufe erzielt haben, wer sich für ein Programm beworben hat oder welche Prämien in Roster noch ausstehen. Sie kann Kontakte, Programme, Kampagnen, Bestellungen und Rabattcodes durchsuchen sowie Leistungskennzahlen und Berichte zur Umsatzzuordnung abrufen. Außerdem kann sie Kontakte und Rabattcodes erstellen, Botschafter zu einem Programm hinzufügen und den Status von Prämien festlegen.

Roster kostenlos verbinden

Kostenloser Tarif, keine Kreditkarte erforderlich. Dauert etwa eine Minute.

Fragen Sie zum Beispiel

“Welche Botschafter haben letzten Monat den meisten Umsatz erzielt?”
Die KI ruft den Bericht zur Umsatzzuordnung für diesen Zeitraum ab und listet den vermittelten Umsatz, Klicks, Neukunden und Bestellungen pro Botschafter auf.
“Wer hat sich für unser Sommerprogramm beworben und wartet noch auf eine Entscheidung?”
Sie findet das Programm und listet Bewerber mit dem Status pending auf. Für weitere Details kann sie eine Bewerbung öffnen.
“Erstelle den Code MARIA15 für Maria mit unserer 15%-Rabattregel für Botschafter.”
Sie durchsucht die Rabattregeln nach der ID der Regel, findet Marias Kontakt und erstellt den ihr zugeordneten Code.

Was Ihre KI tun kann

Botschafter und Kontakte

Kontakte suchen, finden, erstellen und aktualisieren, sie als Botschafter zu Programmen hinzufügen und Programmbewerbungen prüfen.

Verkäufe und Leistung

Bestellungen auflisten, den vermittelnden Botschafter ermitteln und Leistungskennzahlen für Programme, Kampagnen und Kontakte abrufen.

Prämien und Rabattcodes

Prämien, Geldprämien und Empfehlungsprämien auflisten, den Erfüllungsstatus festlegen und Rabattcodes erstellen oder nachschlagen.

“Wem gehört der Rabattcode SUMMER20?”
Sie schlägt den Code nach und zeigt, welchem Botschafter er gehört und welche Rabattregel er verwendet.
“Markiere diese Prämien als erfüllt und informiere die Botschafter.”
Sie setzt den Status der Prämien auf fulfilled und aktiviert notify, sodass Roster den Botschaftern eine E-Mail sendet.
“Wie läuft unsere Frühjahrskampagne?”
Sie sucht Kampagnen nach Namen, ruft die Leistungskennzahlen der Kampagne ab und listet ihre Teilnehmer auf.

29 Tools für Roster

Diese Tools werden beim Verbinden aktiviert. Sie können jedes einzelne deaktivieren oder festlegen, dass es vor der Ausführung Ihre Freigabe benötigt.

add_program_ambassadorsÄndert DatenEinen oder mehrere Kontakte (`contact_ids`) als Botschafter zu einem Programm mit `program_id` hinzufügen. Sendet ihnen möglicherweise eine E-Mail, sofern `suppress_email` nicht true ist.
create_contactÄndert DatenEinen Kontakt mit `email` und `first_name` erstellen, optional mit Nachname, Telefonnummer, Geburtsdatum, Social-Media-Nutzernamen und Tags (durch Kommas getrennt).
create_discount_codeÄndert DatenEinen Rabattcode (`code`) unter einer Rabattregel (`discount_rule_id`) erstellen und einem Botschafter (`ambassador_id`) zuordnen.
find_contactsKontakte anhand einer exakten Übereinstimmung von `email`, `instagram_handle`, `referral_link_id` oder anhand einer Liste von `contact_ids` finden.
get_accountDetails zum verbundenen Roster-Markenkonto abrufen. Damit lässt sich prüfen, in welchem Konto du arbeitest.
get_campaign_performanceLeistungskennzahlen für eine Kampagne anhand von `campaign_id` abrufen.
get_contactEinen Kontakt anhand von `contact_id` mit Profil, Tags und Social-Media-Nutzernamen abrufen.
get_contact_performanceLeistungskennzahlen für einen Kontakt anhand von `contact_id` abrufen, etwa Empfehlungen und Verkäufe.
get_orderEine Bestellung anhand der Roster-`order_id` mit Gesamtbeträgen, Bestellpositionen und Zuordnung abrufen.
get_programEin Botschafterprogramm anhand von `program_id` abrufen.
get_program_applicantEinen Programmbewerber anhand von `program_id` und `applicant_id` (Kontakt-ID) einschließlich seiner Bewerbung abrufen.
get_program_performanceLeistungskennzahlen aus dem Dashboard für ein Programm anhand von `program_id` über einen Zeitraum abrufen (standardmäßig die letzten 30 Tage).
get_referral_rewardEine Empfehlungsprämie anhand von `referral_reward_id` abrufen.
get_rewardEine Prämie anhand von `reward_id` abrufen.
get_sales_attribution_reportVermittelten Umsatz, Klicks, Neukunden und Bestellungen pro Botschafter über einen Zeitraum ausweisen, filterbar nach Programm oder Tag.
list_campaign_participantsDie Teilnehmer einer Kampagne anhand von `campaign_id` auflisten, gefiltert nach dem Teilnahmestatus `status`.
list_cash_rewardsGeldprämien auflisten, gefiltert nach Botschafter, Quelle, Status oder dem Datum, an dem sie verdient wurden.
list_ordersBestellungen auflisten, gefiltert nach Kunde, Kunden-E-Mail, Rabattcode oder Zeitraum. Damit lassen sich vermittelte Verkäufe einsehen.
list_program_ambassadorsDie Botschafter eines Programms anhand von `program_id` auflisten, optional gefiltert nach Kontakt-IDs oder Aufnahmedatum.
list_program_applicantsBewerber für ein Programm anhand von `program_id` auflisten, gefiltert nach `status` (pending, nominated, approved, rejected, removed).
list_programsBotschafterprogramme auflisten, optional gefiltert nach `status` (active, archived).
list_referral_rewardsEmpfehlungsprämien (Provision oder Punkte) auflisten, gefiltert nach Programm, Botschafter oder `reward_status` (pending, approved, paid, rejected).
list_rewardsPrämien (Produkte, Rabattcodes, Punkte, Provision) auflisten, gefiltert nach `type`, `source` oder Erfüllungsstatus `status`.
lookup_discount_codeEinen Rabattcode anhand seines Textes in `code` nachschlagen, um seinen Inhaber und seine Regel zu sehen.
search_campaignsKampagnen anhand des Namens in `query` suchen, gefiltert nach `status` oder `type`.
search_contactsKontakte (Botschafter und Kunden) per Freitext in `query` nach Namen, E-Mail-Adressen und Social-Media-Nutzernamen durchsuchen, optional mit Sortierung.
search_discount_rulesRabattregeln anhand von `query` suchen, gefiltert nach `status` oder Typ. Damit lässt sich vor dem Erstellen von Codes die ID einer Regel finden.
set_reward_statusÄndert DatenDen Erfüllungsstatus `status` (fulfilled, pending, willNotFulfill, notRedeemed) für eine oder mehrere `reward_ids` festlegen. Sendet den Botschaftern eine E-Mail, wenn `notify` true und der Status fulfilled ist.
update_contactFür andere sichtbarEinen Kontakt anhand von `contact_id` aktualisieren: Name, E-Mail-Adresse, Telefonnummer, Geburtsdatum oder Social-Media-Nutzernamen ändern sowie Tags hinzufügen oder entfernen. Nur die übergebenen Felder werden geändert.

In drei Schritten einrichten

1
App auswählen
Erstellen Sie ein kostenloses PipMCP-Konto und wählen Sie Roster aus der App-Liste.
2
Schlüssel einfügen
Füge ein privates Zugriffstoken ein. Öffne in Roster Settings → Integrations → API access und generiere ein Token. Verwende ein privates Token mit Lese- und Schreibzugriff, da öffentliche Tokens nur für wenige clientseitige Tracking-Endpunkte funktionieren.
3
Link zu Ihrer KI hinzufügen
Sie erhalten einen persönlichen MCP-Link. Fügen Sie ihn in Claude, ChatGPT oder Cursor hinzu:
1. Klicken Sie auf Ihren Namen und dann auf Einstellungen › Konnektoren › Benutzerdefinierten Konnektor hinzufügen.
2. Fügen Sie Ihren Link als URL des Remote-MCP-Servers ein.
3. Aktivieren Sie den Konnektor über das +-Menü in einem Chat.

Fragen

Was kann die KI in Roster tun?

Sie kann Kontakte, Programme, Bewerber, Botschafter, Kampagnen, Bestellungen, Prämien, Empfehlungsprämien, Geldprämien, Rabattregeln und Rabattcodes suchen und lesen sowie Leistungskennzahlen und Berichte zur Umsatzzuordnung abrufen. Sie kann Kontakte erstellen und aktualisieren, Botschafter zu Programmen hinzufügen, Rabattcodes erstellen und den Status von Prämien festlegen.

Kann die KI meine Roster-Zugangsdaten sehen?

Nein. Deine Roster-Zugangsdaten werden verschlüsselt gespeichert und der KI niemals angezeigt. Nach dem Speichern werden sie nicht erneut angezeigt, auch dir nicht. Die KI sieht nur die Ergebnisse der Tools, die sie aufruft.

Kann ich steuern, was die KI tun darf?

Ja. Du wählst aus, welche Tools aktiviert sind, und kannst zunächst nur Berichte und Abfragen erlauben. Beim Hinzufügen von Botschaftern zu einem Programm erhalten diese möglicherweise eine E-Mail. Beim Erfüllen von Prämien mit aktiviertem notify werden die Botschafter per E-Mail benachrichtigt. Deshalb kannst du für beide Aktionen vor der Ausführung deine Freigabe verlangen. Jeder Tool-Aufruf wird protokolliert.

Funktioniert das mit ChatGPT?

Ja. Gehe in ChatGPT zu Settings › Apps & Connectors › Advanced, aktiviere den Entwicklermodus und füge deinen PipMCP-Link hinzu. Der Entwicklermodus erfordert einen kostenpflichtigen ChatGPT-Tarif: Plus, Pro, Business oder Enterprise. Derselbe Link funktioniert auch in Claude (Settings › Connectors › Add custom connector), Cursor und anderen MCP-Clients.

Was kostet das?

PipMCP bietet einen kostenlosen Tarif, für den keine Kreditkarte erforderlich ist. Kostenpflichtige Tarife werden pro abgeschlossener Aufgabe abgerechnet. Du benötigst außerdem ein eigenes Roster-Konto.

Warum brauche ich ein privates statt eines öffentlichen Tokens?

Roster hat zwei Arten von Tokens. Öffentliche Tokens funktionieren nur für wenige clientseitige Tracking-Endpunkte und können daher keine Kontakte, Bestellungen oder Prämien lesen. Ein privates Token bietet den Lese- und Schreibzugriff, den die von dir aktivierten Tools benötigen.