Skip to content
Scalekit Docs
Talk to an EngineerDashboard

Attention connector

API KeyAIAutomationCRM & Sales

Connect to Attention for AI insights, conversations, teams, and workflows

Attention connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Make your first call

    Section titled “Make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'attention'
    const identifier = 'user_123'
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'attention_connection_report_get',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • List users, teams, team members — List users in the Attention organization, with optional filters by ID, email, or team
  • Update user, team, conversation — Update an existing Attention user’s name, password, role, seat type, or team assignments
  • Delete user — Permanently remove a user from the Attention organization, revoking their access
  • Create user, team, snippet — Create a new user in the Attention organization with an email, role, seat type, and one or more team assignments
  • Get usage report, team, scorecards summary — Get API/feature usage statistics (coaching sessions, calls viewed, comments left, snippets created, AI queries, etc.) for specified users or teams over a date range
  • Import conversation — Import an externally recorded conversation into Attention by supplying a media URL and the owning user

Common workflows

Section titled “Common workflows”
Proxy API call
const result = await actions.request({
  connectionName: 'attention',
  identifier: 'user_123',
  path: '/v1/users/me',
  method: 'GET',
});
console.log(result);
Execute a tool
const result = await actions.executeTool({
  connector: 'attention',
  identifier: 'user_123',
  toolName: 'attention_list',
  toolInput: {},
});
console.log(result);

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

attention_ask_attention#Ask a natural-language question over one or more conversations within a deal and get back an AI-generated answer. Optionally include timestamped transcript excerpts that support the answer, or synthesize a single cross-conversation summary.5 params

Ask a natural-language question over one or more conversations within a deal and get back an AI-generated answer. Optionally include timestamped transcript excerpts that support the answer, or synthesize a single cross-conversation summary.

NameTypeRequiredDescription
conversations_idsarrayrequiredList of conversation IDs to analyze. Pass an empty array to consider all conversations under the given deal.
deal_idstringrequiredIdentifier of the CRM deal that provides context for this question.
promptstringrequiredNatural-language question or instruction to run against the selected conversations.
include_timestampsbooleanoptionalIf true, includes timestamped transcript excerpts that support the answer.
summarizebooleanoptionalIf true, synthesizes all per-conversation outputs into a single combined response.
attention_calendar_events_list#List a specific user's calendar events/meetings with date-range filtering and pagination.5 params

List a specific user's calendar events/meetings with date-range filtering and pagination.

NameTypeRequiredDescription
pageintegerrequiredPage number for pagination.
sizeintegerrequiredNumber of items per page.
user_uuidstringrequiredUUID of the user whose calendar events to list.
date_fromstringoptionalFilter events starting from this date-time (inclusive, ISO 8601).
date_tostringoptionalFilter events until this date-time (inclusive, ISO 8601).
attention_connection_report_get#Get an org-wide report of which users have connected their calendar and email to Attention, including a summary count and a per-user connection status breakdown.0 params

Get an org-wide report of which users have connected their calendar and email to Attention, including a summary count and a per-user connection status breakdown.

attention_conversation_archive#Archive an Attention conversation so it's excluded from active listings, while preserving its underlying data and history.1 param

Archive an Attention conversation so it's excluded from active listings, while preserving its underlying data and history.

NameTypeRequiredDescription
conversation_idstringrequiredUnique identifier of the conversation to archive.
attention_conversation_get#Retrieve a single Attention conversation by ID, including metadata, participants, and (optionally) the detailed transcript.3 params

Retrieve a single Attention conversation by ID, including metadata, participants, and (optionally) the detailed transcript.

NameTypeRequiredDescription
conversation_idstringrequiredUnique identifier of the conversation.
detailed_transcriptbooleanoptionalIf true, includes detailed transcript data for the conversation.
include_internal_participantsbooleanoptionalIf true, includes internal participants in the response.
attention_conversation_import#Import an externally recorded conversation into Attention by supplying a media URL and the owning user. Attention will transcribe and analyze the recording asynchronously.10 params

Import an externally recorded conversation into Attention by supplying a media URL and the owning user. Attention will transcribe and analyze the recording asynchronously.

NameTypeRequiredDescription
media_urlstringrequiredURL of the call recording media file to import.
user_idstringrequiredUnique identifier of the user who owns this conversation.
application_external_idstringoptionalExternal identifier for this recording in the source application.
application_namestringoptionalName of the source application providing the recording.
conversation_started_atstringoptionalStart date-time of the conversation (ISO 8601).
conversation_titlestringoptionalTitle for the imported conversation.
opportunity_idstringoptionalIdentifier of the CRM opportunity linked to this conversation.
skip_crm_fields_calculationbooleanoptionalIf true, skips CRM field calculation for the imported conversation.
skip_opportunities_exportbooleanoptionalIf true, skips exporting data to CRM opportunities.
skip_scorecard_calculationbooleanoptionalIf true, skips scorecard calculation for the imported conversation.
attention_conversation_media_download_url_get#Generate a presigned download URL for a conversation's underlying recording/media file.1 param

Generate a presigned download URL for a conversation's underlying recording/media file.

NameTypeRequiredDescription
conversation_idstringrequiredUnique identifier of the conversation whose media should be downloaded.
attention_conversation_privacy_update#Toggle an Attention conversation between private and public visibility.2 params

Toggle an Attention conversation between private and public visibility.

NameTypeRequiredDescription
conversation_idstringrequiredUnique identifier of the conversation.
privacystringrequiredNew privacy setting for the conversation.
attention_conversation_update#Update the title and/or labels of an existing Attention conversation.3 params

Update the title and/or labels of an existing Attention conversation.

NameTypeRequiredDescription
conversation_idstringrequiredUnique identifier of the conversation.
labelsarrayoptionalArray of label strings to set on the conversation.
titlestringoptionalNew title for the conversation.
attention_conversation_upload_url_get#Get a signed URL (plus an identifier key) for uploading a local conversation media file, for use before calling attention_conversation_import.0 params

Get a signed URL (plus an identifier key) for uploading a local conversation media file, for use before calling attention_conversation_import.

attention_conversations_list#List conversations (calls, meetings) recorded in Attention, with optional date-range and filter parameters. Returns a paginated list of conversation summaries.9 params

List conversations (calls, meetings) recorded in Attention, with optional date-range and filter parameters. Returns a paginated list of conversation summaries.

NameTypeRequiredDescription
detailed_transcriptbooleanoptionalIf true, includes detailed transcript data for each conversation.
from_date_timestringoptionalStart of the date-time range for filtering conversations (ISO 8601).
hide_internalbooleanoptionalIf true, excludes conversations with no external participants.
owner_emailstringoptionalFilter conversations by the owning user's email address.
pageintegeroptionalPage number for pagination.
sizeintegeroptionalNumber of results per page.
team_idstringoptionalFilter conversations by team UUID.
titlestringoptionalFilter conversations by title.
to_date_timestringoptionalEnd of the date-time range for filtering conversations (ISO 8601).
attention_deck_create#Generate an AI slide deck/presentation from a conversation, deal, or other content source and share the resulting link with a list of recipient emails.6 params

Generate an AI slide deck/presentation from a conversation, deal, or other content source and share the resulting link with a list of recipient emails.

NameTypeRequiredDescription
context_idstringrequiredIdentifier of the content source the deck should be generated from (e.g. a deal or conversation ID).
users_to_sharearrayrequiredEmail addresses to share the generated deck with.
additional_instructionsstringoptionalSupplementary free-text guidance for deck generation.
deck_typestringoptionalPresentation category, e.g. sales_presentation.
slidesintegeroptionalTarget number of slides for the generated deck.
structurearrayoptionalCustom layout and content specification per slide.
attention_emails_list#List/search tracked emails with filters by subject, CRM account, deal, and date range — the email counterpart to the existing attention_conversations_list tool.7 params

List/search tracked emails with filters by subject, CRM account, deal, and date range — the email counterpart to the existing attention_conversations_list tool.

NameTypeRequiredDescription
crm_account_idarrayoptionalFilter emails by CRM account ID(s).
deal_uuidarrayoptionalFilter emails by deal UUID(s).
from_date_timestringoptionalStart of the date-time range for filtering emails (ISO 8601).
pageintegeroptionalPage number for pagination (starts from 1).
sizeintegeroptionalNumber of results per page (max 50).
subjectstringoptionalFilter emails by subject using case-insensitive partial matching.
to_date_timestringoptionalEnd of the date-time range for filtering emails (ISO 8601).
attention_roles_list#List available user roles in the Attention organization and their UUIDs — needed as a lookup before calling attention_user_create or attention_user_update, which require a roleUUID.0 params

List available user roles in the Attention organization and their UUIDs — needed as a lookup before calling attention_user_create or attention_user_update, which require a roleUUID.

attention_scorecard_result_create#Submit a scorecard result (coaching/QA review) for a conversation or chat in Attention, with a summary and a list of scored items.5 params

Submit a scorecard result (coaching/QA review) for a conversation or chat in Attention, with a summary and a list of scored items.

NameTypeRequiredDescription
itemsarrayrequiredArray of scored scorecard items.
scorecard_uuidstringrequiredUnique identifier of the scorecard template.
summarystringrequiredOverall summary of the scorecard result.
chat_uuidstringoptionalUnique identifier of the chat this result is attached to.
conversation_uuidstringoptionalUnique identifier of the conversation this result is attached to.
attention_scorecards_list#List scorecard templates configured in the Attention workspace, used for call review and coaching.2 params

List scorecard templates configured in the Attention workspace, used for call review and coaching.

NameTypeRequiredDescription
pageintegeroptionalPage number for pagination (1-indexed).
sizeintegeroptionalNumber of results per page.
attention_scorecards_summary_get#Get aggregate scorecard results for a scorecard across a date range, filtered by teams, users, and scorecard items. Complements attention_scorecards_list and attention_scorecard_result_create with rollup analytics such as score totals, min/max, and per-item averages.6 params

Get aggregate scorecard results for a scorecard across a date range, filtered by teams, users, and scorecard items. Complements attention_scorecards_list and attention_scorecard_result_create with rollup analytics such as score totals, min/max, and per-item averages.

NameTypeRequiredDescription
from_date_timestringrequiredStart date-time of the range to summarize (ISO 8601).
scorecard_items_uuidsarrayrequiredScorecard item IDs to include in the summary. Pass an empty array to include all items.
scorecard_uuidstringrequiredIdentifier of the scorecard template to summarize.
team_uuidsarrayrequiredTeam IDs to include in the summary. Pass an empty array to include all teams.
to_date_timestringrequiredEnd date-time of the range to summarize (ISO 8601).
user_uuidsarrayrequiredUser IDs to include in the summary. Pass an empty array to include all users.
attention_snippet_create#Create a shareable video snippet/clip from a specific time range of an Attention conversation.10 params

Create a shareable video snippet/clip from a specific time range of an Attention conversation.

NameTypeRequiredDescription
conversation_idstringrequiredUnique identifier of the conversation to clip from.
internalbooleanrequiredIf true, the snippet is only visible internally.
notify_viewsbooleanrequiredIf true, notifies the snippet owner when it's viewed.
user_uuidstringrequiredUnique identifier of the user creating this snippet.
video_end_timenumberrequiredEnd time of the clip within the conversation video, in seconds.
video_start_timenumberrequiredStart time of the clip within the conversation video, in seconds.
in_librarybooleanoptionalIf true, adds the snippet to the shared snippet library.
library_item_infoobjectoptionalLibrary folder/location details, required when in_library is true.
notesstringoptionalAdditional notes about the snippet.
titlestringoptionalTitle for the snippet.
attention_team_create#Create a new team in the Attention organization, optionally nested under a parent team.2 params

Create a new team in the Attention organization, optionally nested under a parent team.

NameTypeRequiredDescription
namestringrequiredName of the new team.
parent_team_uuidstringoptionalUUID of the parent team, if this team is part of a hierarchy.
attention_team_get#Retrieve a single Attention team by ID.1 param

Retrieve a single Attention team by ID.

NameTypeRequiredDescription
team_idstringrequiredUnique identifier of the team.
attention_team_members_list#List the members belonging to a specific Attention team.1 param

List the members belonging to a specific Attention team.

NameTypeRequiredDescription
team_idstringrequiredUnique identifier of the team.
attention_team_update#Rename an Attention team or move it under a different parent team.3 params

Rename an Attention team or move it under a different parent team.

NameTypeRequiredDescription
team_idstringrequiredUUID of the team to update.
namestringoptionalNew name for the team.
parent_team_uuidstringoptionalUUID of the new parent team.
attention_teams_list#List all teams configured in the Attention workspace.0 params

List all teams configured in the Attention workspace.

attention_usage_report_get#Get API/feature usage statistics (coaching sessions, calls viewed, comments left, snippets created, AI queries, etc.) for specified users or teams over a date range.4 params

Get API/feature usage statistics (coaching sessions, calls viewed, comments left, snippets created, AI queries, etc.) for specified users or teams over a date range.

NameTypeRequiredDescription
end_datestringrequiredEnd date for the usage report period (inclusive).
start_datestringrequiredStart date for the usage report period (inclusive).
team_uuidsarrayoptionalList of team UUIDs to include in the report. Omit to include all teams.
user_uuidsarrayoptionalList of user UUIDs to include in the report. Omit to include all users.
attention_user_create#Create a new user in the Attention organization with an email, role, seat type, and one or more team assignments. Look up role UUIDs with attention_roles_list and team UUIDs with attention_teams_list first.8 params

Create a new user in the Attention organization with an email, role, seat type, and one or more team assignments. Look up role UUIDs with attention_roles_list and team UUIDs with attention_teams_list first.

NameTypeRequiredDescription
emailstringrequiredEmail address of the new user.
first_namestringrequiredFirst name of the new user.
last_namestringrequiredLast name of the new user.
role_uuidstringrequiredUUID of the role to assign to the new user.
team_uuidsarrayrequiredTeam UUIDs the new user should belong to (at least one required).
passwordstringoptionalPassword for the new user's account.
primary_team_uuidstringoptionalWhich of the provided team_uuids should be marked as the user's primary team.
seat_typestringoptionalSeat type for the new user: listener or recording.
attention_user_delete#Permanently remove a user from the Attention organization, revoking their access.1 param

Permanently remove a user from the Attention organization, revoking their access.

NameTypeRequiredDescription
user_idstringrequiredUUID of the user to delete.
attention_user_update#Update an existing Attention user's name, password, role, seat type, or team assignments. Only the fields provided are changed.9 params

Update an existing Attention user's name, password, role, seat type, or team assignments. Only the fields provided are changed.

NameTypeRequiredDescription
user_idstringrequiredUUID of the user to update.
deals_enabledbooleanoptionalEnable or disable the deals feature for this user.
first_namestringoptionalNew first name for the user.
last_namestringoptionalNew last name for the user.
passwordstringoptionalNew password for the user's account.
role_uuidstringoptionalUUID of the new role to assign to the user.
seat_typestringoptionalSeat type for the user: listener or recording.
team_uuids_to_addarrayoptionalTeam UUIDs to add this user to.
team_uuids_to_removearrayoptionalTeam UUIDs to remove this user from.
attention_users_list#List users in the Attention organization, with optional filters by ID, email, or team.4 params

List users in the Attention organization, with optional filters by ID, email, or team.

NameTypeRequiredDescription
filter_emailstringoptionalFilter results to this user's email address.
filter_idstringoptionalFilter results to this user ID.
include_deletedbooleanoptionalIf true, includes deleted users in the response.
team_uuidstringoptionalFilter results to users in this team.