Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Kaleyra

Scalekit connector
Open markdown

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

Tools
60
What they doRead · write · destructive
25 · 25 · 1025 read25 write10 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 Kaleyra connection

    In AgentKit > Connections, create a Kaleyra 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 = 'kaleyra'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Kaleyra:', 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: 'kaleyra_balance_get',
    toolInput: { sid: 'YOUR_SID' },
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Kaleyra 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
  • kaleyra_balance_getGet your Kaleyra account's balance and usage details.Read-only

    Get Account Balance

    Get your Kaleyra account's balance and usage details. Returns the current balance and currency. Use this before large sends.

    Inputs

    sidstringrequired
    Your Kaleyra account SID (Security Identifier), shown with your API key in the Kaleyra console under Developers > API Keys. It goes in every request path. Example: HXAP16XXXXXX97IN
  • kaleyra_blocklist_getList numbers on your account's blocklist for SMS, WhatsApp or voice.Read-only

    List Blocklisted Numbers

    List numbers on your account's blocklist for SMS, WhatsApp or voice. Returns blocklisted numbers with their channel and status, up to 100 per page. Use this to see which numbers your account will not message.

    Inputs

    sidstringrequired
    Your Kaleyra account SID (Security Identifier), shown with your API key in the Kaleyra console under Developers > API Keys. It goes in every request path. Example: HXAP16XXXXXX97IN
    channelstring
    Channel to list. Example: smsone of smswhatsappvoice
    limitinteger
    Numbers per page, up to 100. Example: 100
    offsetinteger
    Numbers to skip. Example: 0
  • kaleyra_rcs_capability_checkCheck whether one phone number can receive RCS messages.Read-only

    Check RCS Capability

    Check whether one phone number can receive RCS messages. Returns the number's RCS capability. Use this before kaleyra_rcs_message_send. It sends nothing.

    Inputs

    device_addressstringrequired
    Phone number in E.164 format with the country code and no plus sign. Example: 919812345678
    sidstringrequired
    Your Kaleyra account SID (Security Identifier), shown with your API key in the Kaleyra console under Developers > API Keys. It goes in every request path. Example: HXAP16XXXXXX97IN
  • kaleyra_rcs_template_getGet one RCS template with its content and status.Read-only

    Get RCS Template

    Get one RCS template with its content and status. Returns the template. Use this to check approval status. Use kaleyra_rcs_template_history_get for its change history.

    Inputs

    sidstringrequired
    Your Kaleyra account SID (Security Identifier), shown with your API key in the Kaleyra console under Developers > API Keys. It goes in every request path. Example: HXAP16XXXXXX97IN
    template_idstringrequired
    RCS template ID. Example: 3a7370e5-ebcd-4fc3-95cc-6d1234567e8e
  • kaleyra_rcs_template_history_getGet the change and status history of an RCS template.Read-only

    Get RCS Template History

    Get the change and status history of an RCS template. Returns the history entries. Use this to see why a template was rejected or when it changed.

    Inputs

    sidstringrequired
    Your Kaleyra account SID (Security Identifier), shown with your API key in the Kaleyra console under Developers > API Keys. It goes in every request path. Example: HXAP16XXXXXX97IN
    template_idstringrequired
    RCS template ID. Example: 3a7370e5-ebcd-4fc3-95cc-6d1234567e8e
  • kaleyra_sender_ids_listList the SMS sender IDs on your Kaleyra account.Read-only

    List Sender IDs

    List the SMS sender IDs on your Kaleyra account. Returns sender IDs with description, country and status. Use this to pick a sender for kaleyra_sms_send.

    Inputs

    sidstringrequired
    Your Kaleyra account SID (Security Identifier), shown with your API key in the Kaleyra console under Developers > API Keys. It goes in every request path. Example: HXAP16XXXXXX97IN