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
Updated August 27, 2026
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.
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.
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://.
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.
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.
Use a number you are allowed to text or call. Opening a link never sends a message or places a call on its own.
- Open text conversationWeb link. Hands off to the desktop app if it is installed.
- Open dialerWeb link. US and Canada numbers only.
- Desktop app: start callOnly works on a computer with the desktop app installed.
- Desktop app: open conversationOnly works on a computer with the desktop app installed.
- sms: linkOn iPhone, opens CurrentClient only if it is your default texting app.
- tel: linkOpens whichever app handles phone links on this device.
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#
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.
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 + |