# Connect Quo

Connect your Quo phone account so calls and texts are logged in the CRM and your team can call customers with one click.

Audience: dealer-managers
Availability: Quo customers
Canonical source: https://rooftoprv.com/docs/connect-quo

Quo (formerly OpenPhone) is a business phone service. When you connect it, calls and texts on your Quo numbers are logged on the customer's record in the CRM. This covers the Quo numbers you enter here and on team profiles. Your team can also start calls from the admin panel. You can finish every step yourself. Nothing needs to be turned on by ROOFTOP.

## Before you start

- You need a Quo account, and a login that can open Quo's API and webhook settings.
- To open the page, you need the **View settings** permission. You also need **View team**, which opens the **Admin** section.
- To validate a key, select **Sync now**, or save the page, you need the **Manage integrations** permission. Saving the page also needs **Edit general settings**.
- To add a person's Quo number to their team profile, you need the **Assign roles** permission.
- Each team member's email in ROOFTOP should match their email in Quo. That's how the two are matched.

After you turn on **Quo integration**, the page shows its own **Setup guide** at the bottom. It links to the right screens in Quo. Select it to follow along.

## Connect your Quo account

1. Go to **Admin** > **Integrations** > **Quo**.
2. Turn on **Quo integration**.
3. In Quo, open the API settings and create an API key.
4. Paste the key into **API key**.
5. Select **Validate**.
   An "API key verified and saved" message appears. The key is saved and Quo is turned on right away, before you select **Save changes**. If the key is wrong, you see "Invalid API key".
6. Enter the **Main phone number ID**. In Quo, open the phone number's settings to find it. It starts with PN, such as PNxxxxxxxx.
   This is the number used for shared team communication. Calls and texts on this number are logged only once its ID is saved here. A wrong ID saves without an error, so copy it exactly.
7. Enter the **Main phone number (for display)**, such as (813) 555-1234.
8. Select **Save changes**.
   A "Quo settings saved" message appears.

After a key is saved, the **API key** field is empty and reads "Configured. Enter a new key to replace it." Leave it empty to keep the current key.

## Send Quo calls and texts to ROOFTOP

Quo tells ROOFTOP about calls and texts through a webhook. Until you finish these steps, nothing from Quo is logged. Events from your Quo account are rejected until the **Webhook signing secret** is saved.

1. On the **Quo** page, find **Webhook URL** and select **Copy**.
2. In Quo, open the webhook settings and add a new webhook with that URL.
3. In the Quo webhook, turn on these events:

   | Event | What it logs |
   |---|---|
   | call.completed | Completed calls with their length |
   | call.summary.completed | Call summaries |
   | call.transcript.completed | Call transcripts |
   | call.recording.completed | Call recordings |
   | message.received | Texts from customers |
   | message.delivered | Texts your team sent |

4. In Quo, copy the key of the webhook you added.
5. Back on the **Quo** page, paste it into **Webhook signing secret**.
6. Select **Save changes**.

If you delete and re-create the webhook in Quo, paste the new key here.

## Match your team to Quo users

Matching is by email address. It lets ROOFTOP show which team member answered or made a call.

1. On the **Quo** page, under **Sync user IDs**, select **Sync now**.
   The page shows a line such as "Synced 2 of 5 staff members". It lists the people it newly matched under **Matched:**. If everyone was already matched, you see "No user IDs to sync (all staff members already have matching IDs)".

## Set up each person for click-to-call

1. Go to **Admin** > **Organization** > **Team**.
2. Select **Edit** (the pencil) next to the person.
3. On the **Profile** tab, under **Quo (optional)**, enter their Quo **Phone number ID**.
4. Enter their Quo **Phone number**.
5. Select **Save changes**.
   Calls that person starts from the admin panel then show their own number. Calls and texts on that number are logged in the CRM.

Each person also needs the Quo app on their computer or phone. For more, see [Edit a team member](https://rooftoprv.com/docs/edit-a-team-member) and [Call a customer from the CRM](https://rooftoprv.com/docs/call-a-customer-from-the-crm).

## Troubleshooting

**Saving says "Enter your Quo API key to turn on Quo"**
Paste and validate an API key first, or turn **Quo integration** off.

**Calls and texts aren't showing up in the CRM**
Check four things:

- The webhook in Quo uses the **Webhook URL** from this page.
- The events in the table are turned on.
- The **Webhook signing secret** matches the key of that webhook.
- The Quo number is entered as the **Main phone number ID** or on a team member's profile.

**Sync now is dimmed**
**Sync now** stays dimmed until a validated API key is saved and **Quo integration** is on.

**Sync now matched fewer people than I expected**
A person is matched only when their email is the same in ROOFTOP and in Quo.

**Saving shows an error**
You may be missing a permission. Saving needs both **Manage integrations** and **Edit general settings**.

## Related guides

- [Call a customer from the CRM](https://rooftoprv.com/docs/call-a-customer-from-the-crm)
- [Send customer text messages](https://rooftoprv.com/docs/send-customer-text-messages)
- [Review call recordings and voicemails](https://rooftoprv.com/docs/review-call-recordings-and-voicemails)
