Поделиться через

SeeBotRun - Link (Preview)

  • Reference

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 [email protected]
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.
Operation ID:
CreateLink

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.
Operation ID:
CreatePredefinedLink

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.
Operation ID:
DeleteLink

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

Operation ID:
DeletePredefinedLink

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

Operation ID:
GetDomains

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.
Operation ID:
GetLinks

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.
Operation ID:
UpdateLink

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.