WordPress live chat: add Talvo with one script tag

Add Talvo live chat to a WordPress site with one script tag. The plan check, the steps and the limits are below.

Plan

WordPress.com's own pages set the plan rules for WordPress.com sites. Its header-code guide says the WPCode route is available on Personal, Premium, Business and Commerce plans, and free sites must upgrade. Its code page says JavaScript needs a plugin-enabled plan with hosting features activated.

Checked

Steps

  1. Copy your snippetIn Talvo, open Settings → General → Chat widget and copy the script tag.
  2. Install WPCodeIn wp-admin, go to Plugins, choose Add New, search for WPCode, then install and activate it.
  3. Open Header & FooterIn wp-admin, go to Code Snippets, then Header & Footer.
  4. Paste into FooterPaste the tag into the Footer box exactly as copied, then click Save Changes.
  5. Check the served HTMLConfirm the script tag is in the page's served HTML, not added later by something else. Talvo's install help says the same.
  6. Test in a private windowLoad a few pages in a private window and send yourself a test message.

The script tag

<script async src="https://talvo.chat/_api/widget/loader?app=YOUR_APP_ID"></script>

Replace YOUR_APP_ID with the app ID from the script tag you copy from Settings → General → Chat widget. Placement: Code Snippets, Header & Footer (WPCode), Footer box. The Header box also works, because Talvo's loader waits for the page body.

What it does and does not do

Does

  • Adds a chat launcher site-wide on self-hosted WordPress
  • Routes chats to the Talvo inbox, not wp-admin
  • Identifies signed-in users with Talvo's WordPress file in wp-content/mu-plugins and a secret in wp-config.php
  • Answers from your published help articles, knowledge files and snippets, citing the article it used
  • Hides the chat on pages you list in Talvo's settings, such as /checkout or a /blog/* path

Does not

  • Install from the WordPress plugin directory: Talvo has no WordPress plugin
  • Run on WordPress.com unless your plan allows plugins and scripts
  • Connect to WooCommerce: no order lookups, refunds or product data
  • The Powered by Talvo badge stays on the widget: it cannot be removed

Questions

What do I use to add the script to WordPress?

This guide uses a header and footer plugin such as WPCode, which gives you a Footer box for the tag. WordPress.com's header-code guide uses the same Header or Footer box.

Where do I paste the Talvo script?

With WPCode installed, go to Code Snippets, then Header & Footer. Paste the tag into the Footer box exactly as copied from Talvo's Settings → General → Chat widget, then click Save Changes.

Does Talvo have a WordPress plugin?

No. Talvo has no plugin in the WordPress plugin directory. It installs as a script tag, and replies come from the Talvo inbox rather than wp-admin.

Can I add the script on WordPress.com?

Only on a plan that allows it. WordPress.com's header-code guide names its Personal, Premium, Business and Commerce plans and says free sites must upgrade. Its code page says JavaScript needs a plugin-enabled plan with hosting features activated.

Why is the chat not showing after I pasted the script?

Start with the page source. Confirm the script tag is in the served HTML, and check the browser console for a blocked request. Talvo's install help lists both checks.

Can Talvo identify logged-in WordPress users?

Yes, with a small server-side setup. Talvo's identity setup includes a file for wp-content/mu-plugins that signs each user's ID with a secret kept in wp-config.php.

Does Talvo work with WooCommerce?

The widget runs on a WooCommerce site, but Talvo has no WooCommerce integration: no order lookups, refunds or product data in the chat.

Sources

Start on the Free plan

The Free plan covers 2 teammates with no credit card. Paste the tag, send yourself a test message and see the inbox.

Create a free workspace