# Raynet CRM: Anbindung

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](/de/admin/integrations).

## 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

1. Klicken Sie oben rechts auf Ihren Namen → **Nastavení** (Einstellungen).
2. Ö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.
3. 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.
4. 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

1. **Nastavení** → im Menü links im Abschnitt **PRO VÝVOJÁŘE** (für
   Entwickler) → **API klíče** (API-Schlüssel).
2. 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.
3. **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

1. Ö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.
2. Ö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.
3. 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**.
4. 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](/de/connecting-a-crm).

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 |