Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to CallPage

Scalekit connector
Open markdown

The CallPage connector lets your AI agent act in each user's CallPage account. Each user connects their own CallPage API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 29 tools.

Tools
29
What they doRead · write · destructive
10 · 14 · 510 read14 write5 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. 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. Create the CallPage connection

    In AgentKit > Connections, create a CallPage connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'callpage'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize CallPage:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'callpage_calls_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their CallPage credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • callpage_call_getGet the details of one CallPage call.Read-only

    Get Call

    Get the details of one CallPage call. Needs the calls.view scope. Returns the call with status, phone number, widget, manager, timestamps, duration, recording, tags and custom fields. Use callpage_calls_list to find the call ID.

    Inputs

    call_idintegerrequired
    ID of the call. Example: 234532.
  • callpage_calls_listList CallPage call history, filtered by widget, user, status, tag, phone number or date range.Read-only

    List Calls

    List CallPage call history, filtered by widget, user, status, tag, phone number or date range. Needs the calls.view scope. Returns data with the calls: id, status, phone number, widget, manager, dates, duration, tags and fields. Use callpage_call_get for one call by ID.

    Inputs

    call_idsarray
    Only these call IDs. Example: [12].
    date_frominteger
    Start of the period as a Unix timestamp in seconds. Example: 1506981600.
    date_tointeger
    End of the period as a Unix timestamp in seconds. Example: 1509227999.
    display_hiddeninteger
    1 (default) includes hidden calls, 0 leaves them out.one of 01
    incoming_number_idsarray
    Only calls to these incoming number IDs. Example: [66, 69].
    limitinteger
    Maximum number of results (CallPage default 100). Example: 50.
    offsetinteger
    Number of results to skip, for paging (default 0). Example: 100.
    phone_numberstring
    Only calls with this phone number, in E.164 format. Example: +48123123123.
    statusesarray
    Only calls with these statuses, e.g. new, scheduled, in-progress, completed, missed, failed or cancelled. Example: ["completed", "in-progress"].
    tag_idsarray
    Only calls with these tag IDs. Example: [107, 106].
    urlstring
    Only calls from the widget installed at this URL. Example: https://example.com.
    user_idsarray
    Only calls of these user (manager) IDs. Example: [2, 15].
    widget_idsarray
    Only calls of these widget IDs. Example: [2, 3].
  • callpage_manager_getGet one manager of a CallPage widget by user and widget.Read-only

    Get Manager

    Get one manager of a CallPage widget by user and widget. Returns the manager's user details, enabled flag and business_times. Use callpage_managers_list to find the user IDs.

    Inputs

    user_idintegerrequired
    User ID, from callpage_users_list or the Users tab in CallPage. Example: 1380.
    widget_idintegerrequired
    Widget ID, from callpage_widgets_list or the Widgets tab in CallPage. Example: 3409.
  • callpage_managers_listList the managers (users assigned) of a CallPage widget.Read-only

    List Managers

    List the managers (users assigned) of a CallPage widget. Needs the managers.view scope. Returns data with each manager's user, enabled flag and business_times. Use callpage_manager_get for one manager.

    Inputs

    widget_idintegerrequired
    Widget ID, from callpage_widgets_list or the Widgets tab in CallPage. Example: 3409.
    limitinteger
    Maximum number of results (CallPage default 100). Example: 50.
    offsetinteger
    Number of results to skip, for paging (default 0). Example: 100.
  • callpage_sms_messages_listList the SMS templates of a CallPage widget.Read-only

    List SMS Messages

    List the SMS templates of a CallPage widget. Needs the sms.view scope. Returns data with each message_id, enabled flag and text (with variables such as :url, :name, :tel, :company_name). Use callpage_sms_message_update to change one.

    Inputs

    widget_idintegerrequired
    Widget ID, from callpage_widgets_list or the Widgets tab in CallPage. Example: 3409.
  • callpage_user_getGet one CallPage user by ID or email address.Read-only

    Get User

    Get one CallPage user by ID or email address. Returns the user's id, name, email, tel and role. Use callpage_users_list to find the ID.

    Inputs

    emailstring
    User's email address, instead of id. Example: test@example.com.
    idinteger
    User ID. Required unless email is given. Example: 3.
  • callpage_users_listList the users (owner, admins and managers) visible to the API key's user.Read-only

    List Users

    List the users (owner, admins and managers) visible to the API key's user. Returns data with each user's id, name, email, tel and role. Use callpage_user_get for one user.

    Inputs

    limitinteger
    Maximum number of results (CallPage default 100). Example: 50.
    offsetinteger
    Number of results to skip, for paging (default 0). Example: 100.
  • callpage_voice_messages_listList the voice messages (manager.call and visitor.call greetings) of a CallPage widget.Read-only

    List Voice Messages

    List the voice messages (manager.call and visitor.call greetings) of a CallPage widget. Needs the voice.view scope. Returns data with each message_id, enabled flag and audio file URL; defaults are English or Polish by widget language. Use callpage_voice_message_update to change one.

    Inputs

    widget_idintegerrequired
    Widget ID, from callpage_widgets_list or the Widgets tab in CallPage. Example: 3409.