> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Freshsales

> Verbinden Sie Freshsales mit einem API-Schlüssel und einem Bundle-Alias mit Iru Compliance, um Benutzerrollen, Berechtigungsmatrizen und gebietsbasierte Zugriffskontrollen zu erfassen.

### Über Freshsales

Iru liest **Benutzer mit ihren Rollen**, **Rollen mit Berechtigungen**, **Gebiete** und **Berechtigungen auf Feldebene für sensible Daten** aus der Freshsales-API (Freshworks CRM). Die Authentifizierung erfolgt mit einem **API-Schlüssel** zusammen mit Ihrem **Bundle-Alias**; beide finden Sie unter **Profile Settings** → **API Settings**. Anfragen richten sich an `https://YOUR_BUNDLE_ALIAS.myfreshworks.com/crm/sales/api`. Der Connector-Assistent fragt zuerst den **API-Schlüssel** und dann den **Bundle-Alias** ab.

Freshsales und **Freshservice** sind unterschiedliche Produkte mit **unterschiedlichen Authentifizierungsverfahren**. Wenn Sie Daten aus dem IT-Service-Management verbinden, verwenden Sie stattdessen den Artikel [Freshservice](/de/compliance/sources/freshservice-source).

### So funktioniert es

```http theme={null}
Authorization: Token token=YOUR_API_KEY
```

Freshsales verwendet **weder** Basic Auth noch ein Bearer-Präfix. Der Schlüssel wird im `Authorization`-Header in der wörtlichen Form `Token token=YOUR_API_KEY` übergeben. Die API ist **nicht versioniert**. Es gibt keinen Versions-Header und keine datierte Revision.

Der **Bundle-Alias** legt fest, welches CRM-Konto gelesen wird, wenn Ihre Freshworks-Organisation mehr als eines besitzt. Deshalb ist das Feld erforderlich. Ein API-Schlüssel gilt **pro Benutzer** und übernimmt **genau die Rolle dieses Benutzers**, ohne Scopes pro Endpunkt.

| Detail | Wert |
| - | - |
| **Kategorie** | CRM |
| **Authentifizierung** | Token (API-Schlüssel + Bundle-Alias) |

Offizielle Referenzen: [Freshworks CRM API](https://developers.freshworks.com/crm/api/).

### Voraussetzungen

* Ihr **Bundle-Alias** und Ihr **API-Schlüssel**, beide auf derselben Seite **API Settings**.
* Ein **dedizierter CRM-Benutzer mit Administratorrechten**, mit dem der Schlüssel generiert wird. Der Schlüssel übernimmt die Rolle dieses Benutzers und hat keine Scopes; ein Schlüssel eines Vertriebsbenutzers mit Gebietseinschränkungen liefert daher ein unvollständiges Bild der Berechtigungen.

### Freshsales mit Iru verbinden

<Tabs>
  <Tab title="Freshsales">
    <Note>
      Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
    </Note>

    <Steps>
      <Step title="Bei Freshsales anmelden">
        Melden Sie sich bei Ihrem Freshsales-Konto als der **Benutzer mit Administratorrechten** an, dessen Zugriff die Integration übernehmen soll.
      </Step>

      <Step title="Profile Settings öffnen">
        Wählen Sie Ihr **Profilbild** in der oberen rechten Ecke und dann **Profile Settings**.
      </Step>

      <Step title="API Settings öffnen">
        Wählen Sie die Registerkarte **API Settings**.
      </Step>

      <Step title="API-Schlüssel und Bundle-Alias kopieren">
        Kopieren Sie den unter **Your API key** angezeigten Wert. Kopieren Sie den **Bundle alias**, der auf derselben Registerkarte direkt unter dem API-Schlüssel angezeigt wird. Auch wenn Ihre Organisation nur ein CRM-Konto hat, ist dieser Wert erforderlich.
      </Step>
    </Steps>

    <Note>
      Fahren Sie auf der Registerkarte [**Iru Compliance**](#iru-compliance) fort.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst die Registerkarte [**Freshsales**](#freshsales) ab.
    </Note>

    <Steps>
      <Step title="Quellen öffnen">
        Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Linke Navigation: Compliance erweitert, Sources ausgewählt" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Freshsales aktivieren">
        Suchen Sie **Freshsales** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Möglicherweise öffnet sich ein Browser-Tab oder -Fenster für den Connector-Assistenten.
      </Step>

      <Step title="API-Schlüssel eingeben">
        Der erste Schritt des Assistenten ist **Enter API Key (Authorization)**. Fügen Sie den API-Schlüssel in das Feld **Authorization** ein. Der Assistent zeigt das Header-Format `Token token=<api_key>` an.
      </Step>

      <Step title="API-Schlüssel übermitteln">
        Wählen Sie **API-Schlüssel senden**.
      </Step>

      <Step title="Bundle-Alias eingeben">
        Geben Sie nur den **Bundle-Alias** ein (zum Beispiel `acme`, nicht die vollständige `myfreshworks.com`-URL). Bestätigen Sie die Vorschau-URL, falls der Assistent eine anzeigt. Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
      </Step>

      <Step title="Bestätigen, dass die Quelle aktiv ist">
        Schließen Sie die Browser-Registerkarte **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und bestätigen Sie, dass die Karte **Freshsales** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Fehlerbehebung

<AccordionGroup>
  <Accordion title="Beim Aktivieren der Quelle öffnet sich nichts">
    Prüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie es erneut.
  </Accordion>

  <Accordion title="401 Authentication Failure">
    Bestätigen Sie, dass der API-Schlüssel vollständig ist und dass der **Bundle-Alias** zu dem CRM-Konto passt, zu dem der Schlüssel gehört. Ein gültiger Schlüssel für den falschen Bundle-Host schlägt genauso fehl wie ein ungültiger Schlüssel.
  </Accordion>

  <Accordion title="Sie haben versehentlich einen Freshservice-Schlüssel kopiert">
    Die beiden Produkte stellen unterschiedliche Anmeldeinformationen aus und authentifizieren sich unterschiedlich. Ein Freshservice-Schlüssel funktioniert hier nicht.
  </Accordion>

  <Accordion title="Benutzer werden angezeigt, aber Rollen oder Gebiete sind unvollständig">
    Der Schlüssel gehört zu einem Benutzer, dessen eigene Rolle diese nicht sehen kann. Generieren Sie den Schlüssel mit einem Benutzer mit Administratorrechten neu.
  </Accordion>

  <Accordion title="Der Assistent meldet einen nicht erreichbaren Host">
    Der Bundle-Alias ist nur die Subdomain. Geben Sie weder `https://` noch `.myfreshworks.com` an.
  </Accordion>
</AccordionGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Quellenverwaltung" icon="plug" href="/de/compliance/sources-management">
    Alle Compliance-Quellen durchsuchen und verwalten.
  </Card>

  <Card title="Erste Schritte mit Compliance" icon="rocket" href="/de/compliance/getting-started-with-compliance">
    Frameworks, Aktionen und **Artefakte**.
  </Card>

  <Card title="Iru-Übersicht" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

  <Card title="Artifacts-Verwaltung" icon="folder-open" href="/de/compliance/artifacts-management">
    Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.
  </Card>
</CardGroup>