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
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the CallPage connection
In AgentKit > Connections, create a CallPage connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'callpage'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'callpage_calls_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "callpage"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize CallPage:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="callpage_calls_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolcallpage_call_getGet the details of one CallPage call.Read-onlyGet 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-onlyList 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-onlyGet 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-onlyList 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-onlyList 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-onlyGet 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-onlyList 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-onlyList 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.
callpage_widget_getGet one CallPage widget.Read-onlyGet Widget
Get one CallPage widget. Needs the widgets.view scope. Returns the widget's id, url, description, locale_code, enabled flag, settings, departments and managers. Use callpage_widgets_list to find the widget ID.
Inputs
widget_idintegerrequired- Widget ID, from callpage_widgets_list or the Widgets tab in CallPage. Example: 3409.
callpage_widgets_listList the CallPage widgets in the account.Read-onlyList Widgets
List the CallPage widgets in the account. Needs the widgets.view scope. Returns data with each widget's id, url, description, locale, enabled flag and settings. Use callpage_widget_get for one widget.
Inputs
limitinteger- Maximum number of results (CallPage default 100). Example: 50.
offsetinteger- Number of results to skip, for paging (default 0). Example: 100.
callpage_call_field_updateSet or change the value of a custom field on a CallPage call.WriteUpdate Call Field
Set or change the value of a custom field on a CallPage call. Returns CallPage's standard hasError/message/data response. Use callpage_call_get to see the call's fields and their IDs.
- Idempotent
Inputs
call_idintegerrequired- ID of the call. Example: 13.
field_idintegerrequired- ID of the field. Example: 1421.
valuestringrequired- New value for the field (text, number or true/false as text). Example: Interested in demo.
callpage_manager_createMake a user a manager of a CallPage widget, with optional working hours.WriteCreate Manager
Make a user a manager of a CallPage widget, with optional working hours. Needs the managers.edit scope. Returns CallPage's standard response with the manager. Use callpage_widget_users_add to add several users at once.
Inputs
enabledbooleanrequired- Whether CallPage calls this manager (default true).
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.
business_timesarray- Working hours, one entry per weekday (0 = Sunday to 6 = Saturday) with enabled, start_time and end_time (HH:MM) and optionally a timezone (default Europe/Warsaw). Omit to use 9:00-17:00 Monday to Friday. Example: [{"day_of_week": 1, "enabled": true, "start_time": "09:00", "end_time": "17:00"}].
callpage_manager_updateEnable or disable a CallPage widget manager or change their working hours.WriteUpdate Manager
Enable or disable a CallPage widget manager or change their working hours. Needs the managers.edit scope. Returns CallPage's standard response with the manager. Use callpage_manager_get to read current hours.
- Idempotent
Inputs
enabledbooleanrequired- Whether CallPage calls this manager.
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.
business_timesarray- Working hours, one entry per weekday (0 = Sunday to 6 = Saturday) with enabled, start_time and end_time (HH:MM) and optionally a timezone (default Europe/Warsaw). Omit to use 9:00-17:00 Monday to Friday. Example: [{"day_of_week": 1, "enabled": true, "start_time": "09:00", "end_time": "17:00"}].
callpage_sms_message_createSet a custom SMS template for a CallPage widget.WriteCreate SMS Message
Set a custom SMS template for a CallPage widget. Needs the sms.edit scope. Returns CallPage's standard response with the message. Use callpage_sms_message_reset to go back to the default text.
Inputs
message_idstringrequired- Which SMS: visitor.dial-completed (manager contact details to the visitor after a call), visitor.call-scheduled (reminder before a scheduled call), manager.call-completed (visitor details to the manager) or user.missed-call-complaint (missed-call report).one of
visitor.dial-completedvisitor.call-scheduledmanager.call-completeduser.missed-call-complaint textstringrequired- SMS text, up to 240 characters. May use variables such as :url, :name, :tel and :company_name. Example: Thanks for calling :company_name!
widget_idintegerrequired- Widget ID, from callpage_widgets_list or the Widgets tab in CallPage. Example: 3409.
enabledboolean- Whether the SMS is sent (default true).
callpage_sms_message_updateChange the text of a CallPage widget's SMS template or turn it on or off.WriteUpdate SMS Message
Change the text of a CallPage widget's SMS template or turn it on or off. Needs the sms.edit scope. Returns CallPage's standard response with the message. Use callpage_sms_messages_list to see current texts.
- Idempotent
Inputs
message_idstringrequired- Which SMS: visitor.dial-completed (manager contact details to the visitor after a call), visitor.call-scheduled (reminder before a scheduled call), manager.call-completed (visitor details to the manager) or user.missed-call-complaint (missed-call report).one of
visitor.dial-completedvisitor.call-scheduledmanager.call-completeduser.missed-call-complaint textstringrequired- SMS text, up to 240 characters. May use variables such as :url, :name, :tel and :company_name. Example: Thanks for calling :company_name!
widget_idintegerrequired- Widget ID, from callpage_widgets_list or the Widgets tab in CallPage. Example: 3409.
enabledboolean- Whether the SMS is sent.
callpage_user_createCreate a CallPage user (admin or manager).WriteCreate User
Create a CallPage user (admin or manager). Users with an email count toward the subscription limit and can sign in; users without email are call operators only. Returns data.id of the new user. Assign the user to a widget with callpage_widget_users_add or callpage_manager_create.
Inputs
namestringrequired- User's name. Example: Test Manager.
telstringrequired- Phone number in E.164 format. Example: +48123123123.
emailstring- Email address. Leave empty for an operator who cannot sign in. Example: test@example.com.
rolestring- Role: admin or manager (default manager).one of
adminmanager
callpage_user_updateUpdate a CallPage user's name, phone, email or role.WriteUpdate User
Update a CallPage user's name, phone, email or role. Name and tel are required on every update. Returns data.id of the user. Use callpage_user_get to read the current values first.
- Idempotent
Inputs
idintegerrequired- ID of the user to update. Example: 1380.
namestringrequired- User's name. Example: Test Manager.
telstringrequired- Phone number in E.164 format. Example: +48123123123.
emailstring- Email address. Example: test@example.com.
rolestring- Role: admin or manager.one of
adminmanager
callpage_voice_message_createSet a custom voice message for a CallPage widget from an audio file URL.WriteCreate Voice Message
Set a custom voice message for a CallPage widget from an audio file URL. Needs the voice.edit scope. Returns CallPage's standard response with the message. Use callpage_voice_message_reset to go back to the default.
Inputs
enabledbooleanrequired- Whether the message is played.
message_idstringrequired- Which voice message: manager.call (greeting the manager hears on pick-up) or visitor.call (greeting for the visitor).one of
manager.callvisitor.call widget_idintegerrequired- Widget ID, from callpage_widgets_list or the Widgets tab in CallPage. Example: 3409.
filestring- Public URL of the audio recording. Example: https://example.com/greeting.mp3.
callpage_voice_message_updateChange a CallPage widget's voice message audio or turn it on or off.WriteUpdate Voice Message
Change a CallPage widget's voice message audio or turn it on or off. Needs the voice.edit scope. Returns CallPage's standard response with the message. Use callpage_voice_messages_list to see current messages.
- Idempotent
Inputs
enabledbooleanrequired- Whether the message is played.
message_idstringrequired- Which voice message: manager.call (greeting the manager hears on pick-up) or visitor.call (greeting for the visitor).one of
manager.callvisitor.call widget_idintegerrequired- Widget ID, from callpage_widgets_list or the Widgets tab in CallPage. Example: 3409.
filestring- Public URL of the new audio recording. Example: https://example.com/greeting.mp3.
callpage_widget_callStart a callback from a CallPage widget: CallPage calls the available managers and connects them to the given number; if none is available a call is scheduled.WriteCall Now
Start a callback from a CallPage widget: CallPage calls the available managers and connects them to the given number; if none is available a call is scheduled. Needs the widgets.call scope. Returns data.id of the call. Use callpage_widget_call_or_schedule to let CallPage decide; check the result with callpage_call_get.
Inputs
idintegerrequired- ID of the widget to call from. Example: 1.
telstringrequired- Phone number in E.164 format. Example: +48123123123.
department_idinteger- Only call managers of this department. Do not combine with manager_id. Example: 1.
manager_idinteger- Only call this manager. Do not combine with department_id. Example: 2.
callpage_widget_call_or_scheduleCall the visitor now if the widget is within working hours, or schedule the call for the next working hour otherwise.WriteCall Or Schedule
Call the visitor now if the widget is within working hours, or schedule the call for the next working hour otherwise. Needs the widgets.call scope. Returns data.id of the call. Use callpage_widget_call to call right away.
Inputs
idintegerrequired- ID of the widget. Example: 1.
telstringrequired- Phone number in E.164 format. Example: +48123123123.
department_idinteger- Only call managers of this department. Example: 1.
callpage_widget_createCreate a CallPage callback widget for a website.WriteCreate Widget
Create a CallPage callback widget for a website. Needs the widgets.edit scope. Returns data.id of the new widget. Next add managers with callpage_widget_users_add.
Inputs
urlstringrequired- Website URL where the widget will be installed. Example: https://example.com.
descriptionstring- Description of the widget. Example: Main website widget.
locale_codestring- Widget language code (default en): cn, cz, de, ee, en, es, fr, hu, it, lt, pl, pt, ru, se or tr.one of
cnczdeeeenesfrhuitltplptrusetr
callpage_widget_updateUpdate a CallPage widget's URL, description, language, enabled flag or settings.WriteUpdate Widget
Update a CallPage widget's URL, description, language, enabled flag or settings. Needs the widgets.edit scope. Returns data.id of the widget. url is required on every update; use callpage_widget_get to read current values.
- Idempotent
Inputs
idintegerrequired- ID of the widget to update. Example: 3409.
urlstringrequired- Website URL of the widget. Example: https://example.com.
descriptionstring- Description of the widget. Example: Main website widget.
enabledboolean- Enable (true) or disable (false) the widget.
locale_codestring- Widget language code: cn, cz, de, ee, en, es, fr, hu, it, lt, pl, pt, ru, se or tr.one of
cnczdeeeenesfrhuitltplptrusetr settingsobject- Widget settings to change, keyed by setting name, for example callerId (0, 1 or 2), countdown (28-59), call.algorithm (simulring or findme), call.recording, call.direction (ab or ba), widget.showMobile or widget.hideAfterHours. Example: {"call.recording": true, "countdown": 30}.
callpage_widget_users_addAdd one or more users as managers of a CallPage widget, optionally with working hours.WriteAdd Users To Widget
Add one or more users as managers of a CallPage widget, optionally with working hours. Needs the widgets.edit scope. Returns CallPage's standard response with the widget's managers. Use callpage_manager_update to change one manager's hours later.
Inputs
idintegerrequired- ID of the widget. Example: 3409.
user_idsarrayrequired- IDs of the users to add. Example: [1380, 1381].
business_timesarray- Working hours, one entry per weekday (0 = Sunday to 6 = Saturday) with enabled, start_time and end_time (HH:MM) and optionally a timezone (default Europe/Warsaw). Omit to use 9:00-17:00 Monday to Friday. Example: [{"day_of_week": 1, "enabled": true, "start_time": "09:00", "end_time": "17:00"}].
callpage_manager_deleteRemove a user from a CallPage widget's managers.DestructiveRemove Manager
Remove a user from a CallPage widget's managers. The user is kept. Needs the managers.edit scope. Returns CallPage's standard hasError/message response. Use callpage_manager_update with enabled false to pause instead.
- Idempotent
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_sms_message_resetReset a CallPage widget's SMS template, or all of them when message_id is empty, to the default text.DestructiveReset SMS Message
Reset a CallPage widget's SMS template, or all of them when message_id is empty, to the default text. Needs the sms.edit scope. Returns CallPage's standard hasError/message response. Use callpage_sms_message_update to set custom text.
- Idempotent
Inputs
widget_idintegerrequired- Widget ID, from callpage_widgets_list or the Widgets tab in CallPage. Example: 3409.
message_idstring- Which SMS: visitor.dial-completed (manager contact details to the visitor after a call), visitor.call-scheduled (reminder before a scheduled call), manager.call-completed (visitor details to the manager) or user.missed-call-complaint (missed-call report).one of
visitor.dial-completedvisitor.call-scheduledmanager.call-completeduser.missed-call-complaint
callpage_user_deleteDelete a CallPage user.DestructiveDelete User
Delete a CallPage user. Returns CallPage's standard hasError/message response. Use callpage_users_list to find the ID.
- Idempotent
Inputs
idintegerrequired- ID of the user to delete. Example: 1380.
callpage_voice_message_resetReset a CallPage widget's voice message, or all of them when message_id is empty, to the default.DestructiveReset Voice Message
Reset a CallPage widget's voice message, or all of them when message_id is empty, to the default. Needs the voice.edit scope. Returns CallPage's standard hasError/message response. Use callpage_voice_message_update to set custom audio.
- Idempotent
Inputs
widget_idintegerrequired- Widget ID, from callpage_widgets_list or the Widgets tab in CallPage. Example: 3409.
message_idstring- Which voice message: manager.call (greeting the manager hears on pick-up) or visitor.call (greeting for the visitor).one of
manager.callvisitor.call
callpage_widget_deleteDelete a CallPage widget.DestructiveDelete Widget
Delete a CallPage widget. Needs the widgets.edit scope. Returns CallPage's standard hasError/message response. Use callpage_widget_update with enabled false to disable instead.
- Idempotent
Inputs
idintegerrequired- ID of the widget to delete. Example: 3409.
No tools match.