Dripcel

Learn how to use Dripcel with Composio

Overview

SLUG: DRIPCEL

Description

Dripcel is a cloud-based SMS marketing platform that leverages AI and machine learning to automate and optimize customer communication campaigns.

Authentication Details

generic_api_key
stringRequired

Connecting to Dripcel

Create an auth config

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

1

Select App

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

2

Configure Auth Config Settings

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

3

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

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

Tools

Executing tools

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

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["DRIPCEL"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def 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
33invoke_llm()

Tool List

Tool Name: Delete Contact

Description

Tool to delete a contact by their cell number. use when you need to remove a contact from dripcel after confirming the msisdn.

Action Parameters

cell
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Dripcel Campaigns

Description

Tool to retrieve a list of all campaigns. use after authenticating when you need to paginate or filter campaigns.

Action Parameters

page
integer
pageSize
integer
status
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get current credit balance

Description

Tool to get current credit balance. use after authenticating and when you need to verify account balance before credit-consuming operations.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Deliveries

Description

Tool to retrieve a list of deliveries. use when you need to fetch delivered messages optionally filtered by cell or customerid.

Action Parameters

cell
string
customerId
string

Action Response

data
arrayRequired
error
string
ok
booleanRequired
successful
booleanRequired

Tool Name: Get email templates

Description

Tool to list all available email templates. use when you need to retrieve available templates before sending email campaigns.

Action Parameters

limit
integer
order
string
page
integer
search
string
sort
string

Action Response

data
arrayRequired
error
string
limit
integerRequired
message
string
page
integerRequired
success
booleanRequired
successful
booleanRequired
total
integerRequired

Tool Name: Get sales

Description

Tool to retrieve a list of all sales. use when you need comprehensive sales data for reporting or analytics.

Action Parameters

Action Response

data
arrayRequired
error
string
ok
booleanRequired
successful
booleanRequired

Tool Name: Dripcel Post Compliance Send

Description

Tool to check a list of cell numbers against campaign targeting criteria. use when ensuring suppliers comply with your campaign rules before sending messages.

Action Parameters

campaign_id
string
cells
arrayRequired
country
stringRequired

Action Response

data
object
error
string
ok
booleanRequired
successful
booleanRequired

Tool Name: Search replies based on filters

Description

Tool to search replies based on filters. use when you need to find replies by id, campaign, date range, or content.

Action Parameters

Message
string
Msisdn
string
Received
object
UserReference
string
_id
string
campaign_id
string
kind
string

Action Response

data
arrayRequired
error
string
ok
booleanRequired
successful
booleanRequired

Tool Name: Add tags to a contact

Description

Tool to add tags to a contact. use when you need to assign tag ids or tag names to an existing contact by msisdn. set create missing contact=true to auto-create the contact if it does not exist.

Action Parameters

cell
Required
create_missing_contact
boolean
tag_ids
array
tags
array

Action Response

data
objectRequired
error
string
ok
booleanRequired
successful
booleanRequired

Tool Name: Send SMS

Description

Tool to send a single sms to a contact. use when you need to deliver a targeted message immediately or schedule it for later.

Action Parameters

campaignId
string
country
stringRequired
deliveryMethod
stringDefaults to standard
message
stringRequired
schedule
string
sender
stringRequired
to
stringRequired
type
stringDefaults to plain

Action Response

data
objectRequired
error
string
successful
booleanRequired