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