> For the complete documentation index, see [llms.txt](https://help.sipgate.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sipgate.de/cloud-telefonanlage/en/connections-and-integrations/integrationen-fur-die-sipgate-app/suitecrm-integration.md).

# SuiteCRM integration

SuiteCRM is a modular open-source CRM that can be configured for your sales or service department.

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

**Integration of SuiteCRM in the sipgate app:**

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

Click the gear icon on the left in the sipgate app and select the item **Integrations** from.\
Under the item **Integrations** look for the entry **SuiteCRM** and click the button **Connect to SuiteCRM.**

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

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

Enter the required API key and API URL here.

{% hint style="warning" %}
**Please enter the required API key in the format "ID:Client Secret".**
{% endhint %}

The API URL corresponds to the web address of your SuiteCRM instance. ![suitecrm-api.png](/files/11ccc6c97e31cf8d49728e224d412a6e5a998d05)
{% endstep %}

{% step %}
**Confirm connection**

You have now successfully connected SuiteCRM 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 SuiteCRM account:**

Click on your user icon in the upper right and select the "Admin" menu item.

![suitecrm1.png](/files/92dd159a824f8f4b1d4420627f5e284c771fe7c9)

In the following window, select "OAuth2 Clients and Tokens".

![suitecrm2.png](/files/99a1d75cb015f13dc1dcf22f9e8177f3cf6e2c04)

In the menu on the left, open "New Client Credentials Client".

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

Now assign any name for the API key. In the "Change Secret" field, enter a client secret of your choice.\
**Please note that you will need this client secret in the sipgate app for the API key to be entered there.**

Finish your entries with "Save".

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

Finally, you will now find the required ID in the new window.

**Please note that you will need this ID in the sipgate app for the API key to be entered there.**

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.sipgate.de/cloud-telefonanlage/en/connections-and-integrations/integrationen-fur-die-sipgate-app/suitecrm-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.