Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Plivo

Scalekit connector
Open markdown

The Plivo connector lets your AI agent work with Plivo. Scalekit handles authentication for every call, so your agent never handles credentials. It comes with 43 tools.

Tools
43
What they doRead · write · destructive
22 · 14 · 722 read14 write7 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 Plivo connection

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

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • plivo_account_getGet your Plivo account details and credit balance.Read-only

    Get Account

    Get your Plivo account details and credit balance. Returns auth_id, name, account_type, billing_mode, cash_credits, auto_recharge, address, city, state and timezone. Use plivo_account_get to check the balance before large sends.

    Inputs

    auth_idstringrequired
    Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
  • plivo_application_getGet one Plivo application.Read-only

    Get Application

    Get one Plivo application. Returns app_id, app_name, answer_url, answer_method, hangup_url, fallback_answer_url, message_url, sip_uri and default flags. Use plivo_application_get for one application. Use plivo_applications_list to browse.

    Inputs

    app_idstringrequired
    ID of the application. Example: 77506472664956353
    auth_idstringrequired
    Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
  • plivo_applications_listList the Plivo XML applications (answer, hangup and message URLs) on your account.Read-only

    List Applications

    List the Plivo XML applications (answer, hangup and message URLs) on your account. Returns meta and objects with app_id, app_name, answer_url, hangup_url, message_url and default flags. Use plivo_applications_list to find an app_id to attach to numbers.

    Inputs

    auth_idstringrequired
    Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
    app_namestring
    Only the application with this name. Example: support-ivr
    limitinteger
    Results per page, 1 to 20. Defaults to 20. Example: 20
    offsetinteger
    Number of results to skip, for paging. Example: 0
    subaccountstring
    Only results for this subaccount Auth ID. Example: SAXXXXXXXXXXXXXXXXXX
  • plivo_call_getGet the detail record of one completed Plivo call.Read-only

    Get Call

    Get the detail record of one completed Plivo call. Returns call_uuid, from_number, to_number, call_direction, answer_time, end_time, call_duration, bill_duration, hangup_cause_name and total_amount. Use plivo_call_get after a call ends. Use plivo_live_call_get while it is in progress.

    Inputs

    auth_idstringrequired
    Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
    call_uuidstringrequired
    UUID of the call. Example: eba53b9e-8fbd-45c1-9444-696d2172fbc8
  • plivo_calls_listList completed calls (call detail records) in your Plivo account.Read-only

    List Calls

    List completed calls (call detail records) in your Plivo account. Returns meta and objects with call_uuid, from_number, to_number, call_direction, call_duration, bill_duration, hangup_cause_name and total_amount. Use plivo_calls_list for call history. Use plivo_live_calls_list for calls in progress.

    Inputs

    auth_idstringrequired
    Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
    bill_duration_gtinteger
    Only calls billed for more than this many seconds. Example: 60
    call_directionstring
    Only inbound or outbound calls. Example: outboundone of inboundoutbound
    end_time_gtestring
    Only calls that ended at or after this UTC time, YYYY-MM-DD HH:MM[:ss]. Example: 2026-11-01 00:00
    end_time_ltestring
    Only calls that ended at or before this UTC time, YYYY-MM-DD HH:MM[:ss]. Example: 2026-11-02 00:00
    from_numberstring
    Only calls from this number. Example: 14151234567
    hangup_cause_codeinteger
    Only calls with this hangup cause code. Example: 4000
    hangup_sourcestring
    Only calls hung up by this side. Example: customerone of customercarrierzentrunk
    limitinteger
    Results per page, 1 to 20. Defaults to 20. Example: 20
    offsetinteger
    Number of results to skip, for paging. Example: 0
    to_numberstring
    Only calls to this number. Example: 14157654321
  • plivo_conference_getGet a running Plivo conference and its members.Read-only

    Get Conference

    Get a running Plivo conference and its members. Returns conference_name, conference_run_time, conference_member_count and members with member_id, call_uuid, muted and deaf. Use plivo_conference_get to see who is in a conference.

    Inputs

    auth_idstringrequired
    Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
    conference_namestringrequired
    Name of the conference. Example: standup
  • plivo_conferences_listList the conferences currently running on your Plivo account.Read-only

    List Conferences

    List the conferences currently running on your Plivo account. Returns conferences, a list of conference names. Use plivo_conferences_list to find live conferences. Use plivo_conference_get for members.

    Inputs

    auth_idstringrequired
    Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
  • plivo_live_call_getGet the current state of a Plivo call that is in progress.Read-only

    Get Live Call

    Get the current state of a Plivo call that is in progress. Returns call_uuid, direction, from, to, call_status, caller_name and session_start. Use plivo_live_call_get during a call. Use plivo_call_get once it has ended.

    Inputs

    auth_idstringrequired
    Your Plivo Auth ID: the same value you entered as Auth ID when connecting (it starts with MA or SA and is shown on the Plivo console overview page). Plivo puts it in every API path. Example: MAXXXXXXXXXXXXXXXXXX
    call_uuidstringrequired
    UUID of the live call. Example: eba53b9e-8fbd-45c1-9444-696d2172fbc8