# SuiteCRM Integration

SuiteCRM ist ein modulares Open-Source-CRM, das für Ihre Vertriebs- oder Serviceabteilung konfiguriert werden kann.

Mit sipgate telefonieren Sie direkt aus SuiteCRM heraus und nutzen Ihre Kontakte in der sipgate App. So sehen Sie immer, welcher Kontakt gerade anruft und müssen nicht zwischen verschiedenen Tools wechseln. sipgate ist Ihre Telefonanlage mit der Telefonie App für Desktop und Mobile.

**Integration von SuiteCRM in der sipgate App:**

{% stepper %}
{% step %}
**Integration auswählen**

Klicken Sie in der sipgate App links auf das Zahnrad und wählen Sie den Punkt **Integrationen** aus.\
Unter dem Punkt **Integrationen** suchen Sie den Eintrag **SuiteCRM** und klicken auf die Schaltfläche **Mit SuiteCRM verbinden.**

![suitecrm.png](/files/hJQEGs8SC7bUiL8iabFK)
{% endstep %}

{% step %}
**API-Daten eingeben**

Geben Sie hier den benötigten API-Key und die API-URL ein.

{% hint style="warning" %}
**Bitte geben Sie die benötigten API-Key in der Form "ID:Client Secret" ein.**
{% endhint %}

Die API-URL entspricht der Web-Adresse Ihrer SuiteCRM Instanz. ![suitecrm-api.png](/files/MPkk60kAXvtcczDabYkk)
{% endstep %}

{% step %}
**Verbindung bestätigen**

Damit haben Sie SuiteCRM und die sipgate App erfolgreich verbunden.

{% hint style="info" %}
Hinweis: Je nach Anzahl der zu integrierenden Kontakte kann es einige Minuten dauern, bis diese vollständig angezeigt werden.
{% endhint %}
{% endstep %}
{% endstepper %}

**API-Key in Ihrem SuiteCRM-Account finden bzw. erstellen:**

Klicken Sie rechts oben auf Ihr Benutzer-Icon und wählen dort den Menüpunkt "Admin".

![suitecrm1.png](/files/aTwTbJCzztWCEP7r5OLG)

Wählen Sie im folgenden Fenster "OAuth2 Clients and Tokens".

![suitecrm2.png](/files/nvdWGEiFNpWakgK1vqic)

Im Menü links öffnen Sie den Punkt "New Client Credentials Client".

![suitecrm3.png](/files/TOOo8VsC3i2RtJ1qUZe5)

Vergeben Sie nun einen beliebigen Namen für den API-Key. In dem Feld "Change Secret" geben Sie ein frei wählbares Client Secret ein.\
**Beachten Sie, dass Sie dieses Client Secret in der sipgate App für den dort einzugebenden API-Key brauchen.**

Schließen Sie Ihre Eingaben mit "Save" ab.

![suitecrm4.png](/files/kBXftFVGEXfmzsRNmMiw)

Abschließend finden Sie nun noch die benötigte ID im neuen Fenster.

**Beachten Sie, dass Sie diese ID in der sipgate App für den dort einzugebenden API-Key brauchen.**

![suitecrm5.png](/files/fyTudHTq9GBNC95RZCBV)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.sipgate.de/cloud-telefonanlage/anbindungen-und-integrationen/integrationen-fur-die-sipgate-app/suitecrm-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
