Der Assistent liest in Raynet, wer ihm schreibt: den Kontakt und das Unternehmen, Geschäftsfälle, Angebote und Bestellungen sowie Aktivitäten. In Raynet schreibt er nie. Was er genau lesen darf, legen Sie für jedes Postfach einzeln fest. Wie Anbindungen in draften allgemein funktionieren, beschreibt die Seite Integrationen.
Was Sie brauchen
- Raynet mit dem Tarif PROFESSIONAL oder höher – der Tarif START hat keine API-Schlüssel.
- Eine Instanz auf app.raynet.cz (tschechischer Server). Instanzen auf dem slowakischen oder den internationalen Servern von Raynet (
app.raynetcrm.sk,eu.raynetcrm.com,app.raynetcrm.com) lassen sich nicht anbinden. - Einen Administrator von Raynet – nur er legt Nutzer und API-Schlüssel an.
- In draften den Inhaber oder einen Manager der Organisation.
In Raynet
Raynet hat keinen reinen Leseschlüssel: Ein API-Schlüssel hat immer die Rechte des Nutzers, zu dem er gehört. Legen Sie deshalb für den Assistenten einen eigenen Nutzer mit einer reinen Leserolle an. Geben Sie den Schlüssel keinem Administrator – ein Administrator sieht und darf alles.
Ein Nutzer nur zum Lesen
- Klicken Sie oben rechts auf Ihren Namen → Nastavení (Einstellungen).
- Öffnen Sie im Menü links Uživatelské účty (Nutzerkonten) und fügen Sie einen Nutzer hinzu (Přidat uživatele – Nutzer hinzufügen; in der kostenpflichtigen Version zuerst Přidat další uživatelské účty – weitere Nutzerkonten hinzufügen – und dann Přiřadit uživatele – Nutzer zuweisen). Füllen Sie aus:
- den Namen, z. B.
draften, - die Anmelde-E-Mail – merken Sie sie sich, draften braucht sie,
- die Rolle Jen ke čtení (nur Lesen).
Jeder Nutzer ist in Raynet eine kostenpflichtige Lizenz.
- den Namen, z. B.
- Soll ein bestehender Nutzer verwendet werden: Uživatelské účty → öffnen Sie sein Profil → Oprávnění uživatele (Berechtigungen des Nutzers) → ändern Sie die Rolle auf Jen ke čtení und speichern Sie.
- Optional schränken Sie ein, welche Datensätze der Nutzer sieht: Nastavení → Bezpečnostní úrovně (Sicherheitsstufen) → Přidat úroveň (Stufe hinzufügen), benennen Sie sie und wählen Sie den Nutzer.
API-Schlüssel
- Nastavení → im Menü links im Abschnitt PRO VÝVOJÁŘE (für Entwickler) → API klíče (API-Schlüssel).
- Klicken Sie auf Nový API klíč (neuer API-Schlüssel). Füllen Sie im Fenster Vytvořit API klíč (API-Schlüssel erstellen) aus:
- Název klíče (Name des Schlüssels) – z. B.
draften, - Uživatel (Nutzer) – den Nutzer nur zum Lesen aus dem vorigen Schritt. Der Schlüssel liest mit seinen Berechtigungen.
- Název klíče (Name des Schlüssels) – z. B.
- Kopieren Sie den Schlüssel sofort – nach dem Speichern zeigt Raynet ihn nicht mehr an. Klicken Sie dann auf Vytvořit API klíč.
Name der Instanz
Klicken Sie oben rechts auf Ihren Namen → O aplikaci Raynet CRM (Über Raynet CRM); dort steht der Name der Instanz. Er ist zugleich der Teil der Adresse nach app.raynet.cz/ – bei der Adresse https://app.raynet.cz/firma ist es firma.
In draften
- Öffnen Sie Organisation → Integrationen und füllen Sie in der Karte Integrationen aus:
- System – Raynet CRM,
- Name – z. B.
Raynet – Vertrieb, - Name der Instanz – aus dem vorigen Schritt,
- Nutzer (E-Mail) – die Anmelde-E-Mail des Nutzers nur zum Lesen,
- Zugangsgeheimnis – den API-Schlüssel.
Klicken Sie auf Anbindung hinzufügen. Der Schlüssel wird verschlüsselt gespeichert und nie wieder angezeigt.
- Öffnen Sie in der Zeile der Anbindung das Menü ⋯ → Verbindung testen. Nach einem Moment erscheint „Verbindung in Ordnung (…), Konto …“. Darf der Nutzer etwas nicht lesen, listet der Test es unter „Mit diesem Token nicht verfügbar:“ auf.
- Klicken Sie im Abschnitt Welche Postfächer die Anbindung nutzen dürfen bei einem Postfach auf Erteilen, haken Sie an, was der Assistent lesen darf, und klicken Sie auf Berechtigung speichern:
- Kontakt und Unternehmen,
- Geschäftsfälle und darunter Beträge,
- Angebote und Bestellungen,
- Aktivitäten und darunter Beschreibung und Lösung von Aktivitäten.
- Der Bearbeiter des Assistenten fügt dann in den Einstellungen des Assistenten → Wissen eine Quelle der Art externes System hinzu und wählt, was der Assistent tatsächlich liest – siehe Ein CRM und andere Systeme anbinden.
Wenn Sie den Schlüssel austauschen, tragen Sie den neuen bei der Anbindung unter Neues Zugangsgeheimnis ein und klicken Sie auf Ersetzen; danach wieder Verbindung testen.
Fehler beim Verbindungstest
Die Meldung des Tests ist englisch, direkt von Raynet oder von draften:
| In der Meldung | Was das bedeutet | Was zu tun ist |
|---|---|---|
the user name or the API key was refused (401) | Raynet hat die E-Mail oder den Schlüssel nicht angenommen | prüfen, dass die E-Mail die Anmelde-E-Mail des Nutzers ist, dem der Schlüssel gehört, und den Schlüssel neu eintragen |
the user of the API key may not read this (403) | der Nutzer des Schlüssels darf nicht lesen | Rolle und Sicherheitsstufe des Nutzers prüfen |
Raynet rate limit reached (429) | das tägliche Limit an API-Aufrufen ist ausgeschöpft | später erneut versuchen; das Limit legt Raynet je nach Tarif fest |
Raynet needs the instance name (letters, digits, dashes) | der Name der Instanz fehlt oder enthält ungültige Zeichen | den Namen der Instanz aus O aplikaci Raynet CRM übernehmen |
Raynet answered HTTP … | eine andere Antwort von Raynet | den Namen der Instanz prüfen und erneut versuchen |