# Nextcloud integration

Nextcloud enables you to manage your data on your own cloud server without having to hand over data sovereignty to companies like Google or Apple. With a mix of self-hosting and private cloud computing, Nextcloud offers individualized, better data protection than commercial US cloud providers.

With sipgate, you can make calls directly from Nextcloud and use your contacts in the sipgate app. This way, you always see which contact is currently calling and do not have to switch between different tools. sipgate is your phone system with the telephony app for desktop and mobile.

#### **Integration of Nextcloud in the sipgate app**

{% stepper %}
{% step %}
**Select integration**

In the sipgate app, click the gear icon on the left and select the item "Integrations".

Under the "Integrations" section, search for the entry "Nextcloud" and click the "Connect with Nextcloud" button. ![nextcloud.png](/files/154efc06f5cf0e66bf884eabafa1e8fbe427959e)
{% endstep %}

{% step %}
**Enter API data**

Enter the required API key and API URL here.

{% hint style="warning" %}
**Important: The API key must be entered in the format "Username:Webtoken".**
{% endhint %}

Copy the API URL from the address field in the browser window of your Nextcloud instance.

![nextcloud\_api.png](/files/9a0b94f351e6c85c05f0aeb4305104215117e3cb)
{% endstep %}

{% step %}
**Confirm connection**

You have now successfully connected Nextcloud and the sipgate app.

{% hint style="info" %}
Note: Depending on the number of contacts to be integrated, it may take a few minutes before they are displayed completely.
{% endhint %}
{% endstep %}
{% endstepper %}

#### **Find or create the API key in your Nextcloud account**

Click on your user icon in the top right of your Nextcloud instance, then open the menu item "Administration settings".

![nextcloud1 Kopie.png](/files/0db96b2cf2bccbf7dc047cf0220df4ff3373eca3)

Now select "Security" on the left under the heading "Personal".

![nextcloud2 Kopie.png](/files/6cc253bfe32bf39f356f22ce9d64dc6179121e52)

#### **Errors and solutions:**

<details>

<summary>Error: “Invalid credentials” with self-hosted Nextcloud</summary>

**self-hosted Nextcloud**

Most likely, the sipgate app will not be able to connect successfully and will report the error: “Invalid credentials”.\
**Cause**: requests are not forwarded to Nextcloud via WebDAV in the self-set-up web server/load balancer/etc.\
**Information**:

WebDAV:

Here you can create the required web token (API key). If you have already created web tokens in the past, they can be deleted, revoked, or renamed here. Please note that the actual tokens (API keys) can only be viewed and copied once when they are created.

Scroll to the bottom of the page, enter any name in the "App name" field, and then click the "Create new app password" button.

![nextcloud3 Kopie.png](/files/edf981df7fc63f9695695fc552a28a294cdd008b)

Please note the instructions shown and copy the newly created token. Finally, click the "Done" button. ![nextcloud4 Kopie.png](/files/cf0cf4356769f446347598906b1354b03175cc2e)

</details>


---

# 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/en/connections-and-integrations/integrationen-fur-die-sipgate-app/nextcloud-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.
