---
updatedAt: 2026-02-10T16:14:26.000Z
---

# requestToggleSoftphone

### requestToggleSoftphone

<u>**Mandatory**: no</u>

**Descriptiopn**: The *requestToggleSoftphone* feature is used to open the connector application (if it is minimized) when a new interaction arrives. This ensures that the user is immediately notified and can respond promptly to the new interaction.

***Implementation Example***

```javascript
// This is a part of the mandatory in-place event message handler
const processCRMConnectMessageData = async (event) => {
  if (event.origin !== CRM_CONNECT_ORIGIN) { 
      return; 
  }

  const { action, data } = event.data;
  if (action === 'requestToggleSoftphone') {
    processToggleSoftphone(data.visible)
  }
}

const processToggleSoftphone(visible) {
  // Implement your own toggle mechanism based on the CRM you're using (if it is supported)
}
```

## Message formats

### CRM Connector

```json
{ "type": "CRMConnectMessage", "action": "requestToggleSoftphone", "data": <crmConnectorDataObject> }
```

#### CRM Connector data object format

```json
{
  "visible": <boolean> // Dictates whether the connector should be minimized or maximized
}
```