# CiviCRM Integration

CiviCRM ist ein webbasiertes, Open-Source-CRM, das die Bedürfnisse von gemeinnützigen Organisationen und anderen zivilgesellschaftlichen Organisationen erfüllt. Dabei ist es einfach zu bedienen, anzupassen und zu erweitern.

Mit sipgate telefonieren Sie direkt aus CiviCRM 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 CiviCRM 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 "CiviCRM" und klicken auf die Schaltfläche "Mit CiviCRM verbinden". ![civicrm.png](/files/5eaWNuv6T4RZZyRx6ryV)
{% endstep %}

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

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

![civicrm\_api.png](/files/piLC3NQMcB37MklOyL9S)
{% endstep %}

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

Damit haben Sie CiviCRM 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 CiviCRM-Account finden bzw. erstellen:**

{% hint style="warning" %}
**Wichtig: Um einen API-Key erstellen zu können, muss zunächst das API Key Management Modul installiert werden. Bei CiviSpark ist dies zwar installiert, aber nicht aktiviert. Für eine entsprechende Aktivierung setzen Sie sich bitte mit dem CiviCRM Support in Verbindung.**
{% endhint %}

{% stepper %}
{% step %}
**Modul aktivieren**

Die Einstellungen für das API Key Management Modul finden Sie in Ihrem CiviCRM Account unter "Administration", "Systemeinstellungen", "Erweiterungen".

![civicrm1.png](/files/iJqrrL7i7b9xG7HBRJyR)

Das API Key Management Modul.

![civicrm2.png](/files/WVXpvGgAXBt2312d8SkW)
{% endstep %}

{% step %}
**Kontakt suchen**

Nach erfolgreicher Aktivierung wählen Sie in der Top Navigation den Punkt "Suche" und dort den Unterpunkt "Kontakte finden".

![civicrm3.png](/files/5zWzyYeKjl2hwxNj5Tnb)

Im neuen Fenster können Sie alle Felder unausgefüllt lassen und klicken direkt auf die Schaltläche "Suche".

![civicrm4.png](/files/gMJ2J7WfMxkP8C3oqTTe)

Wählen Sie einen beliebigen Kontakt aus.

![civicrm5.png](/files/H2wyrjOKbAveLNP2oQBW)
{% endstep %}

{% step %}
**Benutzerkonto anlegen**

Klicken Sie nun links oben im Fenster auf die Schaltfläche "Aktion".

![civicrm6.png](/files/iLmAq6p8X84pIygSM5Ae)

Wählen Sie "Benutzerkonto anlegen".

![civicrm7.png](/files/e2IXooLbvUiwBdNXXxOG)
{% endstep %}

{% step %}
**Administrator-Rolle zuweisen**

Klicken Sie im Menü auf den Punkt "Edit" und wählen unter "Roles" den Eintrag "administrator". Sichern Sie Ihre Eingabe mit der Schaltfläche "Save". ![civicrm8.png](/files/YLwr6BKQc0QUjaM1MzRk)
{% endstep %}

{% step %}
**API Key generieren**

Kehren Sie jetzt auf die Detailseite des ausgewählten Kontakts zurück und wählen Sie links den Eintrag "API Key" aus. Klicken Sie denn rechts im Fenster auf die Schaltfläche "+ Add API Key". ![civicrm9.png](/files/ySJmPyElgtgZ3Nlc3B3R)

Durch Betätigen der Schaltfläche "Generate" erstellen Sie einen neuen API Key.

![civicrm10.png](/files/e6ea8JIFtqtbGUtS0gzy)
{% endstep %}
{% endstepper %}


---

# 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/civicrm-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.