Braspin Chat

Connect your WordPress site to Braspin Chat and offer your visitors a modern chat experience without changing theme files or writing integration code. After activation, use the dedicated Braspin Chat settings screen to connect your chat, choose where it should appear and adjust its presentation. You can apply one global configuration or use the native Gutenberg block to create a tailored experience for an individual page. Highlights

• Quick setup: connect the plugin with the chat identifier from your Braspin dashboard.
• Flexible display rules: show the chat across the site, on pages, on posts or only on selected content.
• Native Gutenberg block: add Braspin Chat directly in the block editor.
• Per-page customization: override the title, language, behavior, dimensions, positioning and colors for a specific page while keeping global defaults everywhere else.
• Clear color controls: immediately see whether each color uses the global default or a page-specific customization.
• Responsive presentation: configure floating mode, minimized state, mobile half-screen mode, resizing, dimensions and positioning.
• Custom shortcut: control shortcut visibility, colors, badge colors and position.
• Multiple languages: configure Portuguese, English or Spanish.
• Live preview: review visual choices before publishing.
• Connection diagnostics: verify SDK availability from the WordPress administration area.
• Shortcode support: use [braspin_chat] when a shortcode fits your content workflow better.
• Official delivery: load the Braspin SDK automatically from the official production CDN.

Built for both simple and tailored sites Use a single global setup when the same chat experience should appear throughout the site. For landing pages, events, campaigns or dedicated communities, add the Gutenberg block and activate only the page-level options you want to change. Every untouched option continues to inherit the global configuration. The editor clearly labels inherited values as Global default and overrides as Customized on this page, making it easy to understand what will be published. External services and privacy This plugin loads the Braspin Chat SDK from the official Braspin CDN and connects visitors to the configured Braspin WebSocket domain. These requests are necessary to display and operate the chat. No Braspin service is contacted while chat display is disabled. The SDK is loaded only on a public page where an administrator has configured and enabled the chat, or when the administrator explicitly runs the connection test. When enabled, the browser downloads executable JavaScript and CSS from the Braspin CDN and opens a connection to the configured Braspin WebSocket service. Messages and other information voluntarily submitted through the chat, together with technical information required to establish and protect the connection, can be transmitted to Braspin according to the Braspin account configuration, terms and privacy policy. The SDK may use browser storage for session, authentication and chat operation as described in the Braspin privacy policy. The WordPress plugin stores its configuration options, such as chat identifier, WebSocket URL, public key, display preferences and, when custom authentication is enabled, the encrypted fallback credential. Server constants or environment variables are recommended for that credential. When custom authentication is enabled, the plugin validates the signed-in WordPress user and sends the stable user identifier, nickname and optional profile fields to Braspin to issue a short-lived, one-use chat ticket. The OAuth access token remains server-side and is never returned to the browser. Service provider: Braspin Service URL: https://braspin.com Privacy policy: https://braspin.com/privacy Terms: https://braspin.com/terms SDK CDN: https://cdn.braspin.com/chat/ Support contact: contato@braspin.com

1. In WordPress, go to Plugins > Add New and search for Braspin Chat.
2. Select Install Now, then activate the plugin.
3. Open Braspin Chat in the WordPress side menu.
4. Enter the chat identifier created in your Braspin dashboard.
5. Enter your public key if you use features that require it, such as Super Chat.
6. Choose the language, appearance, behavior and display locations.
7. Save the settings and use the live preview or connection test to review the setup.
8. To embed a customized chat in specific content, add the Braspin Chat block in Gutenberg and enable only the page-level customizations you need.

You can also install an official ZIP by selecting Upload Plugin on the Add Plugins screen.

1.3.0

• Add secure custom authentication for signed-in WordPress users.
• Exchange the server-side OAuth credential for a one-use Braspin chat ticket without exposing the access token to the browser.
• Return the signed-in user's available WooCommerce billing data with a complete, no-store response contract.
• Show the domain, ticket and billing values ready to copy into the Braspin dashboard while leaving the login URL under the site owner's control.
• Support WordPress membership plugins that authenticate through the standard WordPress user session.
• Add encrypted fallback credential storage with wp-config.php and environment-variable precedence.
• Add per-page and per-post visibility choices to inherit the general setting, always display or never display the chat.
• Hide the chat by default on Ultimate Member login, registration, account, password reset and logout pages.
• Improve the Custom Authentication settings with a guided, user-friendly setup.
• Ignore missing or non-HTTPS user avatars instead of blocking custom authentication.
• Update the bundled SDK asset references to version 1.3.0.

1.2.1

• Expose every semantic color for independent light and black palette customization.
• Correctly serialize global, shortcode and Gutenberg overrides into colors.light and colors.black.
• Preserve legacy color settings while adopting the complete semantic palette.
• Allow pages and posts enabled in manual mode to opt into a custom chat page name.
• Complete Portuguese, English and Spanish translations for the new controls.

1.2.0

• Add compatibility with the SDK semantic colors palettes.
• Preserve existing global, shortcode and Gutenberg color settings while mapping them to the new SDK theme tokens.
• Add light, black and automatic theme selection to settings, shortcodes and Gutenberg blocks.
• Update the bundled SDK asset references to version 1.2.0.

1.1.1

• Standardize all source strings in English for WordPress.org localization.
• Complete Brazilian Portuguese and Spanish translations for PHP and Gutenberg interfaces.
• Make preset size labels translatable.

1.1.0

• Add per-page Gutenberg controls for title, language, behavior, dimensions, positioning and colors.
• Clearly identify global defaults and page-specific customizations in the block editor.
• Add a responsive editor preview and one-click restoration of global settings.
• Keep the close and open-in-new-window header controls available in regular embeds.
• Add independent controls for the close and open-in-new-window buttons in settings, Gutenberg and shortcode attributes.
• Improve the plugin directory description, installation guide, feature highlights and FAQ.

1.0.0

• Add production-ready validation, responsive settings, preview, diagnostics and Gutenberg block.
• Synchronize relevant SDK appearance, positioning and authentication options.
• Add translations, automated quality checks and WordPress.org assets.

0.0.13

• Update the SDK/plugin release version.

0.0.9

• Add signup callout to the settings header and keep the chat open by default on new installs.

0.0.8

• Preserve uppercase and lowercase characters in the chat identifier field.

0.0.7

• Update the SDK/plugin release version.

0.0.6

• Add shortcode overrides for all chat options and resize support.

0.0.5

• Add the entire site display mode and simplify display mode labels.

0.0.4

• Update the SDK/plugin release version.

0.0.3

• Move the settings screen to its own WordPress side menu with a chat icon.
• Add display modes for the entire site, pages, posts, all content, or manual per-content activation.

0.0.2

• Initial version prepared for WordPress.org review.