Skip to main content

Deep links

Open a text conversation or the dialer with a phone number already filled in, from your CRM, spreadsheet, or any tool that can open a link

Written by Dustin Belliston

What are deep links?

A deep link is a normal web address that takes you straight to a specific screen in CurrentClient with a client's phone number already selected. Put one behind a button in your CRM, a column in a spreadsheet, or a bookmark, and a teammate is one click away from texting or calling that client. Nothing is sent and no call is placed until they press send or call.

Deep links open in your browser. If the CurrentClient desktop app is installed, the same link hands off to the desktop app automatically. There is nothing to configure and no default-app setting to depend on.


How do I open a text conversation?

Use the new conversation link with a to parameter:

https://app.currentclient.com/inbox/m/new?to=%2B14155552671

This opens the compose screen in your inbox with the number filled in as the recipient. If you already have a conversation with that number, you land in it. If not, the conversation is created when you send the first message.

A few variations:

  • Pick a specific inbox. Put the inbox number in the path: https://app.currentclient.com/inbox/14155550100/m/new?to=%2B14155552671. Without it, the link opens in your default inbox.

  • Start a group message. Separate numbers with commas: ?to=%2B14155552671,%2B14155550123. See Group messages for how group texting works.

Note: Write numbers in international format with the country code, and encode the plus sign as %2B so it survives the trip through a URL: %2B14155552671 for a US number, %2B442071234567 for a UK number. A plain 10-digit US number like 4155552671 also works.


How do I open the dialer with a number?

Use the dashboard link with a tel parameter:

https://app.currentclient.com/app/dashboard?tel=14155552671

This opens the dialer with the number filled in, along with the matching contact if we find one. You still press the call button yourself. Read Call flow to see what happens once the call connects.

Warning: The dialer link supports US and Canada numbers only right now. Use the ten digits, or eleven with a leading 1. International numbers are not supported on this link yet.


What happens if I have the desktop app?

When you open a deep link in your browser, CurrentClient first checks whether the desktop app is running on your computer and hands the link to it. If the app is installed but not running, the browser launches it. If the app is not installed at all, the link simply opens in the browser. Either way you end up on the right screen, so the same link works for everyone on your team no matter how they use CurrentClient.

The desktop app also understands its own currentclient:// links. These only work on a computer with the desktop app installed, so use them when you know the link will never be opened anywhere else, for example inside an internal tool:

currentclient://call/14155552671
currentclient://inbox/m/new?to=%2B14155552671

The first starts a call to the number. The second opens the same compose screen as the web link above. Any path from the web app works after currentclient://.

Tip: You can also set the CurrentClient desktop app as the handler for tel: and callto: links on your computer. After that, clicking a phone number in any website or document opens the CurrentClient dialer.


Do deep links work on mobile?

Partly, and it depends on the phone.

iPhone. iOS lets you choose a default calling and texting app. Once CurrentClient is set as the default (iOS 18.2 or later, CurrentClient app 1.53.1 or later), standard tel: and sms: links open CurrentClient, and long-pressing a phone number offers "Call with CurrentClient" and "Message with CurrentClient." Set it in the iPhone Settings app under Apps, Default Apps.

sms:+14155552671
tel:+14155552671

There is no CurrentClient-only link on iPhone that bypasses this setting. If CurrentClient is not the default, these links open the built-in Phone and Messages apps.

Android. Deep links into the CurrentClient Android app are not supported yet.

Tip: If you are building links into a staff tool, use the https://app.currentclient.com links from this page. They work on any computer with or without the desktop app, and they do not depend on a default-app setting.


Can I try it right now?

Yes. Type a phone number below and each deep link on this page becomes a live button. Sign in to CurrentClient in another tab first so the web links land you on the right screen.

Note: The two desktop buttons do nothing on a computer without the desktop app installed, and the sms: and tel: buttons open whatever app your device uses for texting and calling. That is expected. See Install apps to get the desktop app.


Examples


CRM contact record

Most CRMs let you add a custom field or button whose value is a URL built from other fields. Set it to the text conversation link and merge in the contact's mobile number:

https://app.currentclient.com/inbox/m/new?to=%2B1{{mobile_phone}}

Replace {{mobile_phone}} with your CRM's merge field for a ten-digit number. If your CRM stores numbers with the country code already, drop the 1.


Spreadsheet

In Google Sheets or Excel, build a clickable link from the phone number in the next column:

=HYPERLINK("https://app.currentclient.com/inbox/m/new?to=%2B1" & B2, "Text")

This assumes column B holds ten-digit US numbers with no punctuation. Fill the formula down and every row gets a "Text" link that opens that client's conversation.


Bookmark or automation

A deep link can be a plain bookmark for a client you text often:

https://app.currentclient.com/inbox/m/new?to=%2B14155552671

Automation tools like Zapier can build the same URL from trigger data, for example adding a "Text this lead" link to a Slack message or an email when a new lead comes in.


Quick reference

Link

Opens

Works on

Number format

https://app.currentclient.com/inbox/m/new?to=<number>

Compose screen with the recipient selected

Browser, desktop app

International with %2B, or 10-digit US. Comma-separate for groups.

https://app.currentclient.com/inbox/<inbox number>/m/new?to=<number>

Same, in a specific inbox

Browser, desktop app

Same as above

https://app.currentclient.com/app/dashboard?tel=<number>

Dialer with the number filled in

Browser, desktop app

US and Canada only

currentclient://call/<number>

Starts a call

Desktop app only

Digits, with or without +

currentclient://<app path>

Any screen in the app

Desktop app only

Same as the web link it mirrors

sms:<number> and tel:<number>

Conversation or dialer

iPhone, when CurrentClient is the default app

International with +

Did this answer your question?