Overview
Sales is hard. Empower your sales team by giving them an automatic recording experience. The Siro app accepts deep links to start and stop recordings and then redirects you back to your app. This lets you create an experience for sales reps that starts and ends recordings nearly automatically.Best Practices
Good 👍: Sales reps don’t need to change their current behavior, but suddenly all of their conversations are recorded for them. The experience feels magical. Bad 👎: Making your sales reps tap an extra button to start and stop recordings. This is a tedious experience that feels like more work. Worst of all, reps will sometimes forget to record and lose critical conversation intelligence.Link Behavior
- If a recording is already in progress, it will not be interrupted
- Deep links will skip all post-recording debrief screens
Recording Action Links
URL Format
Parameters
action
(required)
Can be one of the following: start
, stop
, or restart
start
- Starts a new recording, or opens the Siro app and continues a recording if one is paused or already recordingstop
- Fully stops a recording in progress. This will skip past the paused state and end the recording entirely. This will also skip past any post-recording debrief screensrestart
- Fully stops a recording and restarts a brand new recording
title
(optional)
The title
parameter accepts a string and will set the recording title. This parameter is only valid for start
actions.
redirectUrl
(optional)
An optional encoded URL that the app will use to redirect after the given action is performed.
Important Notes:
- All URL parameters in the link need to be URL encoded (e.g., the
/
character becomes%2F
) - We recommend backlinking to your app using Universal Links (iOS) and App Links (Android). Otherwise, if you are using an app schema to redirect to your app (example:
yourApp://
), you will need to ask the Siro team to whitelist your app in our next deployment. Please reach out tovince@siro.ai
. It may take weeks to get your app whitelisted, so plan accordingly.
integrationConnectionId
(optional)
An optional connection ID the app will use to identify the CRM integration. Organization admins can create integration connection IDs in the web app’s integrations page.
Important Notes:
- This is required for the
crmObjects
parameter to be accepted - This parameter is only valid for
start
andrestart
actions
crmObjects
(optional)
A URL-encoded array of CRM objects that relate to the recording.
CRM Object Structure
Object Properties
objectType
- The recording’s relationship to entities in the CRM. Must be one of:Lead
,Account
,Opportunity
,Event
, orServiceAppointment
objectId
- The ID of the entity in the CRM
Full Example:
integrationConnectionId
is required for thecrmObjects
parameter to be accepted- This parameter is only valid for
start
andrestart
actions. If used with a restart action, the new recording that is started will be linked to that opportunity
opportunityId
(optional) (deprecated)
The opportunityId
parameter accepts a string and will automatically link this recording with the associated opportunity in Siro. Opportunities are deals that can stretch over multiple appointments.
Important Notes:
- This parameter is only valid for
start
andrestart
actions - If used with a restart action, the new recording that is started will be linked to that opportunity
jobId
parameter can also be used. Siro treats this as the opportunityId
.
Deprecated: The opportunityId
parameter is also being replaced with integrationConnectionId
and crmObjects
. New integrations should use these parameters instead.