Skip to main content
The Tiny Talk WordPress plugin gives you full control over which agents appear on which pages — without touching code.

​
Installation

  1. In your WordPress admin, go to Plugins → Add New
  2. Search for Tiny Talk
  3. Click Install Now, then Activate
Or download the plugin from wordpress.org/plugins/tiny-talk and upload the ZIP via Plugins → Add New → Upload Plugin.

​
Adding agents

Go to Settings → Tiny Talk and add your agents. You’ll need the Agent ID for each agent, found in the Tiny Talk dashboard under Agent Settings → General. You can add multiple agents and control which one appears on each page using rules.

​
Default agent

Set a default agent that appears on all pages where no specific rule or page override applies. This is your fallback — if no other match is found, this agent loads.

​
Display rules

Rules let you show different agents on different parts of your site. Rules are evaluated top to bottom — the first matching rule wins.
Condition typeExampleDescription
Post typepost, page, productMatch any post type, including custom post types
Taxonomycategory:news, product_cat:shoesMatch a specific taxonomy term (format: taxonomy_name:term_slug)
URL pattern/blog/*, /docs/**Wildcard matching (* single segment, ** multi-segment)
Page templatetemplate-landing.phpMatch a specific page template
User rolesubscriber, customerMatch logged-in users by role
Page ID42, 42,56,78Match specific pages by ID (comma-separated for multiple)
Rules can be reordered by dragging and dropping. The order matters — place more specific rules above general ones.

​
Per-page overrides

On any post or page, you’ll find a Tiny Talk Agent meta box in the editor. Use it to:
  • Select a specific agent for that page, overriding any rules
  • Disable the agent entirely on that page by selecting “None”
Per-page overrides take the highest priority — they always win over rules and the default agent.

​
Agent resolution priority

When a page loads, the plugin determines which agent to show in this order:
  1. Page override — if set in the post/page editor, use that (or disable if set to “None”)
  2. Rules — evaluate top to bottom, first match wins
  3. Default agent — fallback if nothing else matches

​
Shortcode

Use the [tinytalk] shortcode to embed an agent inline on any page: 
[tinytalk agent_id="YOUR_AGENT_ID"]
You can also reference an agent by the name you gave it in Settings → Tiny Talk: 
[tinytalk agent="My Sales Agent"]
If you omit both attributes, the shortcode uses the agent resolved by your rules and default settings.

​
Shortcode attributes

AttributeDescription
agent_idAgent UUID — takes precedence over agent
agentAgent name as configured in the plugin settings
typeiframe (default) for inline embed, or widget for the floating chat widget
widthIframe width (default: 100%)
heightIframe height in pixels (default: 660)
styledyes (default) adds a border and shadow to the iframe, no removes them
This renders the agent as an embedded iframe within your content, rather than as a floating widget.

​
Manual embed (without the plugin)

If you prefer not to use the plugin, you can add the script tag manually:
  1. Use a plugin like Insert Headers and Footers or go to Appearance → Theme Editor
  2. Paste the embed code before the closing </body> tag:
<script
  src="https://cdn.tinytalk.ai/latest/tiny-talk-sdk.min.umd.js"
  data-tiny-bot-id="YOUR_BOT_ID"
  defer
></script>
You can also add the script to a Custom HTML block on any individual page.
The manual approach only supports a single agent across your entire site. Use the plugin if you need per-page agents, rules, or shortcodes.