Deep linking in SleekFlow mobile

Streamline your communications with SleekFlow’s mobile deep-linking feature

Written By Ray Tang (Administrator)

Updated at September 27th, 2024

SleekFlow's mobile deep linking feature allows users to quickly open conversations with specific contacts or conversation IDs. This guide provides an overview of the key parameters that mobile deep links support, along with their requirements and usage.
 

What is a deep link?

A deep link is a URL or link that directs users to a specific location within an app, bypassing the app’s main landing page or home screen.

ℹ️ When using deep links, ensure that parameters are correctly formatted to avoid errors. For example, always double-check the phone number formatting or verify the correct conversationId from the URL.

 

Deep link use case

Deep link in SleekFlow allows you to quickly navigate to specific conversations or contacts with just one tap, eliminates the need for manual searches, saving time and making collaboration faster and more efficient.


Imagine you're part of a customer support team, and you need help with a specific customer conversation. Instead of explaining the details to your colleagues and having them search for the chat manually, you can simply share a deep link to the conversation. When your colleague taps the link, they are taken directly to the right conversation in SleekFlow, ready to jump in and assist. 


Set deep link parameters

SleekFlow’s mobile deep links provide users with the ability to automate interactions by directly opening conversations and inputting messages. To help users understand how to use deep links in SleekFlow, here’s an example of a complete deep link:


sleekflow://chat?message={message}&phoneNumber={phoneNumber}&templateId={templateId}&language={templateLanguage}&conversationId={conversationId}

Here are the explanation of each parameter you can use:


1. phoneNumber

  • Required if conversationId is not provided
  • This parameter identifies a contact by their phone number.
  • The phone number must be formatted as {{countryCode}}{{phoneNumber}}.

For example, a contact with Malaysian phone number 12345678 and country code +60 should be formatted as 6012345678. When used, the system opens the conversation associated with the provided phone number.


2. conversationId

  • Required if phoneNumber is not provided
  • This parameter is a unique identifier for a specific conversation.
  • It opens the chat associated with the provided conversation ID.
  • To retrieve the conversationId from the URL, you will need to use the SleekFlow web version.

Imagine your customer support team is handling numerous ongoing conversations. By using the conversationId deep link, a support representative can open a specific customer’s chat directly by clicking on the link provided in an internal system or email. 


3. message (Optional)

  • This parameter allows manual message content to be automatically pasted into the message box when the conversation opens.


For example: a sales representative can use the message parameter to pre-fill the message box with a personalized greeting such as: “Hi {{customer_name}}, we’ve just launched a new product that I think you’ll love! ”
When they open the conversation, the message is already prepared and ready to send with a single click.


4. templateId (Optional)

  • This parameter refers to the unique ID of a WhatsApp CloudAPI template.
  • When used, the system selects the corresponding template based on the provided template ID.

For example, your marketing team is running a campaign to inform customers about an upcoming sale. Instead of manually typing messages, they use the templateId parameter to send message templates. By clicking on a deep link, the correct template is automatically inserted into the conversation.


5. language

  • Required only if templateId is provided
  • This specifies the language of the message template.
  • Supported languages include English, Chinese, and others.


For example, your business operates across different regions, with customers who speak various languages. When creating the deep link, you will need to manually specify the appropriate language code. For instance, if you're targeting customers in Hong Kong, you would set the language parameter to “zh_hk”, ensuring they receive the message in Traditional Chinese when the deep link is activated.