better_messages_audio_call_button

info

WebSocket Version Guide

This functionality available only with WebSocket Version

Embed a voice call button anywhere on your WordPress site that starts a 1-on-1 audio call with a specified user. Works on posts, pages, custom profile templates, page builders, and any theme location that accepts shortcodes.

When to use it#

Scenario	Where you'd place the shortcode
Coaching / consulting page	On the coach's profile so clients can voice-call directly
Marketplace vendor profile	Quick voice contact button for buyer questions
Telemedicine practitioner profile	Audio-first consultation entry point
Custom member directory cards	Inline "Call" CTA per member
Author bio boxes	Below blog posts for direct author voice contact

Attributes#

Attribute	What it controls	Default
text	Button label text	`"Audio Call"`
user_id	The recipient — user who will receive the call	Post author of current WordPress post/page
url_only	Set to `1` to return only the URL (no button HTML)	`0`
class	Additional CSS classes for styling	None

Examples#

Basic — call the post author#

[better_messages_audio_call_button]

Renders a default button. Clicking starts an audio call with the current post's author.

Custom label and explicit recipient#

[better_messages_audio_call_button text="Call Support" user_id="42"]

Custom-labeled button that connects to user ID 42 (e.g., your support rep) regardless of post context.

URL only for custom styling#

<a class="my-call-btn" href="[better_messages_audio_call_button user_id="42" url_only="1"]">
  Call Now
</a>

Returns just the URL — wrap in your own anchor with custom styling.

Themed class#

[better_messages_audio_call_button text="Audio Call" class="btn-primary btn-lg"]

Adds extra CSS classes for design integration with your theme's button styles.

Frequently asked questions#

Does the button work for guests?#

Guests see the button but clicking redirects to login (or to guest-chat flow if enabled). Active calls require a session.

What happens if the recipient is offline?#

The recipient sees a missed-call system message in the conversation when they next open the thread. No queued ringing for offline users.

Will this work on the free version?#

No — voice calls require the WebSocket version. The shortcode renders, but clicking shows an upgrade notice.

Can I gate which roles see the button?#

Use a wrapping conditional in your theme, OR use Settings → Calls per-role restrictions to gate who can place calls globally.