# EspoCRM integration

EspoCRM is an open-source CRM software that allows all business relationships to be displayed, entered, and evaluated regardless of type.

With sipgate, you can make calls directly from EspoCRM 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 telephone system with the telephony app for desktop and mobile.

**Integration of EspoCRM 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 "Integrations", search for the entry "EspoCRM" and click the "Connect with EspoCRM" button. ![EspoCRM\_Login.png](/files/6f571bb5f9a6748d4bc8166716cdf3d57d60c59a)
{% endstep %}

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

Enter the required API key and API URL here.

![EspoCRM\_API.png](/files/73d06488562a1ed06106b4edaf3fcf1af97dceeb)
{% endstep %}

{% step %}
**Confirm connection**

This means you have successfully connected EspoCRM 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 EspoCRM account:**

{% stepper %}
{% step %}
**Create role**

In the first step, you need to create a role with the necessary permissions. In your account, select "Administration" at the top right under the button with the three dots.

![EspoCRM1 Kopie.png](/files/8caf3d4b69a157bb1bf3ae568e3e8e260f310596)

In the following window, select the entry "Roles" under "Users".

![EspoCRM2 Kopie.png](/files/a91166ce432f48d98887669401f7abb14036bf7e)

Click the "Create Role" button.

![EspoCRM3 Kopie.png](/files/ca2d40ad6181a4848fd41809be832bcd2a48f15a)

First, assign any name to the new role. Then activate the following scopes from the "Scope Level" list: "Accounts", "Contacts", "Leads", and "Users". Then save your entry with "Save".

![EspoCRM4 Kopie.png](/files/5cfe09c92d7009fa83f4d977e0c62a7e2e051ff4)
{% endstep %}

{% step %}
**Create API user**

In the second step, create a new user and assign the role you just created to them. To do this, click the button with the three dots again in the top right and select "Administration" once more. ![EspoCRM1 Kopie.png](/files/8caf3d4b69a157bb1bf3ae568e3e8e260f310596)

Then select the entry "API Users" under "Users".

![EspoCRM6 Kopie.png](/files/3d2aebfd99a145c59169211f5dfaeb0f46d1a232)

Give the user any name and assign the previously created role to them. **Please make sure that the "Authentication Method" is set to "API Key".** Then save your entries with "Save".

![EspoCRM7 Kopie.png](/files/dcb49f05ad3bb9f113d0580e9cab10565cc9345a)
{% endstep %}

{% step %}
**Copy API key**

You can now find the required API key for the newly created user. Enter this API key and the API URL: [https://kundensubdomain.espocloud.XX](https://kundensubdomain.espocloud.xx/) or your own self-hosted domain [https://firma.de](https://firma.de/) in the sipgate app.

![EspoCRM8 Kopie.png](/files/7d480b83bacff006fa6d28952fc3f04150c9718f)
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Important:** To enable the self-hosted Espo CRM solution in your firewall setup, you must allow the Espo-Bridge at espocrm.integration.sipgate.cloud and port 443. This is required so that the sipgate app can successfully load the CRM contacts.
{% endhint %}


---

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