> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.crisp.chat/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to connect Ringover with Crisp

*Learn how to connect Ringover to Crisp so phone calls, call notes, and call events can be handled from the Inbox.*

The **Ringover** integration lets your team start phone calls from Crisp and receive call-related messages and notes in conversations. It is useful when you want phone support to live beside chat, email, and social channels in the same workspace.

|| To use this integration, you need the **Crisp Essentials** plan and a **Business** or **Advanced** plan on Ringover.

---

# ${color}[#0080dd](Install the Ringover integration)

Before you start, make sure you are an **Admin** in your Crisp workspace and have access to the **Ringover Developer** page.

1. Open the [**Ringover Dashboard**](https://dashboard.ringover.com/developer) and go to **Developer**.
2. Click **Create an API Key**, select the user whose number will be integrated with Crisp, and give the key a clear label.

![Create a Ringover API key](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/ringover_1k603r7.png =1000xauto)

3. Under **Rights**, enable **Monitoring** and grant read/write permissions for **Calls**, **Contacts**, and **Numbers**.

| Enable **Users** read permission if you want Crisp to auto-assign conversations to the operator who picked up the call.

![Grant Ringover API permissions](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/ringover-1_ompip2.png =1000xauto)

4. Copy the API key and go to [**Crisp**](https://app.crisp.chat).
5. Open **Plugins → Ringover** and click **Install**.

![Install the Ringover plugin in Crisp](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/ringover-2_mcqqd.png =1000xauto)

6. Paste the Ringover API key and click **Connect to Ringover**.

![Connect Ringover to Crisp with the API key](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/ringover-3_uwtekq.png =1000xauto)

7. Crisp displays a **Webhook URL**. Copy it and return to the Ringover **Developer** page.
8. Activate the **Call Event** and **Contact Call** webhooks.
9. In **Call Event**, paste the Crisp webhook URL for **Calls Ringing**, **Calls Answered**, **Calls Ended**, **Missed Calls**, **Voicemail**, and **After Call**.

![Add the Crisp webhook URL to Ringover call events](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/ringover-4_1v8wf44.png =1000xauto)

10. In **Contact Call**, paste the webhook URL for the available contact call event.

Once the webhooks are active, return to your Crisp Inbox and open a conversation. The **Ringover** widget appears in the right sidebar when the integration is ready.

---

# ${color}[#0080dd](Configure Ringover preferences)

You can enable or disable Ringover preferences from the plugin settings.

1. Go to [**Crisp**](https://app.crisp.chat).
2. Open **Plugins → Ringover → Configure the plugin**.
3. Review the available preferences and save your changes.

| The operator who picked up a call can be automatically assigned to the Crisp conversation when their Crisp account email matches their Ringover account email.

|| Auto-assign requires **Users** read permission on the Ringover API key.

![Configure Ringover plugin preferences](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/ringover-5_1ko7lz5.png =1000xauto)