# monday and phone.systems(TM) Integration

Connecting **phone.systems(TM)** with **monday** CRM allows you to manage customer calls and track important
information. The integration includes the following features:

- **Sync contacts automatically**: Keep contacts updated between phone.systems(TM) and monday CRM.
- **Call journaling**: Calls are automatically logged in the monday CRM workspace (phone.systems(TM) board). You can also manually select a different board for journaling.
- **Auto contact creation**: New contacts can be created in the monday CRM workspace when a number doesn't match an existing contact (for inbound, outbound, or both call directions). You can choose which directions trigger contact creation.
- **Call recording uploads**: Call recordings can be automatically added to the call entry in monday CRM.
- **Flexible synchronization options**: Select a contact board and assign its columns in monday CRM to control how data is synchronized.

---



## Connecting phone.systems(TM) with monday CRM

This guide provides detailed steps on integrating phone.systems(TM) with monday CRM. Follow the instructions below to
complete the setup process.

Note

To connect phone.systems(TM) with monday, generate the **Client ID**, **Client Secret**, and **Signing Secret** in your
monday developer account.

### Step 1: Sign in to your monday account

To get started, go to the [monday page](https://monday.com) and **Log in** to access an existing account or create a new
one.

### Step 2: Open monday Developers page and create an app

1. Click on your user icon in the top right corner.
2. In the **Account** section, click **Developers**.
3. On the **My Apps** page of the monday Developer Center, click the **Build app** button to create a new app.

[![Developers Account Section](../../../_images/1_build_app.png)](../../../_images/1_build_app.png)


**Fig. 1.** Developers Account Section

### Step 3: Launch phone.systems(TM) and connect to monday CRM

1. In the phone.systems(TM) interface, click **Settings**.
2. Open the **CRM Integrations** tab at the top of the screen. Alternatively, use this direct link: [phone.systems(TM) monday CRM Integration](https://phone.systems/ui/index.html#/settings/integrations/monday/new)
3. Click **Connect** to link your monday CRM app with phone.systems(TM).

Note

Clicking **Connect** will open the **Connect monday** form to continue the integration setup.

[![Connect monday in phone.systems(TM)](../../../_images/2_connect_monday_in_phone_systems.png)](../../../_images/2_connect_monday_in_phone_systems.png)


**Fig. 3.** Connect monday in phone.systems(TM)

### Step 4: Copy app credentials from monday Developer Center and paste them into the phone.systems(TM)

Continue configuring the new app in the monday Developer Center. Navigate to the **General settings** section, click
**Show**, and then copy the **Client ID**, **Client Secret**, and **Signing Secret**.

[![Copy Client ID, Client Secret, and Signing Secret](../../../_images/7_copy_client_credentials.png)](../../../_images/7_copy_client_credentials.png)


**Fig. 8.** Copy Client ID, Client Secret, and Signing Secret

Open the [phone.systems(TM) monday connection
form](https://phone.systems/ui/index.html#/settings/integrations/monday/new), and paste the **Client ID**, **Client
Secret**, and **Signing Secret** from the monday Developer Center into the corresponding fields.

[![Paste Client ID, Client Secret, and Signing Secret](../../../_images/7_paste_client_credentials.png)](../../../_images/7_paste_client_credentials.png)


**Fig. 9.** Paste Client ID, Client Secret, and Signing Secret

### Step 5: Copy the Redirect URL from phone.systems(TM) and paste it into monday Developer Center

Continue in the [phone.systems(TM) monday CRM connection
page](https://phone.systems/ui/index.html#/settings/integrations/monday/new), copy the **Redirect URL**.

[![Copy the Redirect URL](../../../_images/3_copy_redirect_url.png)](../../../_images/3_copy_redirect_url.png)


**Fig. 4.** Copy the Redirect URL

Open the app creation page on the [monday Developer Center](https://developer.monday.com) and access your app
configuration. Then follow these steps:

1. In the left sidebar, expand the **Build** section.
2. Click on **OAuth & permissions**.
3. Navigate to the **Redirect URLs** tab.
4. Paste the **Redirect URL** in to the corresponding input field.

[![Paste the Redirect URL](../../../_images/4_paste_redirect_url.png)](../../../_images/4_paste_redirect_url.png)


**Fig. 5.** Paste the Redirect URL

### Step 6: Define app permissions with OAuth scopes

Continue in the **monday Developers Center** to configure your app permissions.

1. Open the **Scopes** tab in the **OAuth & permissions** section.
2. Locate and enable the following OAuth scopes:

   > | **OAuth Scope** | **Description** |
   > | --- | --- |
   > | **me:read** | Read a user's profile information |
   > | **boards:read** | Read user's boards data |
   > | **boards:write** | Modify user's boards data |
   > | **users:read** | Read the profile information of the users on the account |
   > | **account:read** | Read general information about the account |
   > | **workspaces:read** | Read user's workspaces data |
   > | **workspaces:write** | Modify user's workspaces data |
   > | **webhooks:write** | Create and modify webhooks |
   > | **webhooks:read** | Read existing webhooks configuration |
3. Once all scopes are selected, click **Save Scopes** at the bottom of the page.

[![Add required OAuth scopes](../../../_images/5_add_oauth_scopes.png)](../../../_images/5_add_oauth_scopes.png)


**Fig. 6.** Add required OAuth scopes

### Step 7: Publish app and authorize connection

1. In the monday Developer Center, click the **Promote to live** button to publish your app.
2. Return to phone.systems(TM) and click **Connect**.
3. A permission authorization window will appear. Click **Authorize** to approve the integration.

   [![Authorize the connection](../../../_images/8_authorize_connection2.png)](../../../_images/8_authorize_connection2.png)


   **Fig. 7.** Authorize the connection

After you click **Authorize**, the CRM status will change to **Synchronizing**, and then to **Connected** once the
initial synchronization is complete.

Important

After the connection is established, make sure to configure synchronization with your appropriate monday board. You can
follow the steps described in [Synchronizing Contacts](#synchronizing-contacts).

[![Connected status in phone.systems(TM)](../../../_images/9_connected_status.png)](../../../_images/9_connected_status.png)


**Fig. 8.** Connected status in phone.systems(TM)



---

## Synchronizing Contacts

Once the integration is connected, you must configure the synchronization options to map your monday.com board columns
to phone.systems(TM) contact fields.

1. Navigate to **Settings > CRM Integrations**.
2. Locate the active monday.com integration and click the three-dots menu icon.
3. Select **Change synchronization options** from the dropdown menu.

   [![Change synchronization options button.](../../../_images/10_change_sync_options_button.png)](../../../_images/10_change_sync_options_button.png)


   **Fig. 9.** Synchronization options menu.
4. In the **Synchronization options** window, assign the columns from your monday.com board to the corresponding fields:

   > - **Board:** Select the monday.com board where your contacts are stored.
   > - **Name:** Assign the column that contains the contact's full name.
   > - **Phone Numbers:** Assign the column that contains phone numbers.
   > - **Emails:** Assign the column that contains email addresses.
   > - **Company Name:** Assign the column that contains company names.
   > - **Job Title:** Assign the column that contains job titles.
5. Click **Save** to apply the configuration.

   [![Change synchronization options window.](../../../_images/10_change_sync_options.png)](../../../_images/10_change_sync_options.png)


   **Fig. 10.** Synchronization options window.

---

## Configuring monday CRM Integration Settings

Once the integration is active and synchronized, you can customize its behavior. To access these options, navigate to
**Settings > CRM Integrations** and click the **Settings** icon next to your monday.com connection.

[![monday.com integration settings button.](../../../_images/11_settings_button.png)](../../../_images/11_settings_button.png)


**Fig. 11.** monday.com integration settings button.

### Configuring the Call Journaling Board

Important

The call journaling configuration below applies **only** to phone numbers that have **Call journaling** enabled.
Enable journaling per number in the [phone numbers](../../Numbers/phone-numbers.html#ps3-phone-numbers) menu.

To configure the board used for call journaling:

1. Navigate to **Settings > CRM Integrations**.
2. Locate your active **monday** integration and click the **Settings** icon.
3. On the integration settings page, click the **Call journaling board should be configured** link to open the configuration screen.

[![monday.com integration settings page (entry point to Call Journaling Board).](../../../_images/11_sync_settings.png)](../../../_images/11_sync_settings.png)


**Fig. 12.** Integration settings page.

On this screen, you must configure the **Call Journaling Board**.
At a minimum, map the **Board** and **Contacts** fields.
All other fields are optional but recommended, as they enrich call logs with additional context.

| **Field** | **Description** |
| --- | --- |
| **Board** | Select the monday board where calls will be logged (for example, *Calls*). |
| **Owner** | Assigns ownership of the logged call item. |
| **Contact** | Connects the call entry to the **Contacts** column of your main table. This mapping is essential to ensure call journaling links to the appropriate contact. |
| **Status** | Maps the status field of the call (e.g., completed, missed). |
| **Call Direction** | Identifies whether the call was inbound or outbound. |
| **Date Connected** | Logs the date when the call was connected. |
| **Source Number** | The originating phone number of the call. |
| **Destination Number** | The called phone number. |
| **Call Duration** | The length of the call in seconds or minutes. |
| **Call Notes** | Free-text notes associated with the call. |
| **Call Recording** | If enabled, attaches the recording link to the logged call entry. |

[![Call journaling board configuration in monday CRM](../../../_images/placeholder_call_journaling_board.png)](../../../_images/placeholder_call_journaling_board.png)


**Fig. 13.** Call journaling board configuration in monday CRM.

### Auto Contact Creation

This feature automatically creates a new item in your selected monday board when a call is handled from a number that
does not match an existing contact.

| **Setting** | **Description** |
| --- | --- |
| **Inbound calls** | Creates a new contact for all inbound calls from numbers not already in your contacts. |
| **Outbound calls** | Creates a new contact for all outbound calls to numbers not already in your contacts. |

### Other Settings

These settings control what additional call-related data is automatically uploaded to monday CRM.

| **Setting** | **Description** |
| --- | --- |
| **Upload call recordings to CRM** | When enabled, a link to the call recording will be automatically added to the call log in monday CRM.  Note  To utilize this feature, call recording must be enabled for your [contact method](../../Contact-methods/index.html#ps3-contact-methods). |
| **Upload AI call insights results** | When enabled, detailed analytics from our AI engine will be added to the call log. This can include:   - **Key topics:** A summary of the main topics discussed. - **Call summary:** A concise, AI-generated summary of the conversation. - **Talk to listen ratio:** A breakdown of how much each party spoke. - **Sentiment analysis:** An analysis of the emotional tone of the call. - **Transcription:** A full, written transcript of the call.   Note  To utilize the AI features, [AI Call Insights](../../ai/ai-settings.html#ps3-ai-settings-enable) must be enabled. |

On this page
