URL shortener
Useful on WhatsApp and Instagram where long URLs are hard to read. Requires a Bitly access token.
What this tool does
Long links look messy on WhatsApp and Instagram, and customers are wary of clicking them. This tool lets your agent shorten any link with Bitly before sending it, so booking pages, payment pages and forms look clean and trustworthy. Your agent passes the full URL and gets back a short link to share. You need a Bitly access token, and Bitly’s plan limits apply. If you use a branded short domain in Bitly, the agent can share links on your own domain.
Example conversation
Customer
Can you send me the intake form?
Tool callshorten_url
long_url: https://clinic.example.com/intake-form
AI agent
Of course. Here is the form: bit.ly/clinic-intake. It takes about 5 minutes.
Customer
Thanks. Do I need to print it?
AI agent
No, just fill it in on your phone. We receive it straight away and will confirm your appointment.
Example only. Tool calls are shown so you can see when the agent uses this template. Your agent’s wording depends on your prompt and business information.
Who uses it
- Clinics sharing intake forms and consent links in a tidy format.
- Agencies sending proposal and calendar links to leads.
- Any business sharing long payment or tracking links on Instagram.
Setup
- Create a Bitly account and generate an access token under Settings → Developer settings.
- Add the custom tool and replace YOUR_BITLY_ACCESS_TOKEN in the Authorization header.
- In your prompt, tell the agent to shorten payment, booking, or tracking links before sharing them.
Copy into custom tool form
Copy each value into the matching field when you add a custom tool on the create or edit agent page. Replace any YOUR_… placeholders with your real credentials.
Tool name
Description
Endpoint URL
Paste into Endpoint URL (https:// is added automatically).
HTTP method
Tool inputs (all)
Tool input: long_url
Input name
Input type
Input description
Reference value
Use this as the request query or body value and choose “Tool input” in the form.
Request body (all)
Field name
Field value
Headers (all)
Header values are encrypted when stored. Replace placeholders with your real secrets.
Header name
Header value
Header name
Header value
