Callpage | Composio Docs

Overview

SLUG: CALLPAGE

Description

CallPage is a lead capture tool that enables businesses to connect with website visitors through immediate phone callbacks, enhancing lead generation and sales conversion rates.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Callpage

Create an auth config

Use the dashboard to create an auth config for the Callpage toolkit. This allows you to connect multiple Callpage accounts to Composio for agents to use.

Select App

Navigate to the Callpage toolkit page and click “Setup Integration”.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 from composio.types import auth_scheme
3 
4 # Replace these with your actual values
5 callpage_auth_config_id = "ac_YOUR_CALLPAGE_CONFIG_ID" # Auth config ID created above
6 user_id = "0000-0000-0000"  # UUID from database/app
7 
8 composio = Composio()
9 
10 def authenticate_toolkit(user_id: str, auth_config_id: str):
11     # Replace this with a method to retrieve an API key from the user.
12     # Or supply your own.
13     user_api_key = input("[!] Enter API key")
14 
15     connection_request = composio.connected_accounts.initiate(
16         user_id=user_id,
17         auth_config_id=auth_config_id,
18         config={"auth_scheme": "API_KEY", "val": user_api_key}
19     )
20 
21     # API Key authentication is immediate - no redirect needed
22     print(f"Successfully connected Callpage for user {user_id}")
23     print(f"Connection status: {connection_request.status}")
24     
25     return connection_request.id
26 
27 
28 connection_id = authenticate_toolkit(user_id, callpage_auth_config_id)
29 
30 # You can verify the connection using:
31 connected_account = composio.connected_accounts.get(connection_id)
32 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Callpage toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["CALLPAGE"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

CALLPAGE_GET_ALL_MANAGERS

Tool Name: Get All Managers

Description

Tool to retrieve a list of managers for a specific widget with pagination. use when you need to page through all managers assigned to a widget after confirming its id.

Action Parameters

limit

integerDefaults to 100

offset

integer

widget_id

integerRequired

Action Response

data

arrayRequired

error

string

errorCode

integerRequired

hasError

booleanRequired

message

stringRequired

successful

booleanRequired

CALLPAGE_GET_ALL_SMS_MESSAGES

Tool Name: Get All SMS Messages

Description

Tool to retrieve all sms messages for a widget. use when you need to fetch both default and custom sms templates after confirming the widget exists.

Action Parameters

widget_id

integerRequired

Action Response

data

arrayRequired

error

string

errorCode

integerRequired

hasError

booleanRequired

message

stringRequired

successful

booleanRequired

CALLPAGE_GET_ALL_USERS

Tool Name: Get All Users

Description

Tool to retrieve a list of all users with pagination. use when you need to page through all users in your callpage account to synchronize or audit user records.

Action Parameters

limit

integerDefaults to 100

offset

integer

Action Response

data

arrayRequired

error

string

errorCode

integerRequired

hasError

booleanRequired

message

stringRequired

CALLPAGE_GET_ALL_WIDGETS

Tool Name: Get All Widgets

Description

Tool to retrieve a list of widgets with pagination. use when you need to page through all widgets after api authentication.

Action Parameters

limit

integerDefaults to 100

offset

integer

Action Response

data

arrayRequired

error

string

errorCode

integerRequired

hasError

booleanRequired

message

stringRequired

CALLPAGE_GET_API_ROOT

Tool Name: Get API Root

Description

Tool to get the root api greeting. use to verify connectivity and retrieve the initial api greeting after setting the api key.

Action Parameters

Action Response

data

arrayRequired

error

string

errorCode

integerRequired

hasError

booleanRequired

message

stringRequired

successful

booleanRequired

CALLPAGE_GET_SMS_STATISTICS

Tool Name: Get SMS Statistics

Description

Tool to retrieve statistical data about sms messages. use when you need summary counts of sms messages for a given widget.

Action Parameters

widget_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALLPAGE_GET_WIDGET

Tool Name: Get Widget

Description

Tool to retrieve details of a specific widget by id. use when you have a widget id and need its complete configuration.

Action Parameters

integerRequired

Action Response

data

objectRequired

error

string

errorCode

integerRequired

hasError

booleanRequired

message

stringRequired

CALLPAGE_GET_MANAGER_STATUS_STATISTICS

Tool Name: Get Manager Status Statistics

Description

Tool to retrieve statistical data about manager statuses. use when you need summary counts of enabled and disabled managers for a specific widget.

Action Parameters

limit

integer

offset

integer

widget_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALLPAGE_GET_WIDGET_STATUS_STATISTICS

Tool Name: Get Widget Status Statistics

Description

Tool to retrieve statistical data about widget statuses. use when you need counts of enabled vs disabled widgets.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALLPAGE_POST_CREATE_VOICE_MESSAGE

Tool Name: Create Voice Message

Description

Tool to create a custom voice message for a widget. use when you need to customize greeting messages for manager or visitor after setting widget locale.

Action Parameters

enabled

booleanRequired

file

string

message_id

stringRequired

widget_id

integerRequired

Action Response

data

objectRequired

error

string

errorCode

integer

hasError

booleanRequired

message

string

successful

booleanRequired

CALLPAGE_POST_CREATE_WIDGET

Tool Name: Create Widget

Description

Tool to create a new widget. use when you need to install a widget on your site and retrieve its id.

Action Parameters

description

string

locale_code

string

url

stringRequired

Action Response

data

objectRequired

error

string

errorCode

integer

hasError

booleanRequired

message

string

successful

booleanRequired

CALLPAGE_POST_DELETE_WIDGET

Tool Name: Delete Widget by Id

Description

Tool to delete a widget by id. use when you need to remove an existing widget after verifying its id. example: delete widget with id 3409.

Action Parameters

integerRequired

Action Response

data

null

error

string

errorCode

integerRequired

hasError

booleanRequired

message

stringRequired

successful

booleanRequired

CALLPAGE_POST_RESET_SMS

Tool Name: Reset SMS

Description

Tool to reset sms messages to default for a widget. use when you need to restore default sms templates after customization tests.

Action Parameters

message_id

string

widget_id

integerRequired

Action Response

data

null

error

string

errorCode

integerRequired

hasError

booleanRequired

message

stringRequired

successful

booleanRequired

CALLPAGE_POST_RESET_VOICE_MESSAGE

Tool Name: Reset Voice Messages

Description

Tool to reset voice messages to default for a widget. use when you need to clear custom messages and revert to system defaults. example: reset all voice messages for widget with id 123.

Action Parameters

message_id

string

widget_id

integerRequired

Action Response

data

null

error

string

errorCode

integer

hasError

booleanRequired

message

string

successful

booleanRequired

CALLPAGE_POST_UPDATE_MANAGER

Tool Name: Update Manager

Description

Tool to update an existing manager. use when you need to modify a manager's availability or business hours after retrieving their record.

Action Parameters

business_times

array

enabled

booleanRequired

user_id

integerRequired

widget_id

integerRequired

Action Response

data

objectRequired

error

string

errorCode

integer

hasError

booleanRequired

message

string

successful

booleanRequired

CALLPAGE_POST_UPDATE_WIDGET

Tool Name: Update Widget

Description

Tool to update an existing widget. use when you need to change widget url, description, settings, language, or enabled state.

Action Parameters

description

string

enabled

boolean

integerRequired

locale_code

string

settings

array

url

stringRequired

Action Response

data

objectRequired

error

string

errorCode

integer

hasError

booleanRequired

message

string

successful

booleanRequired

CALLPAGE_POST_WIDGET_CALL_OR_SCHEDULE

Tool Name: Widget Call or Schedule

Description

Tool to initiate or schedule a call via widget. use when you need to call immediately or schedule at the first available timeslot through a widget.

Action Parameters

department_id

integer

integerRequired

tel

stringRequired

Action Response

data

objectRequired

error

string

errorCode

integer

hasError

booleanRequired

message

string

successful

booleanRequired