Callbird Documentation
One link that gives prospects everything they need to trust you — and talk to you the second they're ready.
What is Callbird?
A Callbird page replaces your Calendly / Cal.com / HubSpot Meetings / SavvyCal link with something that actually converts. Visitors land on a page showing you on video, hear from clients you've already helped, and either jump into an instant video call right now — or book time on your calendar as a fallback. All from one link.
No downloads, no apps, no account for visitors. Works as a direct link, a floating widget on your site, an inline button, or a full-page iframe embed.
What's on a Callbird page
Five pieces, each doing a specific job in the conversion. Any one of them alone is useful. The whole stack is what makes a Callbird link work better than a bare scheduling link.
Video intro
Plays automatically when a visitor lands. Separate versions for when you're online vs offline — the offline one doubles as a video voicemail.
Video testimonials
Real clients on camera, 30–90 seconds each. You send a link, they record, you approve. Text quotes don't convert; faces do.
Instant video calls
One click from visitor to live call. You're notified through Slack, SMS, or phone — and you're on video together about ten seconds later.
Booking link fallback
When you're not around, your Calendly / Cal.com / HubSpot Meetings / SavvyCal URL is the primary CTA. Visitors never hit a dead end.
Tracked links
Personalised ?ref= URLs per
prospect. See who opened it, watched your intro, booked — and which named caller is on
the line when they ring.
Embed anywhere
Floating widget on your site, an inline button you style, or a full-page iframe. Or just share the link — everywhere a URL can go.
What visitors experience
From their side, the whole thing is fast and friction-free.
Land on your page
See you on video, hear from your clients, see if you're available now
Hit Meet Now
Grant camera & mic, wait a few seconds while you're pinged
You're on a call
Both in a live browser video call. No downloads, no account.
Full walkthrough — including what happens when you're offline — in Visitor Experience.
Ways to put Callbird in front of people
Same page, four surfaces. Pick one or combine them.
Share the URL
callbird.com/yourname in your email signature,
LinkedIn bio, cold email, anywhere. Zero setup.
Floating widget
A live video bubble in the corner of your website. Your wave video loops inside it; clicks open a live call.
Inline button
A button you place and style yourself. Nothing floats. Nothing branded. Just a call-to-action.
Full-page iframe
Drop the whole Callbird page into a dedicated "Talk to us" page on your site. Visitors never leave your domain, including during the call.
Quick Start
Five minutes from sign-up to your first instant video call. Create your account, record an intro, set your hours, share your link.
Create your account
Go to callbird.com/yourname and sign up with:
- Email (magic-link sign-in — no password)
- Sign in with Google
- Sign in with Microsoft
The username you pick becomes your public page URL:
callbird.com/yourname. Usernames can't be changed later, so choose one you're happy
with.
Record your intro video
From Dashboard → Page → Intro, record a 15–30 second video introducing yourself. This plays automatically when visitors land on your page — it's the single biggest lever for whether they hit Meet Now.
You can optionally record a second "offline" intro that plays when you're not available — a short voicemail-style message pointing people to your booking link. See Intro Videos for guidance on what to say in each.
Set your availability
From Dashboard → Availability → Hours, tell Callbird when you can take calls.
- Default is Monday–Friday, 9am–5pm in your detected timezone
- Toggle individual days on/off, set start and end times per day
- Check the timezone is right — everything downstream depends on it
Strongly recommended: connect Google Calendar from Dashboard → Availability → Calendar. Callbird will then automatically hide you during meetings so you don't get interrupted on a call. See Availability Settings.
Pick how people get to you
You've got four options — use one or combine them:
Share your link
callbird.com/yourname
Email signature, LinkedIn, cold email, Twitter bio. Zero setup.
Floating widget
A bubble in the corner of your website. See Widget Embedding.
Inline button
A button you style and place anywhere. See Inline Button.
Embedded page
Your full Callbird page in an iframe. See Embedded Page.
For the widget and inline button, Callbird generates the install snippet for you at Dashboard → Company → Install — no need to hand-craft the HTML.
Decide how you want to be told
Visitors can show up any time — pick the alert channels that'll actually catch your attention. From Dashboard → Availability → Notifications you can enable:
- Slack message with one-click Answer / Be Right There / Can't Take / Book Time buttons
- SMS with a link straight into the dashboard
- Phone call with a "press 1 to connect" option
- Dashboard chirp (always on when your dashboard tab is open)
See Notifications for the details and Integrations for the one-time Slack setup.
Test your setup
- Open an incognito/private browser window
- Visit your page at
callbird.com/yourname - If you're within your hours, you should see your status as "Available"
- Click Meet Now. You (in your other browser) should see the call come in across every channel you enabled.
Personal vs Company Pages
Callbird has two kinds of public page: a personal page for an individual, and a company page for a team. They look similar at first glance, but every feature behaves a bit differently on each — this section walks through exactly how.
Personal Page
callbird.com/yourname
Calls go directly to you. One person, one voice, one availability. Best for consultants, freelancers, sales reps, founders, anyone who wants visitors to know they're reaching them.
Company Page
callbird.com/yourcompany
Calls route to whoever on the team is available. The visitor sees the team, not one person. Best for sales teams, support desks, agencies, any business where the point is "someone will pick up," not "this specific person will."
How each feature behaves on each page
The interesting stuff is in the differences. Here's how every major Callbird feature changes between the two:
| Feature | On a personal page | On a company page |
|---|---|---|
| Intro video | Your own intro (online / offline). | The company intro — or the owner's personal intro, if the company has opted in via Dashboard → Company → Intro. |
| Testimonials | Only testimonials recorded for you (scope: personal). | Only testimonials recorded for the company (scope: company). Personal testimonials don't spill onto the company page and vice versa. |
| Meet Now routing | Pings you and only you. If you're busy or offline, the visitor sees the offline state. | Pings every available team member at once. First to hit Answer wins. Others see the call was taken. |
| Availability status | Reflects your hours, your calendar, your manual toggle. | Shows "available" if any team member is available. Shows "offline" only when nobody on the team is free. |
| Team roster | Not shown — it's just you. | Team avatars with live availability dots. If more than three members, shows "+N more." |
| Booking link ("Meet Later") | Your own link (the Calendly, Cal.com, HubSpot Meetings, or SavvyCal URL set in your profile). | One shared company-wide booking link. Set once by an admin, used for every visitor. |
| Tracked links | You can create ?ref=CODE links pointing at your personal URL. |
Admins can create tracked links pointing at the company URL. Attribution is separate — visits via a personal tracked link don't mix with visits via a company one. |
| Widget / embed | The widget can target your personal page — a single-person bubble on your own site. | The widget typically targets the company page — an inbound channel for the team. |
| Who manages it | You. Each person controls their own. | Owners and admins. Regular members can't change the company page, but they can be part of who answers calls. |
Sharing the owner's intro on the company page
Small teams often want the company page to feel personal — like one identifiable person is behind it — without having to record a second, company-flavoured intro video. You can toggle this from Dashboard → Company → Intro:
Use the company-level intro (default)
Record a separate video that speaks for the company. Best when the company has its own voice distinct from any individual — or when there's no single "face" you want to put forward.
Reuse the owner's personal intro
Whatever the owner records for their personal page also plays on the company page. Best for solo founders and very small teams where the company and the person are basically the same thing.
Running both at the same time
Nothing stops you from using both. The same person can have a personal page and be part of a team with a company page — and it's often the right setup. A founder of a three-person agency might send callbird.com/jack in personal cold emails and put callbird.com/acme on the website.
| Situation | Send… | Why |
|---|---|---|
| Email signature | callbird.com/yourname | The email is from you. The link should go to you too. |
| Your website's contact page | callbird.com/yourcompany | Visitors don't care who answers — they care that someone does, fast. |
| Cold outbound to a specific prospect | callbird.com/yourname | You want them to get you — the person who reached out, not a random rep. |
| Support ticket follow-up | callbird.com/yourcompany | Whoever is on support can pick it up — they're all capable of helping. |
| Proposal or deck | callbird.com/yourname | You want continuity — the prospect should reach the rep they've been working with. |
How the URL routing works
Both page types share the same URL pattern (callbird.com/something). When someone visits a Callbird URL:
Personal pages get first match
Callbird looks for a user whose username matches the slug. If found, that's the page.
Company pages are checked next
If no personal page matches, Callbird checks if the slug is a company page. That's how one team's company slug can coexist with individual members' personal slugs without conflict.
Unclaimed slugs show a claim page
If neither matches, visitors get a "this name isn't taken yet — claim it" page. Good for finding out your username is still available.
Note: because personal pages get first match, usernames and company slugs share one global namespace. You can't have callbird.com/acme be both a person and a company — pick one.
Intro Videos
Your intro video is the thing visitors see first when they land on your Callbird page. Not a paragraph of text, not a static photo — you, on camera, saying hello. It's the single biggest lever on whether a visitor hits Meet Now.
Online vs offline — two different moments
You can record up to two versions of your intro: one for when you're available right now (the online intro), and one for when you're not (the offline intro). They play to different visitors in very different moods, and they should say different things.
Plays when you're available right now. The visitor is about to hit Meet Now — give them a reason to.
"Hey — I'm Jack, I help SaaS founders with sales hiring. Click the green button when you're ready and I'll pop up in about 10 seconds."
Plays when you're not available. It's your voicemail — thank them, explain what you do, point them to your booking link.
"Hey — you just missed me. I help SaaS founders with sales hiring. Grab 20 minutes on my calendar below and I'll come prepared."
What happens if you only record one (or neither)
Only an online intro recorded
The same video plays to every visitor, online or offline. Totally fine for starting out — and it's what most customers run for the first few weeks.
Both online and offline recorded
Callbird plays the right one automatically based on whether you're currently available. This is the ideal setup once you've got the habit.
Only an offline intro recorded
Anti-pattern — available visitors see your voicemail message. If you're only going to record one, make it the online version.
Neither recorded
Visitors land on a page with your name and profile photo only — no video. The page still works, but you're leaving the biggest conversion lever on the table.
What to actually say
- Your name and what you do, in under five seconds
- A sentence on who this page is for — the thing that makes them stay
- A clear next step — "hit the button when you're ready" for online, "grab 20 minutes on my calendar" for offline
- Don't try to pitch everything — the call itself is the pitch
Recording tips
- Face a window or a desk lamp — never have the light behind you
- Camera at eye level, look into the lens (not the screen)
- Re-record as many times as you want — visitors see the latest version immediately
- Built-in laptop mic is fine; don't agonise over audio gear
Length, format, where to record
Length: 15–30 seconds. Long enough to land a point, short enough that nobody clicks away.
Audio: on — the intro plays muted on autoplay but visitors can unmute, and most do.
Record from: Dashboard → Page → Intro for your personal intro, Dashboard → Company → Intro for the company intro.
Company pages: Your company page can either use its own company-level intro or reuse the owner's personal intro — toggled in Team settings. See Personal vs Company Pages for when each makes sense.
Video Testimonials
Client testimonials on a Callbird page aren't screenshots of LinkedIn posts or written quotes — they're short videos of real people, recorded directly into your page. Visitors see the client's face, hear their voice, and immediately know the praise is real.
30–90 seconds, on camera
Short enough for clients to actually do. Long enough to carry real warmth.
You approve before they go live
Nothing appears on your page until you've watched it and clicked approve.
No account for the client
They click a link, hit record, submit. No signup, no app, no friction.
How it works end to end
You send a client the recording link
A direct URL like callbird.com/testimonial/?username=you. They just click, grant camera permission, and hit record.
They record a short video
They see a prompt screen with your name and photo so they know who they're recording for. Re-record as many times as they want. Submit when happy.
It lands in your dashboard as pending
You get an email letting you know. The testimonial is visible only to you until you approve it.
You approve or reject
Watch the video, optionally add a short context line ("Career coaching client, 2024"), then approve — it's live on your page immediately. Reject if it's not usable and it just disappears.
Testimonials about you vs testimonials about the company
Testimonials are scoped to one page or the other — personal testimonials appear on personal pages, company testimonials appear on company pages. They don't share. Which scope a testimonial ends up in depends on the recording link the client used.
Personal testimonials
A client talking about their experience with you specifically. Shows on callbird.com/yourname, not on the company page.
Recording URL:
callbird.com/testimonial/?username=yourname
Review them at Dashboard → Page → Testimonials.
Company testimonials
A client talking about the business as a whole — not tied to one person. Shows on callbird.com/yourcompany, not on any personal page.
Recording URL:
callbird.com/testimonial/?company=yourcompany
Review them at Dashboard → Company → Testimonials.
Pick the right scope before you ask. The client won't see the difference — they just hit record — but you'll feel the difference when a glowing testimonial about your onboarding lands on your personal page instead of the company page where prospects will actually see it. If in doubt: company scope for anything visitors would consider "a review of the business."
What your client sees
Before they record, the client lands on a page with your name, your photo, and a short explainer — so it's obvious who they're recording for and why. They grant camera and microphone, hit record, and can re-record as many times as they want before submitting. No account, no friction, no marketing follow-ups.
After they submit, they see a brief confirmation page with the option to leave their email if they'd like to be notified when the testimonial goes live on your page. Optional — Callbird won't add them to anything.
Reviewing, approving, arranging
Status: pending, approved, rejected
Every testimonial arrives as pending. Approve to publish or reject to dismiss. Rejected testimonials are hidden from your dashboard view so they don't clutter it up — but the file isn't discarded, in case you change your mind.
Client context line
Short text that appears next to the client's name on your page — typically a role or relationship. "Career coaching client, 2024", "Founder of Acme", "Head of Sales, 3-year customer". You write this, not the client, so it stays consistent with how you want them represented.
Re-ordering
Approved testimonials display in an order you control. Drag to rearrange — put your strongest testimonial first so it's the one playing when the visitor is still paying attention.
Removing a testimonial
Reject an approved testimonial at any time — it disappears from your page immediately.
How to ask — the template that works
Most customers underestimate how willing clients are to do this. A 60-second video is far easier to give than a written testimonial — there's no writer's block, no editing, no formal tone to strike. The ask matters, though. A template that lands most of the time:
Subject: 60-second favour? Hey [name] — I'm putting together a page where prospects can see what working with me is actually like. Would you be up for recording a 60-second video on the result we got you? No prep needed, just click the link, hit record, say whatever comes to mind. [callbird.com/testimonial/?username=you] I only use it if you like how it came out — you'll get final say. Thanks!
- • Ask the week after a result, not a generic "any time"
- • Don't send a script — scripted testimonials are obvious on camera
- • Explicitly say they get final approval — it lowers the bar to record
- • Remind them mobile works fine — they don't need to be at a desk
Availability by plan
Testimonials are included in most paid plans. See pricing for what's on your tier.
Tracked Links
A tracked link is a personalised version of your Callbird URL for one specific prospect. Instead of sending the same callbird.com/yourname to fifty people and wondering who actually opened it, you send Sarah one version and Mike another — and then you can see which of them opened it, watched your intro, clicked book, or hit Meet Now. When one of them does call, you'll know by name it was them, not "anonymous visitor from Denver."
Send a unique link
One per prospect, tagged with their name
See what they did
Opens, plays, booking & Meet Now clicks
Know who's calling
The name carries through into the call record
What a tracked link looks like
Same Callbird URL you'd share anyway, with a short code tacked on the end:
callbird.com/yourname/?ref=a9k2p3xq
The ?ref= parameter is invisible to the recipient — they land on the same page everyone else does, with the intro, testimonials, and Meet Now button. Callbird just quietly notices they arrived via Sarah's link rather than Mike's.
Creating them
From Dashboard → Page → Analytics (for personal pages) or Dashboard → Company → Analytics (for the company page), click Create tracked link. Fill in:
- • Recipient name — required. Appears everywhere you see this link later.
- • Company — optional. Useful for sorting and for when three prospects share the same first name.
- • Email — optional. Not sent to anything — purely for your own reference so you know which email thread to follow up in.
- • Notes — optional. A line or two for context so that when Sarah calls next Tuesday you remember what you talked about three weeks ago.
Callbird generates a short ref code for you (8 characters, alphanumeric). You get the full link to copy, send, and forget about — it's active immediately.
Bulk creating a batch
If you're sending 40 cold emails this week, don't make 40 links one at a time. On the same Analytics page, click Bulk create, paste a list (CSV or one-per-line with name, company, email), and Callbird generates all the links at once. Copy the output straight into your mail merge.
What you'll see afterwards
Each tracked link accumulates stats as people visit. The Analytics page shows a row per link with:
| Metric | What it means |
|---|---|
| Views | Total times the page was loaded via this link. One person opening it twice counts twice. |
| Unique visitors | Distinct people who opened it. One person opening it five times counts once. |
| Video plays | They didn't just land — they actually watched your intro video. |
| Booking clicks | They clicked the booking link ("Meet Later"). A strong intent signal even if they didn't book the time yet. |
| Meet Now clicks | They hit the instant-call button. Strongest signal you'll get short of an actual call. |
| First & last visit | When this link was opened the first time, and the most recent time. Tells you whether a prospect is still looking. |
From tracked link to named caller
The payoff is what happens when someone actually calls. If a visitor arrives through Sarah at Acme's tracked link and then hits Meet Now, their call record in your history shows Sarah's name and company alongside the usual visitor info. You answer knowing you're about to talk to Sarah from Acme, not "visitor from Denver." The attribution carries through into Slack notifications too, so whoever's on call sees who's on the line before they pick up.
Tracked links work everywhere a Callbird URL works
You can append ?ref=CODE to any Callbird URL — a personal page, a company page, or the full-page iframe embed. Same code, same tracking, regardless of the surface:
callbird.com/yourname/?ref=a9k2p3xq — personal page
callbird.com/yourcompany/?ref=a9k2p3xq — company page
<iframe src="callbird.com/yourname/?ref=a9k2p3xq"> — iframe embed
The floating widget is typically used for inbound traffic (people finding your site), so tracked links don't usually apply there. Use tracked links with the direct URL or the iframe embed for outbound campaigns.
Where tracked links earn their keep
Cold email campaigns
Send 50 cold emails Monday — each with its own tracked link. Wednesday afternoon you've got a list of which prospects opened it, watched your intro, clicked book. That's your call list.
LinkedIn outreach
LinkedIn DMs feel like a black hole because you never know if anyone saw the link. With a tracked link you do — and you can follow up specifically with the ones who engaged.
Proposal and deck attachments
"Book a call with me" linked from the last slide of a deck. If the prospect opens the deck and hits your link, you know they got all the way to the ask.
Account-based sales
One tracked link per stakeholder at a target account. See which of the five people at Acme are actually engaging — that's your champion.
Availability by plan
Tracked links are part of the visitor-insights features on paid plans. See pricing for what your tier includes.
Getting Started
A detailed guide to setting up your Callbird account, completing onboarding, and navigating your dashboard.
Account Types
Solo Users
Personal page only (callbird.com/yourname). Perfect for
freelancers, consultants, and individual professionals.
Teams
Company page (callbird.com/company) plus personal pages
for each team member. Ideal for sales teams, support desks, and multi-person businesses.
Team functionality is managed by your organization admin from the Dashboard.
Signup Methods
Create your account at callbird.com/yourname (or
callbird.com/yourcompany) using one of these methods:
Email & Password
Traditional signup with email verification. You'll receive a confirmation email to activate your account.
One-click signup using your Google account. Your name and profile photo are imported automatically.
Microsoft
One-click signup using your Microsoft account. Works with personal and work/school accounts.
Choosing Your Username
Your username becomes your Callbird URL (callbird.com/yourname).
Choose carefully:
Requirements
- • Alphanumeric characters, hyphens, and underscores only
- • Reserved words are blocked (admin, support, api, etc.)
- • Profanity filter is enabled
Important: Usernames cannot be changed after account creation. If you need to change your username, please contact support.
Completing Onboarding
After creating your account, you'll be guided through these setup steps:
Record Your Intro Video
This video shows on your Callbird page when visitors arrive. Introduce yourself and let visitors know what to expect.
Set Your Availability Hours
Configure which days and times you're available to receive calls. Default is Monday-Friday, 9am-5pm.
Enable Notifications
Choose how you want to be notified: Slack, SMS, phone call, or dashboard alerts. You can enable multiple methods.
Connect Google Calendar (Optional)
Automatically show as busy during meetings. Highly recommended to prevent interrupted calls.
Dashboard Overview
Once setup is complete, your dashboard is your home base:
Main Dashboard
- • Your status: Current availability and toggle to go offline
- • Recent calls: List of recent incoming calls and their outcomes
- • Team availability: If you're part of an organization, see who's currently available
- • Incoming call alerts: Receive chirp notifications when calls come in
Settings Sections
- • Personal Settings: Profile, intro video, scheduling link
- • Company Settings: Organization settings (if owner/admin)
- • Hours: Weekly availability configuration
- • Notifications: Slack, SMS, phone setup
- • Google Calendar: Calendar integration setup
Availability Settings
Control when you appear available for calls. Your availability is determined by a combination of your weekly hours, calendar events, and manual toggles.
Availability States
Within your set hours, calendar is free, and you're not currently in a call.
In a meeting or on another call. Visitors see "available in X minutes" based on your calendar.
Outside your set hours or you've manually toggled off.
Setting Your Hours
Configure your weekly availability from Dashboard → Settings → Hours. Changes take effect immediately.
Configuration Options
- • Per-day toggle: Enable or disable availability for each day of the week
- • Start & end times: Set when you're available each day (e.g., 9:00 AM - 5:00 PM)
- • Timezone: All times are calculated based on your configured timezone - make sure this is correct
Default hours: New accounts are set to Monday-Friday, 9:00 AM - 5:00 PM in your detected timezone.
Google Calendar Integration
Connect your Google Calendar to automatically show as busy during meetings. Set this up from Dashboard → Settings → Google Calendar.
Setup Steps
- Click "Connect Google Account" and authorize Callbird
- Select which calendars to check (personal, work, shared calendars)
- Configure your "minimum free time" setting
How It Works
- • Callbird checks your selected calendars for "busy" events
- • Minimum free time: You won't show as available if your next meeting starts within this window (default: 30 minutes). This prevents calls being interrupted.
- • When busy, visitors see when you'll be free based on when your current event ends
Important: Calendar integration only affects your availability display. Callbird does NOT schedule meetings — use your existing scheduling tool (Calendly, Cal.com, HubSpot Meetings, SavvyCal, or anything else with a public URL) for that. Paste your scheduling link in Dashboard → Page → Profile.
Manual Toggle (Do Not Disturb)
Need to step away? Use the manual toggle in the Dashboard top bar to temporarily mark yourself unavailable.
Toggle Options
- • 1 hour: Quick break
- • Rest of day: Done for today
- • Custom duration: Set your own end time
Priority: The manual toggle overrides both your hours and calendar. It's the highest priority setting and will auto-expire at the time you set.
Team Availability
For organizations using a company page:
- • Each team member has their own independent availability settings
- • Your company page shows "Available" if any team member is available
- • Visitors see team member avatars and "X people available" on company pages
- • View team availability in real-time from Dashboard → main page
Team Setup
Manage your team members and configure how calls are routed. Admins control company-wide settings from the Dashboard.
Company Settings
Admins manage company-wide settings from Dashboard → Settings → Company (/dashboard/company/profile/).
What Admins Can Configure
-
•
Company page URL (
callbird.com/companyname) - • Organization name and logo
- • Company intro video and company testimonials
- • Widget appearance — accent color, bubble text, position, delay
- • Slack workspace connection and default booking link
Inviting Team Members
Add team members from Dashboard → Settings → Team.
How Invitations Work
- Enter the email address of the person you want to invite
- They receive an email with a unique join link
- They click the link to create their account and join your team
- They appear in your team list once they've accepted
Invite expiration: Invitations expire after 7 days. You can resend or cancel pending invites from the team list.
Seat limits: The number of team members you can have depends on your subscription plan. Pending invites count toward your seat limit.
Team Roles
| Role | Permissions |
|---|---|
| Owner |
|
| Admin |
|
| Member |
|
How Call Routing Works
When a visitor calls your company page, here's what happens:
Check Availability
System checks ALL team members for availability: within hours + calendar free + not in another call + manual toggle not off
Notify Available Members
All available team members are notified simultaneously via their configured methods (Slack, SMS, phone, dashboard)
First to Answer Wins
The first person to click "Answer" gets connected to the visitor
Others Notified
Other team members see that the call was answered by their colleague
Removing Team Members
Only Owners and Admins can remove team members.
What Happens When Someone is Removed
- • They're removed from your organization immediately
- • Their personal Callbird account remains active
-
•
They can still use their personal page (
callbird.com/theirname) - • They receive an email notification about the removal
Note: Admins cannot remove other admins or the owner. Only the owner can remove admins.
The Floating Widget
The widget is a small, live video bubble that sits in the corner of your website. It's not a chat icon — it's you, on video, waving at people who are browsing your pages. Click it and they're in a live call with you in seconds.
What visitors actually see
It's worth being specific about the visible behaviour — the widget does a fair bit of stuff automatically, and it helps to know what to expect before you ship it to production.
The bubble itself
A circular preview in the bottom corner — either left or right, your choice. Inside the bubble, your wave video loops silently (see below). If you're currently available, there's a soft pulsing ring around it — visible in peripheral vision but not obnoxious. If you're not available, the bubble goes quiet (and on most plans, hides itself entirely — see below).
The greeting bubble
A short text tooltip pops out from the bubble a few seconds after load — "We're available for an instant video call" by default, or any message you set. It hangs around for about 10 seconds, then tucks away. You can configure how long it shows (or disable it entirely).
Click to expand
Clicking the bubble opens a panel with your full Callbird experience — intro video, testimonials, Meet Now button, booking link fallback. All still inside your site, no redirect.
Collapse to close
Visitors can collapse back to the bubble without closing it completely. Once closed, the widget respects a cooldown before nudging them again on the same session.
Live availability
The widget checks your status periodically — so if you flip from available to busy mid-visit, the widget reflects it within a few seconds and the Meet Now button disables on its own. No reload needed.
Mobile
On phones, the bubble sits above the home-bar safe area, collapses the same way, and expands to full width when opened. Tap to open, tap-outside to collapse.
Install it
The cleanest way to install the widget is to copy the snippet from Dashboard → Company →
Install — Callbird fills in your details for you. Drop it just before
</body> on every page you want the widget to appear.
<!-- Callbird Widget -->
<script defer src="https://callbird.com/embed/YOUR_ORG_ID/right"></script>
-
•
The
deferattribute is non-negotiable — it keeps the script from blocking your page. -
•
type=rightputs the bubble bottom-right. Swap totype=leftfor bottom-left. - • Works on any domain — no allowlist or account on your hosting side needed.
What you can customise
All widget-level settings live in Dashboard → Company → Install. Changes take effect the next time a visitor loads your site — no re-installing the script.
| Setting | What it does |
|---|---|
| Position | Bottom-left or bottom-right. Controlled by the
type parameter in the install snippet. |
| Accent color | The ring around the bubble, the Meet Now button, and other accent elements. Pick any hex color. |
| Greeting message | The short tooltip that pops out from the bubble. Defaults to "We're available for an instant video call." |
| Greeting duration | How long the tooltip stays out before tucking back in. Seconds; set to 0 to disable the tooltip entirely. |
| Appearance delay | How long after the page loads before the bubble appears. A small delay (3–5s) avoids ambushing visitors the moment they arrive. |
| Wave video | The clip that loops inside the bubble. Record from the same Install screen. Required — without it, the widget doesn't show. |
The wave video
The wave is the short, silent clip that loops inside the bubble. It's what makes the widget look alive rather than like yet another chat icon — visitors process it in peripheral vision while they read your pricing page or blog post. Unlike your intro video, the wave has one job: catch attention.
What works
- A simple wave and smile, looking at the camera
- 3–8 seconds — anything longer just loops obviously
- Face clearly visible, friendly energy, nothing scripted
- No audio needed — browsers block autoplay audio on embedded sites anyway
What doesn't
- Anything with motion at the start and end that makes the loop jarring
- Elaborate hand gestures — the bubble is small, it all disappears
- Text on screen — unreadable at bubble size
- Busy backgrounds — your face should be the thing that pops
No wave recorded? The widget doesn't appear. This is by far the most common "why isn't my widget showing up?" cause. The floating widget specifically requires a wave video — without one, Callbird hides the bubble entirely rather than show a blank placeholder. If you don't want to record one, use the Inline Button instead.
Record your wave from Dashboard → Company → Install, alongside the install snippet.
Personal widget vs company widget
The widget can target either a personal page or a company page — the bubble looks the same, but the routing behind it is different. The Install screen will generate the right snippet for whichever you pick.
Personal widget
Clicking Meet Now pings only you. The bubble shows your avatar, plays your wave, reflects your availability.
Good for: your own website, a personal portfolio, a "talk to the founder" button.
Company widget
Clicking Meet Now pings everyone on the team who's available — first to hit Answer gets the call. The bubble shows the company wave.
Good for: your company site, a pricing page, any inbound channel where "someone from the team" is enough.
What happens when nobody's available
By default, the widget hides itself entirely when nobody's available to take a call — we'd rather show nothing than show a bubble that leads to disappointment. For company widgets, "available" means any team member is free; for personal widgets, it means you specifically.
Visitors who expand the widget while you're genuinely offline see your offline intro plus your booking link as the fallback CTA, so they still have a path forward.
When to use the widget (and when not to)
Use the widget when…
- • You want a persistent presence across every page
- • Visitors might want to talk at any moment, not just from a contact page
- • You've recorded a wave video that doesn't feel repetitive on loop
- • You're happy for it to be on-brand but not custom-styled
Reach for something else when…
- • You want a button inline with your content → Inline Button
- • You want a dedicated contact page → Embedded Page
- • You don't want to record a wave video — the widget won't appear without one
- • Your site's design doesn't tolerate floating widgets
Attribution with tracked links
The widget is an inbound channel — visitors find your site and open it — so tracked links don't usually apply. If you want to know which marketing campaign sent a specific prospect to your page and what they did once there, use Tracked Links with the direct page URL or the embedded iframe instead.
Widget not showing up?
- Record a wave video. This is the single most common cause — the widget refuses to appear without one. Dashboard → Company → Install.
- Check you pasted the snippet before
</body>, with thedeferattribute intact. - Check your org ID or username is correct in the snippet.
- For company widgets, make sure at least one team member is currently available. By default, the widget hides when nobody's around.
- Open your browser dev tools and check the Console for errors — corporate content-security policies occasionally block third-party scripts.
More troubleshooting in the Troubleshooting section.
Embedded Page
Drop your full Callbird page into your site in an iframe — intro video, testimonials, availability, Meet Now button, booking link — all the way through to the live video call itself. The visitor never leaves your domain.
When to Use
- • You want a dedicated "Talk to us" or "Contact" page on your site
- • You want the whole experience (intro, testimonials, call) in-page, not a corner bubble
- • You want visitors to stay on your domain from landing to live call
If you'd rather have a small floating button that follows visitors around every page, see Widget Embedding. For an in-content button you style yourself, see Inline Button.
Embed Your Personal Page
Your personal Callbird page lives at callbird.com/yourname. To embed it, point an iframe at the same URL:
<iframe
src="https://callbird.com/yourname/"
width="100%"
height="700"
frameborder="0"
allow="camera; microphone; fullscreen; autoplay; display-capture">
</iframe>
Replace yourname with your Callbird username.
Embed Your Company Page
Your company page lives at callbird.com/yourcompany — the same public URL, just dropped into an iframe:
<iframe
src="https://callbird.com/yourcompany/"
width="100%"
height="700"
frameborder="0"
allow="camera; microphone; fullscreen; autoplay; display-capture">
</iframe>
Replace yourcompany with your company page slug (set in Dashboard → Company → Profile).
Critical: Camera & Microphone
The allow attribute is essential. Without allow="camera; microphone" on the iframe, the browser will block access to the visitor's camera and mic and calls won't connect. Keep the full value shown above — fullscreen, autoplay, and display-capture all improve the experience.
Also required
- • HTTPS on your parent page. Browsers block camera and microphone access in cross-origin iframes served over HTTP.
- • A click to initiate. Browsers only grant camera/mic after a user gesture — visitors need to click Meet Now before they'll be prompted.
Sizing
| Dimension | What works well |
|---|---|
| Height | Minimum 600px. 700–800px gives the intro video, testimonials, and Meet Now button comfortable room without scrolling. |
| Width | 100% of the container works well; set a minimum of 350px for narrow columns. |
| Mobile | Drop to around 500–550px height on screens under 640px wide so the page isn't cropped by mobile browser chrome. |
What visitors see
Exactly what they'd see at the direct URL — just rendered inside your page:
- • Your intro video plays automatically (muted). Personal page shows your intro; company page shows the company intro (or the owner's, if you've opted into that — see Personal vs Company Pages).
- • Your availability status — available / busy / offline — with a status dot.
- • Your approved testimonials (see Video Testimonials).
- • A Meet Now button that starts an instant video call when you're available, and a Meet Later button pointing at your booking link as a fallback.
- • Company page only: team member avatars with live availability dots.
- • When they hit Meet Now, the entire video call happens inside the iframe — the visitor never leaves your site.
Attribute embedded visitors to campaigns
You can append ?ref=CODE to the iframe src to attribute visits to a specific tracked link — useful if you send the same page URL in different campaigns and want to know which one a visitor came from:
<iframe src="https://callbird.com/yourname/?ref=linkedin-q2"
allow="camera; microphone; fullscreen; autoplay; display-capture"
width="100%" height="700"></iframe>
Responsive wrapper
Drop-in CSS that makes the embed look polished and adapts on mobile:
<style>
.callbird-embed {
position: relative;
width: 100%;
max-width: 800px;
margin: 0 auto;
}
.callbird-embed iframe {
width: 100%;
height: 700px;
border: none;
border-radius: 12px;
box-shadow: 0 4px 20px rgba(0,0,0,0.1);
}
@media (max-width: 640px) {
.callbird-embed iframe { height: 550px; }
}
</style>
<div class="callbird-embed">
<iframe
src="https://callbird.com/yourcompany/"
allow="camera; microphone; fullscreen; autoplay; display-capture">
</iframe>
</div>
The Visitor Experience
A lot of the value of Callbird is in how it feels to the person on the other end — the prospect, the client, the lead. This section walks through exactly what they see from the moment they click your link to the end of the call. Knowing this in detail helps you decide what to put on your page and what to say in your intro.
Land
Meet Now
Wait
Connect
Fallback
Landing on your page
The visitor clicks your link (or opens your site's widget) and lands on a page that's mostly video — your intro starts playing automatically, muted. They see your photo, your name, your title, an availability indicator, and whatever testimonials you've approved. Below the fold: your booking link, a few nice words about what you do.
The availability indicator
A coloured dot and a short label tell them, at a glance, whether you're around:
On company pages, the page also shows avatars of team members with live availability dots. "3 people available" rather than one person.
Clicking Meet Now
The visitor hits Meet Now. Their browser asks permission for camera and microphone — they click Allow. If they've used a Callbird page before, the browser remembers and skips the prompt.
Next they see a small "are you ready?" confirmation so they're not ambushed onto video mid-thought. They hit the call button and land on the waiting screen.
The waiting screen
A friendly "Connecting…" page with a pulsing ring animation. While you (or your team) are being pinged, the visitor can:
See live updates
If you hit "Be Right There," the visitor sees it immediately. They know a human has seen them.
Type a quick note
A small chat box lets them add context ("calling about pricing") that arrives with the call.
Leave any time
Close the tab and the call cancels gracefully. Your team's notified.
The call connects
When you answer, both of you land in a live browser video call. No downloads, no Zoom link, no app install. The visitor sees your face; you see theirs. Standard controls along the bottom — mute, stop camera, leave call.
In-call chat
Runs alongside the video — useful for sharing links or numbers you'd otherwise have to spell out.
Screen share
Visitor or rep can share a screen when useful.
Who answered
On company-page calls, the visitor sees the avatar of whichever teammate actually picked up.
Mobile friendly
Calls work on mobile Safari and Chrome. The visitor doesn't need a desktop.
If you can't take the call
A few things can happen here — all designed so the visitor isn't stranded.
You hit "Can't Take" in Slack or the dashboard
The visitor sees a warm "Let's continue chatting" page with your booking link as the primary CTA. No error state, no "failed to connect" — just a graceful handoff.
Nobody answers within the timeout
After about a minute of waiting with no pickup, the visitor lands on a "Sorry we missed you" page with two options: Book a time (points at your booking link) and a simple way to chat later.
You're offline when they arrive
They never see Meet Now in the active state — instead, your offline intro plays (if you've recorded one) and the primary CTA is your booking link. Think of this as your video voicemail.
When you already know who the visitor is
If the visitor is coming from your own logged-in app — you already know their name, email, plan, account ID — you can pass that to Callbird so the call shows up with their verified identity instead of "visitor from Denver." They skip having to introduce themselves; your team answers with context. See Signed Visitor Data.
What visitors never have to do
Notifications
Configure how you get notified when visitors request a call. You can enable multiple notification methods simultaneously to ensure you never miss a call.
Dashboard Chirp
Audio alert that plays when you have your Dashboard tab open. Always enabled - no setup required.
Slack
Rich message to your chosen channel with interactive buttons to answer, respond, or book time.
SMS
Text message to your phone with caller info and a link to answer from your Dashboard.
Phone Call
Voice call to your phone with automated message. Press 1 to connect directly to the video call.
Dashboard Notifications
The dashboard chirp is always active when you have your Dashboard tab open:
- • Plays an audio alert when someone requests a call
- • Browser may require notification permission - look for the prompt on first visit
- • Shows call details: visitor name (if provided), location, and company
- • Works even if other notification methods are disabled
Slack Integration
Connect Slack to receive rich notifications with interactive buttons. Set up from Dashboard → Availability → Notifications.
Setup Steps
- Click "Connect Slack" and authorize Callbird for your workspace
- Select the channel for notifications (e.g., #callbird-calls or #sales-calls)
- Save your settings
What Slack Messages Include
- • Visitor info: Name (if provided), location (city, state, country)
- • Team status: Which team members are currently available
- • Threaded updates: All updates for a single call are threaded together
Interactive Buttons
| Answer Now | Opens the video call directly in your browser |
| Be Right There | Notifies the visitor that you're on your way |
| Can't Take | Removes you from the available list for this call |
| Book Time | Sends your scheduling link (Calendly, Cal.com, HubSpot Meetings, SavvyCal — whatever URL you've set) to the visitor |
SMS Notifications
Get text messages when calls come in. Configure from Dashboard → Availability → Notifications.
Setup
- • Enter your phone number in international format (e.g., +1 555 123 4567)
- • Toggle SMS notifications on
Message format:
"Callbird request to [your-domain] from [city], [state], [country]. Answer in Dashboard: [link]"
Phone Call Alerts
Receive actual phone calls when visitors want to connect.
How It Works
- You receive a phone call from Callbird
- Automated voice message tells you who's calling and from where
- Press 1 to connect - you'll be transferred directly to the video call
Setup
- • Enter your phone number in international format
- • Toggle phone call notifications on
- • Same phone number can be used for both SMS and phone alerts
Emails You'll Get
Separate from the per-call channels above, Callbird also emails you for a handful of account events. These always go to the email address on your account.
- • Account and magic-link sign-in: one-click sign-in links when you log in with email.
- • Team invites: invitation emails when an admin invites you to a team, plus a confirmation when you accept.
- • Testimonials: a note when a new testimonial is submitted for your review, and (optionally) a note to the client when their testimonial goes live.
- • Trial & billing: a reminder three days before your trial ends, plus receipts and any payment-failure warnings.
- • Missed-call summaries so you can follow up on the visitors you couldn't catch live.
Account emails aren't something you toggle off — they only go out for things you genuinely need to know about.
Per-User Settings
For teams: Each team member configures their own notification preferences independently. You can enable all methods, just one, or none (the dashboard chirp still works when your tab is open). Notifications are only sent to team members who are currently available — within hours, calendar free, manual toggle on.
Integrations
Callbird talks to a handful of services you probably already use — Slack for notifications, Google Calendar for availability, Calendly-style tools for the booking-link fallback, Google and Microsoft for sign-in. Here's how each one plugs in.
Slack
The best way to get calls. When a visitor hits Meet Now, Callbird posts a rich, interactive message to a Slack channel you pick. One click to answer, one click to book them in later, one click to decline gracefully.
Installing the Slack app
- Go to Dashboard → Company → Slack
- Click Connect Slack and authorise Callbird for your workspace (standard Slack OAuth — the scopes are listed on the approval screen)
- Pick the channel you want notifications posted to — a dedicated
#callbirdor whatever routes to whoever should answer - Save. Send yourself a test call from an incognito window to confirm everything works.
What the Slack message looks like
- • Visitor name (verified if you're passing signed visitor data, best-effort otherwise), city and country
- • If they arrived via a tracked link, the recipient name is shown so you know it's Sarah from Acme before you pick up
- • Which team members are currently available and which are busy, so nobody has to guess whether someone else is already on it
- • Four buttons: Answer Now, Be Right There, Can't Take, Book Time (covered below)
- • Follow-up notifications for the same call are threaded under the original message so channels don't get noisy
What each button does
| Answer Now | Opens the live video call in your browser. You're on with the visitor a second later. |
| Be Right There | The visitor sees "someone's on their way" and keeps waiting. Use this when you're finishing a thought or grabbing a coffee. |
| Can't Take | You personally decline. On company pages, teammates get another chance to answer. On personal pages, the visitor sees the "catch up later" fallback immediately. |
| Book Time | Sends the visitor your booking link instead of a live call. The gracious way to handle "I can't right now but I want to talk." |
More on the call flow itself in Notifications.
Google Calendar
Connect your Google Calendar and Callbird automatically hides you while you're in a meeting. Nothing worse than being on a customer call and having a Meet Now ping fire at the same time.
Connecting your calendar
- Go to Dashboard → Availability → Calendar
- Click Connect Google Account and authorise Callbird
- Pick which calendars should count for busy/free — usually your work calendar, sometimes also your personal one if you want PTO to show as unavailable
- Set your minimum free time threshold (default: 10 minutes)
The minimum-free-time threshold
Callbird won't show you as available if your next meeting is less than this many minutes away. A 5-minute buffer isn't enough to start a video call, so defaulting to 10 minutes prevents you from getting pulled into something you can't finish.
If your meetings run long and you don't want to risk overlap, bump this to 15 or 20. If you'd rather be available up to the wire and trust yourself to end a call on time, drop it to 5.
Read-only, always. Callbird only reads when you're busy — it never adds events to your calendar, never reads meeting titles, never sees attendees. If you want Callbird to book meetings for you, use a scheduling tool (Calendly, Cal.com, HubSpot Meetings, SavvyCal, or any other booking URL) and paste the link into your Callbird profile — see below.
More on how availability is calculated in Availability Settings.
Calendly, Cal.com, SavvyCal, HubSpot Meetings
Callbird is about instant calls — the "talk now" moment. But not every visitor can talk now, and you don't want those visitors to hit a dead end. Paste your booking link into your profile and Callbird shows it as the fallback whenever you're not available, whenever a visitor clicks "Book Time" in Slack, or whenever someone just prefers to schedule.
Setting your booking link
- • Personal link: Dashboard → Page → Profile → Booking link. Used on your personal page.
- • Company link: Dashboard → Company → Profile → Booking link. One company-wide link used on the company page and in Slack "Book Time" button actions.
Any booking tool with a public URL works — Calendly, Cal.com, SavvyCal, HubSpot Meetings, Zcal, Google Calendar booking pages, your own scheduling page if you've built one. Callbird doesn't care which, and there's no OAuth step — just paste the URL.
Callbird doesn't schedule meetings. It's the "not right now" answer, not the scheduling tool itself. Keep using whatever you already use — Callbird just knows where to send visitors when the call can't happen live.
Sign in with Google or Microsoft
At signup and login, you can use Google or Microsoft instead of the email magic link. Same account either way — you can add additional sign-in methods later from your profile. Useful if your organisation uses SSO, or if you just prefer one-click over email round-trips.
What's not integrated yet
Some asks come up often enough that it's worth being explicit about what isn't available today:
- • Public REST API. On the roadmap but not shipped. If you need to pass verified visitor data into a call right now, Signed Visitor Data is the way to do it.
- • Native mobile apps. Callbird runs entirely in the browser — mobile Safari and Chrome both work for calls, so you can take a call from your phone without an app install. No dedicated iOS/Android app today.
- • Zapier / Make / native CRM integrations. Not yet. Signed visitor data plus tracked links covers most of the practical ground around "know who's calling" — the rest is planned alongside the public API.
- • Microsoft Teams notifications. Slack is the only chat integration today.
If one of these is a blocker for you, let us know — we prioritise roadmap based on which gaps actually stop customers from adopting.
Signed Visitor Data
Pass verified visitor information from your system to Callbird. When visitors are logged into your site, your team sees their verified identity during calls.
What It Does
- • Pre-populate visitor info (name, email, company, phone, custom fields) when they're logged into your site
- • Team sees a Verified badge - they know the data is trustworthy and came from your system
- • Pass custom fields (account ID, plan type, MRR, etc.) visible in Slack notifications and the dashboard
How It Works
Generate API Secret
Get your API secret from Dashboard → Settings → Company → API. Store this securely on your server.
Sign Visitor Data on Your Server
When a logged-in user visits your site, create a JSON payload with their info and sign it using HMAC-SHA256.
Pass to Callbird URL
Include the base64-encoded data and signature as URL parameters when linking to your Callbird page.
Verification
Callbird verifies the signature. Valid data shows with the Verified badge. Invalid or expired signatures are silently ignored.
Integration Examples
Use this code on your server to sign visitor data. Never expose your API secret in client-side code.
<?php
$secret_key = 'YOUR_API_SECRET';
$data = json_encode([
'name' => $visitor_name,
'email' => $visitor_email,
'company' => $visitor_company,
'phone' => $visitor_phone,
'custom' => [
'account_id' => '12345',
'plan' => 'enterprise'
],
'timestamp' => time()
]);
$signature = hash_hmac('sha256', $data, $secret_key);
$encoded = base64_encode($data);
// Add to your Callbird page URL:
$callbird_url = "https://callbird.com/yourcompany"
. "?visitor_data=" . urlencode($encoded)
. "&signature=" . urlencode($signature);
Tip: The timestamp must be within 5 minutes of the current time for the signature to be valid. This prevents replay attacks.
Available Fields
| Field | Type | Description |
|---|---|---|
| name | string | Visitor's full name |
| string | Visitor's email address | |
| company | string | Visitor's company name |
| phone | string | Visitor's phone number |
| custom | object | Any additional key-value pairs (e.g., account_id, plan, MRR) |
| timestamp | integer | Required. Unix timestamp (must be within 5 minutes of current time) |
Security Considerations
Important: Keep your API secret secure.
- • Never expose your secret key in frontend/client-side code
- • Generate signed data server-side only
- • Rotate your key immediately if you suspect it's been compromised
Built-in Security Features
- • Timestamp validation: Prevents replay attacks - signatures expire after 5 minutes
- • HMAC-SHA256: Industry-standard cryptographic signing
- • Graceful fallback: Invalid signatures are silently ignored - visitors can still call normally
FAQ
Quick answers to frequently asked questions.
General
Can visitors join calls without creating an account?
Yes! Visitors never need a Callbird account. They simply click and connect via their browser. No downloads, no signups required.
Can I use Callbird on mobile?
Yes. Visitors can call from any mobile browser. Team members can receive Slack, SMS, and phone notifications on mobile. The Dashboard works on mobile but is optimized for desktop.
What browsers are supported?
Chrome, Firefox, Safari, and Edge are fully supported. We recommend using the latest version of any of these browsers.
Can I use my own domain?
Currently, Callbird pages are at callbird.com/yourname. Custom domains are not supported yet. However, the widget and embedded page work on any domain.
Calls & Availability
What happens if no one answers?
The visitor sees a "waiting for someone to answer" screen. After a timeout, they're redirected to a page with options including "Meet Later" (if you've configured a scheduling link).
Can I schedule calls with Callbird?
Callbird is for instant calls, not scheduling. The "Meet Later" button links to YOUR scheduling tool (Calendly, Cal.com, HubSpot Meetings, SavvyCal, or any booking URL). Paste your scheduling link in Dashboard → Page → Profile.
How does availability work for teams?
Each team member has independent availability settings. The company page shows "Available" if ANY team member is available. Incoming calls notify all available members, and the first to answer gets connected.
Can I be available outside my set hours?
Your set hours are the only time you'll appear available. However, you can always adjust your hours in real-time from the Dashboard if needed.
Teams & Billing
How many team members can I have?
This depends on your subscription plan. Check the pricing page for details. Pending invitations count toward your seat limit.
Can I change my username?
Usernames cannot be changed after account creation. If you need to change it, please contact support.
How do I cancel my subscription?
Go to Dashboard → Settings → Billing → Cancel. Your access continues until the end of your current billing period.
What happens if a team member is removed?
They're removed from your organization immediately but their personal Callbird account remains active. They can still use their personal page.
Privacy & Security
Are calls encrypted?
Yes. All video calls are encrypted using industry-standard WebRTC protocols.
Do you sell visitor data?
No. We never sell your data or your visitors' data. See our privacy policy for full details.
Technical
Does the widget slow down my website?
No. The widget script uses the defer attribute and loads asynchronously after your page content. It won't block page rendering.
Can I use Callbird with a single-page app (SPA)?
Yes. The widget script works with SPAs. If using the inline button with your own routing, the script will automatically handle elements with the callbird-btn class.
Is there an API?
Not yet. A public REST API is on the roadmap but isn't available today. If you need to pass verified visitor data from your own app into Callbird calls, Signed Visitor Data is supported now.
What ports need to be open for video calls?
Callbird uses WebRTC for video. If you're behind a corporate firewall, you may need to allow UDP ports 1025-65535 for optimal performance. TURN fallback over TCP/443 is available.
Still have questions?
We're here to help. Reach out and we'll get back to you as soon as possible.
Contact SupportTroubleshooting
Common issues and how to fix them. If you can't find your answer here, contact support.
Widget Not Appearing
The floating widget isn't showing on your website.
1. Check Script Placement
Verify the script tag is placed just before </body> and includes the defer attribute.
2. Verify Org ID
Double-check your organization ID is correct. Find it in Dashboard → Company → Install.
3. Record a wave video
Most common cause! The widget requires a wave video to appear — without one, Callbird hides the bubble. Record yours from Dashboard → Company → Install, or see The Floating Widget for what makes a good wave.
4. Check Availability
Widget only shows when at least one team member is available. Verify someone is within their hours and not busy.
5. Check Browser Console
Open browser developer tools (F12) and check for JavaScript errors in the Console tab.
Showing Offline When You're Available
Your status shows offline even though you should be available.
Check Hours Settings
- • Is your timezone set correctly?
- • Is today enabled in your hours?
- • Is the current time within your configured range?
Check Manual Toggle
Is "Do Not Disturb" active? Check the toggle in the Dashboard top bar. It auto-expires at the time you set.
Check Google Calendar
- • Any busy events blocking your availability?
- • Is your "minimum free time" setting too long?
- • Check if a calendar event is marked as "busy"
For Company Pages
If it's a company page showing offline, check that ALL team members aren't unavailable or in calls.
Notifications Not Working
Not receiving Slack, SMS, or phone notifications.
Slack Notifications
- • Verify Slack workspace is connected
- • Check channel name matches exactly (including #)
- • Ensure the Callbird bot has access to the channel
- • Try reconnecting Slack in Dashboard → Settings → Notifications
SMS Notifications
- • Phone number must be in international format (+1...)
- • Verify phone number is at least 5 characters
- • Check that SMS is toggled on
All Notification Types
Important: Notifications are only sent to team members who are currently AVAILABLE. Check your hours, calendar, and manual toggle.
Call Not Connecting
Video or audio isn't working during calls.
Browser Permissions
Check camera/microphone permissions. Click the lock icon in your browser's address bar and ensure both are set to "Allow".
Embedded Page Issues
If using an iframe embed, verify you have allow="camera; microphone" in the iframe tag.
Try a Different Browser
Chrome, Firefox, and Safari are recommended. Some other browsers may have compatibility issues.
Network Issues
- • VPN may block WebRTC connections
- • Corporate firewalls may block video ports
- • Try on a different network to test
"Invalid Link" Error
Visitor sees an "Invalid link" message when trying to join a call.
Why This Happens
- • Call tokens are one-time use and cannot be reused
- • Refreshing the call page invalidates the token
- • Tokens are stored in the session and cleared after use
Solution
The visitor needs to go back to the main Callbird page and click "Meet Now" again to generate a new token.
Video/Audio Quality Issues
Choppy video, audio cutting out, or lag during calls.
Bandwidth Requirements
Recommended minimum: 1.5 Mbps upload and download. Test your speed at fast.com.
Quick Fixes
- • Close other video apps (Zoom, Teams, etc.)
- • Use a wired connection if possible
- • Move closer to your WiFi router
- • Close bandwidth-heavy tabs/downloads
Adaptive Quality
Callbird automatically adjusts video quality based on connection speed. If quality drops, it's likely a bandwidth issue.