Dela via


SeeBotRun - Link (Preview)

Create links dynamically for your SeeBotRun Link account.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name SeeBotRun Support
URL https://www.seebot.run/contact-us/
Email support@seebot.run
Connector Metadata
Publisher SeeBotRun
Website https://www.seebot.run
Privacy Policy https://portal.seebot.run/
Categories Communication;Marketing

The SeeBotRun Link connector allows organizations to create and manage short URLs, using the associated domains with their accounts.

Capabilities

  • Create, Update, and Delete links within your account. Manage standard short links or predefined links.
  • Create, Update, and Delete predefined links within a standard short link.

Prerequisites

An existing account with SeeBotRun and access to the Link platform. Find out how to create an account

How to get credentials

  • Have an existing account with SeeBotRun (see prerequisites).
  • Once logged in, click the Support link in the header, select Link as the application, and include the message "Requesting API key for Power Automate"
  • An API key, User Token, and User ID will be sent to you via email, securely.

Supported Operations

  • Create/Update/Delete Links Links can be created, updated, and deleted via the connector. Note: When updating links created outside of the connector, any tag and marketing details will be removed.
  • Create/Update/Delete Predefined Links Predefined links (second level links) can be created under a link when the link type is set to predefined. Predefined links are key based; the system will create the link if the key is not already taken and update the link if it is found.

Known issues and limitations

  • Our connector only supports the key elements for links when creating/editing. Tags and Marketing details are not included (to manage these, please use the administration application directly).
  • Domains, Tags, and Reports are not currently supported as part of this connector.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Create Link

Create a new short link for your account.

Create Predefined Link

Create a predefined link within a short link for a given key.

Delete Link

Delete a given short link by a provided ID.

Delete Predefined Link

Delete an existing predefined link based on the link ID and key.

Get All Domains

Get all domains available for your account.

Get Links

Return all short links available for your account.

Update Link By ID

Update an existing short link by a provided ID.

Create a new short link for your account.

Parameters

Name Key Required Type Description
SBR User ID
X-SBR-UserID True integer

The user account ID, used for verification.

SBR Token Key
X-SBR-TokenKey True string

The account token key, used for verification.

Cache
cache True boolean

Boolean value to turn caching on or off for the given link.

Domain ID
domain_id True integer

The ID for the associated domain.

Name
name True string

The friendly name of the link.

Path
path True string

The path for the link used for the redirect.

Redirect
redirect True string

The redirect result for the link when visited by a user.

Status
status True string

The status of the link.

Type
type True string

The type of the link.

Returns

Name Path Type Description
data
data array of object

data

ID
data.id integer

The ID of the link.

Name
data.name string

The friendly name of the link.

Type
data.type string

The type of the link.

Path
data.path string

The path for the link used for the redirect.

Redirect
data.redirect string

The redirect result for the link when visited by a user.

Status
data.status string

The status of the link.

Health Status
data.health_status string

The current health status of the link.

Cache
data.cache boolean

Boolean value to turn caching on or off for the given link.

Health Last Checked At
data.health_checked_at string

The date/time the health status of the link was checked.

Domain ID
data.domain_id integer

The ID for the associated domain.

Generated URL
data.generated_url string

The automatically generated URL based on the domain's URL and the link's path.

Domain ID
data.domain.id integer

The unique ID for the domain.

Domain Name
data.domain.name string

The friendly name for the domain.

Domain URL
data.domain.url string

The URL for the domain.

Domain Status
data.domain.status string

The status for the domain.

Domain Scope
data.domain.scope string

The system scope level for the domain.

Default Root URL
data.domain.default_root_url string

Default Root URL used by the domain.

Default Catchall URL
data.domain.default_catchall_url string

Default Catchall URL used by the domain.

Results Total
meta.total integer

The total number of domains in the result set, regardless of paging.

Count
meta.count integer

The total number of domains available for the current page.

Results Page
meta.page integer

The current page for the result set.

Results Total Pages
meta.pages integer

The total pages available based on the per_page and total parameters.

Results Per Page
meta.per_page integer

The number of domains to return for a given page.

Results Ordering
meta.order string

The field the ordering is based on.

Results Sorting
meta.sort string

The sorting direction to use, in combination with the order parameter.

Create a predefined link within a short link for a given key.

Parameters

Name Key Required Type Description
Link ID
id True integer

The Link ID of the predefined link being created/updated.

Key
key True string

The key of the predefined link being created/updated.

SBR User ID
X-SBR-UserID True integer

The user account ID, used for verification.

SBR Token Key
X-SBR-TokenKey True string

The account token key, used for verification.

Path
path True string

The path for the predefined link.

Redirect
redirect True string

The redirect for the predefined link.

Notes
notes string

Any notes in reference to the predefined link.

Returns

Name Path Type Description
ID
id integer

The unique ID for the predefined link.

Key
key string

The unique key for the predefined link.

Path
path string

The path used in the generated redirect for the predefined link.

Redirect
redirect string

The redirect used when a user visits the predefined link.

Notes
notes string

Internal notes used by administrators for the predefined link.

Generated URL
generated_url string

The generated short URL for the predefined link

Link ID
link_id integer

The associated link ID for the predefined link.

Client ID
client_id integer

The associated client ID for the predefined link.

Created At
created_at string

The date/time the predefined link was created.

Updated At
updated_at string

The date/time the predefined link was last updated.

Delete a given short link by a provided ID.

Parameters

Name Key Required Type Description
ID
id True integer

The ID of the link being deleted.

SBR User ID
X-SBR-UserID True integer

The user account ID, used for verification.

SBR Token Key
X-SBR-TokenKey True string

The account token key, used for verification.

Returns

Delete an existing predefined link based on the link ID and key.

Parameters

Name Key Required Type Description
Link ID
id True integer

The Link ID of the predefined link being deleted.

Key
key True string

The unique key for the predefined link being deleted.

SBR User ID
X-SBR-UserID True integer

The user account ID, used for verification.

SBR Token Key
X-SBR-TokenKey True string

The account token key, used for verification.

Returns

Get All Domains

Get all domains available for your account.

Parameters

Name Key Required Type Description
SBR User ID
X-SBR-UserID True integer

The user account ID, used for verification.

SBR Token Key
X-SBR-TokenKey True string

The account token key, used for verification.

Returns

Name Path Type Description
data
data array of object

data

ID
data.id integer

The unique ID for the domain.

Name
data.name string

The unique name for the domain.

URL
data.url string

The URL for the domain.

Status
data.status string

The status for the domain.

Scope
data.scope string

The system scope level for the domain.

Default Root URL
data.default_root_url string

Default Root URL for the domain.

Default Catchall URL
data.default_catchall_url string

Default Catchall URL for the domain.

Results Total
meta.total integer

The total number of domains in the result set, regardless of paging.

Count
meta.count integer

The total number of domains available for the current page.

Results Page
meta.page integer

The current page for the result set.

Results Total Pages
meta.pages integer

The total pages available based on the per_page and total parameters.

Results Per Page
meta.per_page integer

The number of domains to return for a given page.

Results Ordering
meta.order string

The field the ordering is based on.

Results Sorting
meta.sort string

The sorting direction to use, in combination with the order parameter.

Return all short links available for your account.

Parameters

Name Key Required Type Description
SBR User ID
X-SBR-UserID True integer

The user account ID, used for verification.

SBR Token Key
X-SBR-TokenKey True string

The account token key, used for verification.

Types
search_types True string

Comma separated list of types to search for. Types:

  • default - Standard Short Links
  • predefined - Predefined Short Links
  • trackable_chat - Trackable Short Links from SeeBotChat
  • trackable_text - Trackable Short Links from SeeBotText
Domain ID
domain_id True integer

The Domain ID to return links for.

Returns

Name Path Type Description
data
data array of object

data

ID
data.id integer

The ID of the link.

Name
data.name string

The friendly name of the link.

Type
data.type string

The type of the link.

Path
data.path string

The path for the link used for the redirect.

Redirect
data.redirect string

The redirect result for the link when visited by a user.

Status
data.status string

The status of the link.

Health Status
data.health_status string

The current health status of the link.

Cache
data.cache boolean

Boolean value to turn caching on or off for the given link.

Health Last Checked At
data.health_checked_at string

The date/time the health status of the link was checked.

Domain ID
data.domain_id integer

The ID for the associated domain.

Generated URL
data.generated_url string

The automatically generated URL based on the domain's URL and the link's path.

Domain ID
data.domain.id integer

The unique ID for the domain.

Domain Name
data.domain.name string

The friendly name for the domain.

Domain URL
data.domain.url string

The URL for the domain.

Domain Status
data.domain.status string

The status for the domain.

Domain Scope
data.domain.scope string

The system scope level for the domain.

Default Root URL
data.domain.default_root_url string

Default Root URL used by the domain.

Default Catchall URL
data.domain.default_catchall_url string

Default Catchall URL used by the domain.

Results Total
meta.total integer

The total number of links in the result set, regardless of paging.

Count
meta.count integer

The total number of links available for the current page.

Results Page
meta.page integer

The current page for the result set.

Results Total Pages
meta.pages integer

The total pages available based on the per_page and total parameters.

Results Per Page
meta.per_page integer

The number of links to return for a given page.

Results Ordering
meta.order string

The field the ordering is based on.

Results Sorting
meta.sort string

The sorting direction to use, in combination with the order parameter.

Update an existing short link by a provided ID.

Parameters

Name Key Required Type Description
ID
id True integer

The ID of the link being updated.

SBR User ID
X-SBR-UserID True integer

The user account ID, used for verification.

SBR Token Key
X-SBR-TokenKey True string

The account token key, used for verification.

Cache
cache True boolean

cache

Domain ID
domain_id True integer

The ID for the associated domain.

Name
name True string

The friendly name of the link.

Path
path True string

The path for the link used for the redirect.

Redirect
redirect True string

The redirect result for the link when visited by a user.

Status
status True string

The status of the link.

Returns

Name Path Type Description
data
data array of object

data

ID
data.id integer

The ID of the link.

Name
data.name string

The friendly name of the link.

Type
data.type string

The type of the link.

Path
data.path string

The path for the link used for the redirect.

Redirect
data.redirect string

The redirect result for the link when visited by a user.

Status
data.status string

The status of the link.

Health Status
data.health_status string

The current health status of the link.

Cache
data.cache boolean

Boolean value to turn caching on or off for the given link.

Health Last Checked At
data.health_checked_at string

The date/time the health status of the link was checked.

Domain ID
data.domain_id integer

The ID for the associated domain.

Generated URL
data.generated_url string

The automatically generated URL based on the domain's URL and the link's path.

Domain ID
data.domain.id integer

The unique ID for the domain.

Domain Name
data.domain.name string

The friendly name for the domain.

Domain URL
data.domain.url string

The URL for the domain.

Domain Status
data.domain.status string

The status for the domain.

Domain Scope
data.domain.scope string

The system scope level for the domain.

Default Root URL
data.domain.default_root_url string

Default Root URL used by the domain.

Default Catchall URL
data.domain.default_catchall_url string

Default Catchall URL used by the domain.

Results Total
meta.total integer

The total number of domains in the result set, regardless of paging.

Count
meta.count integer

The total number of domains available for the current page.

Results Page
meta.page integer

The current page for the result set.

Results Total Pages
meta.pages integer

The total pages available based on the per_page and total parameters.

Results Per Page
meta.per_page integer

The number of domains to return for a given page.

Results Ordering
meta.order string

The field the ordering is based on.

Results Sorting
meta.sort string

The sorting direction to use, in combination with the order parameter.