Integrations
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.
For: Dealer managers
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
- Go to Admin > Integrations > Quo.
- Turn on Quo integration.
- In Quo, open the API settings and create an API key.
- Paste the key into API key.
- 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".
- 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.
- Enter the Main phone number (for display), such as (813) 555-1234.
- 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.
-
On the Quo page, find Webhook URL and select Copy.
-
In Quo, open the webhook settings and add a new webhook with that URL.
-
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 -
In Quo, copy the key of the webhook you added.
-
Back on the Quo page, paste it into Webhook signing secret.
-
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.
- 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
- Go to Admin > Organization > Team.
- Select Edit (the pencil) next to the person.
- On the Profile tab, under Quo (optional), enter their Quo Phone number ID.
- Enter their Quo Phone number.
- 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 and 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.