Opening inbox conversations directly from notifications and webhooks

You can open a conversation in the inbox directly with a URL that specifies the friend. Put this URL in a HubSpot workflow's notification email or Slack notification, or in a Lumo Workflow's Send Webhook action, and you can jump from the notification straight to that conversation. This article covers the URL format and how to add it in HubSpot and in Lumo.

URL format for opening a conversation directly

The URL starts with https://dashboard.lumo.cx/, followed by your Lumo ID, /inbox/resolve, and a value that specifies the friend. There are two ways to specify the friend.

Replace {Lumo ID} with your workspace's Lumo ID. For example, if your Lumo ID is 12345678, the URL is https://dashboard.lumo.cx/12345678/inbox/resolve?lineUserId={{line.userId}}.

The Lumo dashboard URL starts with https://dashboard.lumo.cx/. Other domains, or parameter names not listed here, won't open the conversation. Parameter names are case-sensitive.

Additional parameters

When you open by HubSpot record ID, you can add the following parameters with & as needed.

Example: https://dashboard.lumo.cx/12345678/inbox/resolve?hubspotContactId={{ contact.hs_object_id }}&lineSettingSeq=2

These two parameters aren't used when you open by LINE User ID. Because that format can't specify an account, if conversations with the same LINE User ID exist in more than one account, the conversation in the account with the most recent activity opens.

Finding your Lumo ID

You can check and copy your Lumo ID under Basic Information in Workspace Settings.

1. Open "Settings" in the navigation menu
2. Select "Workspace Settings"
3. Check "Lumo ID" under "Basic Information" and copy it with "Copy ID"

The number right after https://dashboard.lumo.cx/ in the URL of any dashboard page is also your Lumo ID.

Adding the link to HubSpot workflow notifications

For notifications sent from a HubSpot workflow, use a URL with the contact's record ID inserted. When a member opens the link, the conversation with the LINE friend linked by ID to that contact opens.

1. In the HubSpot workflow, open the action that sends the notification, such as an internal notification email or a Slack notification
2. Enter https://dashboard.lumo.cx/{Lumo ID}/inbox/resolve?hubspotContactId= in the body
3. Right after it, insert the contact's record ID ({{ contact.hs_object_id }}). Use HubSpot's token insertion and choose the contact's "Record ID"
4. Save the action

This format works when the HubSpot contact and the LINE friend are linked by ID. See Link HubSpot Contacts and LINE Friends by ID for how to link them.

Replacing LITTLE HELP CONNECT URLs

If your notifications contain LITTLE HELP CONNECT inbox URLs, replace the first part of the URL with the Lumo format. You can keep the contact record ID token as it is.

The {number} in the CONNECT URL isn't the same as Lumo's lineSettingSeq. Don't carry it over. If you need to specify an account, check the number in the Lumo inbox.

For LINE Official Accounts that have been upgraded to Lumo, links in notifications sent before you replace the URL still take you to the matching conversation in Lumo when you open them while logged in to CONNECT. For accounts that haven't been upgraded, the CONNECT inbox opens as before. CONNECT ends on December 31, 2026, so replace the URLs in your notifications early.

Adding the link to a Lumo Workflow's Send Webhook action

To notify an external chat tool from a Lumo Workflow, put a URL with the LINE User ID variable in the "Request body" of "Send Webhook".

Always write the URL in the "Request body". Variables aren't replaced in the "Webhook URL" field.

Here's an example for an incoming webhook in Slack or Google Chat.

{"text": "New message from {{line.displayName}} https://dashboard.lumo.cx/12345678/inbox/resolve?lineUserId={{line.userId}}"}

{{line.userId}} is replaced with the LINE User ID of the friend who ran the Workflow. See Variables You Can Use in Workflows for the variables you can use.

What happens when the link is opened

When you open the link, the friend's conversation opens in the inbox while you're logged in to Lumo.

• If you aren't logged in, the login page opens. After you log in, you go straight to the conversation
• Members who can open the conversation are workspace members who have the "Chat" permission and are allowed to handle the LINE Official Account
• If the conversation can't be found, "Conversation not found" appears. You can go to the inbox from "Open inbox"

When things don't work

If a link doesn't open the conversation, check the URL format and the value used to specify the friend, in that order.