Skip to main content

WordPress Chat REST API: Developer Reference for Better Messages

· 6 min read
Creator of Better Messages

WordPress sites that want to do anything custom on top of their messenger — a third-party mobile app, a Slack-style bridge, a webhook integration, a custom moderation flow, a chat-to-email gateway — need a clean API. Better Messages exposes a full REST API at /wp-json/better-messages/v1/. Every operation the React front-end performs is a documented REST call, with WordPress nonce auth for logged-in users and per-request token auth for guests.

WordPress Guest Chat: Let Visitors Message Without an Account

· 5 min read
Creator of Better Messages

The biggest conversion gap on most WordPress sites is the moment a visitor wants to ask a question and the site asks them to register first. For directory listings, marketplace product pages, customer support pages, and public community spaces — the right answer is often "let them chat without signing up." Better Messages supports guest chat: visitors enter a display name (and optionally an email), then participate in chat rooms or start threads with listing owners / vendors / support, exactly as a registered user would.

WordPress Chat File Sharing: Images, Videos, Documents

· 6 min read
Creator of Better Messages

A messaging plugin that cannot share files is barely a messaging plugin in 2026 — members expect to drag an image into a chat the way they would in WhatsApp, send a 50MB video without worrying about the connection dropping, and trust that the file is not accessible by random visitors guessing URLs. Better Messages handles all of that: drag-and-drop attachments, resumable TUS uploads for large files, browser-side image and video optimization (WebAssembly), automatic EXIF / GPS stripping, and proxy-based file access protection.

GIFs in WordPress Chat: GIPHY and KLIPY Providers

· 5 min read
Creator of Better Messages

GIFs are how casual conversation moves on social platforms — a reaction GIF answers a question faster than a sentence. WordPress sites running BuddyPress / BuddyBoss / PeepSo / Ultimate Member / FluentCommunity communities all hit the same gap: members expect a GIF button next to the message composer, and the native messengers do not have one. Better Messages adds a GIF picker that supports two providers — GIPHY (the world's largest GIF library, free API key) and KLIPY (a newer curated platform with optional ad-supported monetization).

White Label WordPress Chat Plugin (No Branding to End Users)

· 4 min read
Creator of Better Messages

Agencies, SaaS companies, and white-label community platforms running on WordPress need every part of the user experience to feel native — no "Powered by X" attribution leaking out of a plugin. Better Messages ships white-label by default: the messaging UI shows your site's branding only, with no plugin name, no "Powered by Better Messages" tag, and no third-party logo anywhere visible to end users.

Translate WordPress Chat: Multilingual Messenger Without Hacks

· 4 min read
Creator of Better Messages

WordPress sites serving members across multiple languages need the messenger UI in every member's language — buttons, menus, modals, error messages, the whole shell. Better Messages is fully translatable through the standard WordPress translation pipeline: every user-facing string is wrapped with the WordPress __() and _x() functions, exposed under the bp-better-messages text domain, and reachable through Loco Translate, WPML, Polylang, or a manually placed .po/.mo file.

WordPress Chat Email Notifications: Customizable Templates and Smart Delivery

· 5 min read
Creator of Better Messages

Email notifications are the bridge between members who live in their inbox and a messenger they only open occasionally. Done badly, they spam — every message triggers a separate email and the recipient mutes the whole thing within a week. Done well, they batch intelligently, respect the user's online state, and look like part of your site's brand. Better Messages handles email notifications with smart grouping (one email per thread per batch window), online-state awareness (no email if the user was active in the last 10 minutes), and customizable templates (Simple visual mode, Custom HTML mode, or BuddyPress template integration).

Embedded Links in WordPress Chat: YouTube, Vimeo, and Rich Previews

· 6 min read
Creator of Better Messages

A messenger that shows a pasted URL as a plain blue link is missing one of the modern messaging UX defaults: when someone shares a YouTube link, a Vimeo video, a tweet, or a product page, the messenger should expand it into a rich preview with the image, title, and (for videos) an inline player. Better Messages has supported embedded links via WordPress's native oEmbed system since the early 1.x versions — paste a URL, the preview appears in the message; click the play button, the video plays inline without leaving the chat.

Floating Chat Windows for WordPress: Mini Chats That Follow Members Across Pages

· 6 min read
Creator of Better Messages

A messenger that lives only on its own page asks members to leave whatever they were reading to check messages. A floating chat window — the Facebook-style popup that follows the user across every page of the site, with multiple conversations open at once at the bottom of the screen — keeps the conversation present without breaking the reading flow. Better Messages has shipped floating mini-chat windows since the early days, with one-tap open from BuddyPress / BuddyBoss profiles and per-conversation popups that stick across page navigations.

Real-Time Messaging on WordPress: Beyond Page-Reload Chat

· 7 min read
Creator of Better Messages

The single biggest UX gap between a WordPress messaging plugin and a serious modern messenger is delivery latency — how long it takes a sent message to appear in the recipient's window. A page-reload messenger feels like email. An AJAX-polling messenger feels like a fast email. A WebSocket-powered messenger feels like WhatsApp. Better Messages supports both shapes — AJAX polling on the free version (no separate server, runs on any WordPress hosting) and WebSocket on the paid version (instant delivery, online presence, typing indicators) — so any site can pick the right delivery mode for its scale.