🌦️ 1. Weather Information (General Utility)
You already started this with WeatherAPI.com. Let’s make it precise:
- Tool Name:
get_weather
- Description: Get current weather information for a city
API URL:
http://api.weatherapi.com/v1/current.json
- Method: GET
Headers:
[ {"key": "Content-Type", "value": "application/json"} ]
Parameters (JSON Schema):
{ "type": "object", "properties": { "q": { "type": "string", "description": "City name, state code and country code" }, "key": { "type": "string", "description": "Your WeatherAPI API Key" } }, "required": ["q", "key"] }
- Response Field:
current.condition.text
Example chat:
User: “What’s the weather in Lahore right now?” Bot → API → “It’s currently Sunny in Lahore.”
🍽️ 2. Restaurant Search (Food/Niche)
Use Yelp Fusion API (free API key from Yelp).
- Tool Name:
find_restaurants
- Description: Find top restaurants in a given city
API URL:
https://api.yelp.com/v3/businesses/search
- Method: GET
Headers:
[ {"key": "Authorization", "value": "Bearer YOUR_YELP_API_KEY"} ]
Parameters:
{ "type": "object", "properties": { "term": { "type": "string", "description": "Search term, e.g. 'pizza' or 'coffee'" }, "location": { "type": "string", "description": "City or area name" }, "limit": { "type": "integer", "description": "Number of results to return (max 10)" } }, "required": ["term", "location"] }
- Response Field:
businesses[0].name
Example chat:
User: “Find me the best sushi in New York.” Bot → Yelp API → “Top suggestion: Sushi Nakazawa.”
✈️ 3. Flight Information (Travel Niche)
Use AviationStack API (free plan).
- Tool Name:
get_flight_status
- Description: Get flight status info
API URL:
http://api.aviationstack.com/v1/flights
- Method: GET
Parameters:
{ "type": "object", "properties": { "access_key": { "type": "string", "description": "Your AviationStack API key" }, "flight_iata": { "type": "string", "description": "IATA code of the flight, e.g. 'EK215'" } }, "required": ["access_key", "flight_iata"] }
- Response Field:
data[0].flight_status
Example chat:
User: “What’s the status of Emirates EK215?” Bot → API → “The flight is currently En-Route.”
💰 4. Crypto Prices (Finance Niche)
Use CoinGecko API (free, no key).
- Tool Name:
crypto_price
- Description: Get real-time cryptocurrency prices
API URL:
https://api.coingecko.com/api/v3/simple/price
- Method: GET
Parameters:
{ "type": "object", "properties": { "ids": { "type": "string", "description": "Crypto ID (e.g. bitcoin, ethereum)" }, "vs_currencies": { "type": "string", "description": "Currency to compare against (e.g. usd)" } }, "required": ["ids", "vs_currencies"] }
- Response Field:
bitcoin.usd
(or<id>.<currency>
)
Example chat:
User: “What’s the current price of Bitcoin in USD?” Bot → API → “Bitcoin is trading at $67,450.”
📅 5. Calendar Bookings (Productivity Niche)
Use Google Calendar API or a simpler Cal.com API. Example:
- Tool Name:
book_meeting
- Description: Schedule a meeting using Cal.com
API URL:
https://api.cal.com/v1/bookings
- Method: POST
Headers:
[ {"key": "Authorization", "value": "Bearer YOUR_CAL_API_KEY"}, {"key": "Content-Type", "value": "application/json"} ]
Parameters:
{ "type": "object", "properties": { "name": { "type": "string", "description": "Name of the person" }, "email": { "type": "string", "description": "Email address" }, "date": { "type": "string", "description": "Date (YYYY-MM-DD)" }, "time": { "type": "string", "description": "Time (HH:MM)" } }, "required": ["name", "email", "date", "time"] }
- Response Field:
confirmation.id
Example chat:
User: “Book a meeting for tomorrow at 3 PM with John.” Bot → API → “Meeting booked! Confirmation ID: 82XZ1.”
🛒 6. Product Search (E-commerce Niche)
Use Fake Store API (open-source demo API).
- Tool Name:
search_products
- Description: Search products from store API
API URL:
https://fakestoreapi.com/products
- Method: GET
- Response Field:
0.title
Example chat:
User: “Show me some electronics.” Bot → API → “One option is ‘SanDisk 32GB Flash Drive’.”
📰 7. News Headlines (Media Niche)
Use NewsAPI.org.
- Tool Name:
get_news
- Description: Get latest headlines
API URL:
https://newsapi.org/v2/top-headlines
- Method: GET
Headers:
[ {"key": "Authorization", "value": "Bearer YOUR_NEWSAPI_KEY"} ]
Parameters:
{ "type": "object", "properties": { "country": { "type": "string", "description": "Country code, e.g. 'us'" }, "category": { "type": "string", "description": "Category like business, sports" } }, "required": ["country"] }
- Response Field:
articles[0].title
Example chat:
User: “Give me the latest sports news from the US.” Bot → API → “Headline: ‘Lakers secure playoff spot with last-minute win.’”
8) Currency Conversion (finance)
- Tool Name:
convert_currency
- Description: Convert an amount from one currency to another
- API URL:
https://api.exchangerate.host/convert
(no key required) - Method: GET
- Headers:
[]
- Parameters (JSON):
{
"type":"object",
"properties":{
"from":{"type":"string","description":"ISO code e.g. USD"},
"to":{"type":"string","description":"ISO code e.g. PKR"},
"amount":{"type":"number","description":"Amount to convert"}
},
"required":["from","to","amount"]
}
- Response Field:
result
Example chat: “Convert 129 USD to PKR.”
9) Stock Prices (markets)
- Tool Name:
stock_quote
- Description: Get latest stock price for a symbol
- API URL:
https://www.alphavantage.co/query
- Method: GET
- Headers:
[]
- Parameters (JSON):
{
"type":"object",
"properties":{
"function":{"type":"string","enum":["GLOBAL_QUOTE"],"description":"Use GLOBAL_QUOTE"},
"symbol":{"type":"string","description":"Ticker e.g. AAPL"},
"apikey":{"type":"string","description":"Alpha Vantage API key"}
},
"required":["function","symbol","apikey"]
}
- Response Field:
Global Quote.05. price
Example chat: “What’s AAPL trading at right now?”
10) IP Geolocation (utilities/personalization)
- Tool Name:
ip_lookup
- Description: Get location info for an IP address
- API URL:
https://ipapi.co/{ip}/json/
(put{ip}
in URL at call-time) - Method: GET
- Headers:
[]
- Parameters (JSON):
{
"type":"object",
"properties":{
"ip":{"type":"string","description":"IP v4/v6 address"}
},
"required":["ip"]
}
- Response Field:
city
Example chat: “Where is 8.8.8.8 located?”
11) Time Zone / Current Time (productivity)
- Tool Name:
current_time
- Description: Get current time for a timezone
- API URL:
http://worldtimeapi.org/api/timezone/{tz}
- Method: GET
- Headers:
[]
- Parameters (JSON):
{
"type":"object",
"properties":{
"tz":{"type":"string","description":"IANA TZ e.g. Asia/Karachi"}
},
"required":["tz"]
}
- Response Field:
datetime
Example chat: “What time is it in Oslo?”
12) Language Translation (multilingual sites)
- Tool Name:
translate_text
- Description: Translate text using LibreTranslate
- API URL:
https://libretranslate.com/translate
- Method: POST
- Headers:
[
{"key":"Content-Type","value":"application/json"}
]
- Parameters (JSON):
{
"type":"object",
"properties":{
"q":{"type":"string","description":"Text to translate"},
"source":{"type":"string","description":"Source lang e.g. en"},
"target":{"type":"string","description":"Target lang e.g. ur"},
"format":{"type":"string","enum":["text","html"],"description":"Optional"}
},
"required":["q","source","target"]
}
- Response Field:
translatedText
Example chat: “Translate ‘hello friend’ to Urdu.”
13) SMS Notifications (support/sales)
- Tool Name:
send_sms
- Description: Send an SMS via Twilio
- API URL:
https://api.twilio.com/2010-04-01/Accounts/{ACCOUNT_SID}/Messages.json
- Method: POST
- Headers: (RapidTextAI tool can use Basic Auth in URL or you can pass)
[
{"key":"Content-Type","value":"application/x-www-form-urlencoded"}
]
- Parameters (JSON):
{
"type":"object",
"properties":{
"account_sid":{"type":"string","description":"Twilio Account SID"},
"auth_token":{"type":"string","description":"Twilio Auth Token"},
"From":{"type":"string","description":"Your Twilio number"},
"To":{"type":"string","description":"Recipient E.164 e.g. +15551234567"},
"Body":{"type":"string","description":"Message text"}
},
"required":["account_sid","auth_token","From","To","Body"]
}
- Response Field:
sid
Example chat: “Text Ali that his order shipped.”
14) Email Send (lead-gen/alerts)
- Tool Name:
send_email
- Description: Send transactional email via SendGrid
- API URL:
https://api.sendgrid.com/v3/mail/send
- Method: POST
- Headers:
[
{"key":"Authorization","value":"Bearer YOUR_SENDGRID_API_KEY"},
{"key":"Content-Type","value":"application/json"}
]
- Parameters (JSON):
{
"type":"object",
"properties":{
"to":{"type":"string"},
"subject":{"type":"string"},
"html":{"type":"string","description":"HTML body"},
"from":{"type":"string","description":"Sender email"}
},
"required":["to","subject","html","from"]
}
- Response Field: (leave blank — 202 accepted on success) Example chat: “Email the brochure to sara@example.com.”
15) URL Shortening (marketing)
- Tool Name:
shorten_link
- Description: Shorten a URL using Bitly
- API URL:
https://api-ssl.bitly.com/v4/shorten
- Method: POST
- Headers:
[
{"key":"Authorization","value":"Bearer YOUR_BITLY_TOKEN"},
{"key":"Content-Type","value":"application/json"}
]
- Parameters (JSON):
{
"type":"object",
"properties":{
"long_url":{"type":"string","description":"Full URL to shorten"}
},
"required":["long_url"]
}
- Response Field:
link
Example chat: “Shorten https://alisaleem252.com/services/ai-integration.”
16) Shipping Tracking (e-commerce support)
- Tool Name:
track_shipment
- Description: Track parcel using AfterShip
- API URL:
https://api.aftership.com/v4/trackings/{slug}/{tracking_number}
- Method: GET
- Headers:
[
{"key":"aftership-api-key","value":"YOUR_AFTERSHIP_KEY"},
{"key":"Content-Type","value":"application/json"}
]
- Parameters (JSON):
{
"type":"object",
"properties":{
"slug":{"type":"string","description":"Courier slug e.g. dhl, fedex"},
"tracking_number":{"type":"string","description":"Tracking number"}
},
"required":["slug","tracking_number"]
}
- Response Field:
data.tracking.tag
Example chat: “Track FedEx 612999999999.”
17) Address Geocoding (local services)
- Tool Name:
geocode_address
- Description: Convert address to lat/long (OpenCage)
- API URL:
https://api.opencagedata.com/geocode/v1/json
- Method: GET
- Headers:
[]
- Parameters (JSON):
{
"type":"object",
"properties":{
"q":{"type":"string","description":"Full address"},
"key":{"type":"string","description":"OpenCage API key"},
"limit":{"type":"integer","default":1}
},
"required":["q","key"]
}
- Response Field:
results[0].geometry.lat
(or omit to read full) Example chat: “Geocode ‘10 Downing St, London’.”
18) Country Info (education/travel)
- Tool Name:
country_info
- Description: Get facts by country name (REST Countries)
- API URL:
https://restcountries.com/v3.1/name/{name}
- Method: GET
- Headers:
[]
- Parameters (JSON):
{
"type":"object",
"properties":{
"name":{"type":"string","description":"Country name e.g. Pakistan"}
},
"required":["name"]
}
- Response Field:
0.capital[0]
Example chat: “What’s the capital of Norway?”
19) Joke/Fun (engagement)
- Tool Name:
random_joke
- Description: Fetch a dad joke
- API URL:
https://icanhazdadjoke.com/
- Method: GET
- Headers:
[
{"key":"Accept","value":"application/json"}
]
- Parameters (JSON):
{
"type":"object",
"properties":{}
}
- Response Field:
joke
Example chat: “Tell me a joke.”
20) Helpdesk Ticket (SaaS support)
- Tool Name:
freshdesk_ticket
- Description: Create a ticket in Freshdesk
- API URL:
https://YOURDOMAIN.freshdesk.com/api/v2/tickets
- Method: POST
- Headers:
[
{"key":"Authorization","value":"Basic BASE64(API_KEY:X)"},
{"key":"Content-Type","value":"application/json"}
]
- Parameters (JSON):
{
"type":"object",
"properties":{
"email":{"type":"string"},
"subject":{"type":"string"},
"description":{"type":"string"},
"priority":{"type":"integer","enum":[1,2,3,4]},
"status":{"type":"integer","enum":[2,3,4,5]}
},
"required":["email","subject","description"]
}
- Response Field:
id
Example chat: “Open a high-priority ticket: checkout failed for order #9042.”
21) Payment Links (monetization)
- Tool Name:
create_checkout_link
- Description: Create a Stripe Payment Link for a product/price
- API URL:
https://api.stripe.com/v1/payment_links
- Method: POST
- Headers:
[
{"key":"Authorization","value":"Bearer YOUR_STRIPE_SECRET"},
{"key":"Content-Type","value":"application/x-www-form-urlencoded"}
]
- Parameters (JSON):
{
"type":"object",
"properties":{
"line_items[0][price]":{"type":"string","description":"Price ID"},
"line_items[0][quantity]":{"type":"integer","description":"Qty"}
},
"required":["line_items[0][price]","line_items[0][quantity]"]
}
- Response Field:
url
Example chat: “Create a checkout link for Price_ID=price_123 qty=1.”
22) Social Posts (marketing utilities)
- Tool Name:
post_to_telegram
- Description: Send a message to a Telegram channel
- API URL:
https://api.telegram.org/bot{BOT_TOKEN}/sendMessage
- Method: POST
- Headers:
[
{"key":"Content-Type","value":"application/json"}
]
- Parameters (JSON):
{
"type":"object",
"properties":{
"bot_token":{"type":"string"},
"chat_id":{"type":"string","description":"Channel or user id"},
"text":{"type":"string"}
},
"required":["bot_token","chat_id","text"]
}
- Response Field:
ok
Example chat: “Publish today’s promo to Telegram channel.”
23) PDF Generation (ops/sales)
- Tool Name:
make_pdf
- Description: Generate a PDF from HTML via PDFMonkey
- API URL:
https://api.pdfmonkey.io/api/v1/documents
- Method: POST
- Headers:
[
{"key":"Authorization","value":"Bearer YOUR_PDFMONKEY_API_KEY"},
{"key":"Content-Type","value":"application/json"}
]
- Parameters (JSON):
{
"type":"object",
"properties":{
"document[template_id]":{"type":"string"},
"document[editable]":{"type":"boolean","default":false},
"document[metadatas][filename]":{"type":"string"},
"document[variables]":{"type":"object","description":"Data for template"}
},
"required":["document[template_id]","document[variables]"]
}
- Response Field:
document.download_url
(you may need a second GET to poll — or leave field blank and let bot summarize) Example chat: “Generate a PDF quote for Ali, total $299.”
how to use these quickly
- open RapidTextAI → AI Chatbots → Tools → Add Tool
- copy each block’s values into your Tool form.
- for auth headers (Bearer/Basic), paste keys/tokens; for per-call secrets, include them in Parameters so the model supplies them.
- in your chatbot system prompt, tell the model when to use each tool:
“For payments use
create_checkout_link
; for shipping usetrack_shipment
; for jokes userandom_joke
; for conversions useconvert_currency
…”
Key Takeaway
Each chatbot tool follows the same pattern:
- Define Tool Name & Description.
- Provide API URL and HTTP method.
- Add Headers (if API key needed).
- Write Parameters (JSON Schema).
- Pick Response Field (to extract short answer).
This way, you can make AI-powered assistants for any niche: weather, travel, crypto, e-commerce, bookings, support, news, and more.
0 comments:
Post a Comment