Skip to main content
Enhance your chatbot with real-time access to your Strapi content. The Strapi integration allows your chatbot to search content types and automatically sync your knowledge base.

Why Connect Strapi?

Content Search

Chatbot can search and retrieve Strapi content

Knowledge Base Sync

Automatically sync Strapi content to your knowledge base

Flexible Content Types

Works with custom content types and collections

API Token Auth

Secure authentication with API tokens

Prerequisites

  • Strapi 4.x or 5.x project
  • Admin access to your Strapi dashboard
  • API Token generated from your Strapi admin
  • Content API permissions configured

Setup Steps

1

Navigate to Integrations

Go to DashboardIntegrations and find the Strapi card
2

Click Connect

Click Connect Strapi to open the connection form
3

Enter API URL

Enter your Strapi API URL (e.g., https://cms.yoursite.com/api)
4

Generate API Token

Create an API Token in your Strapi admin:
  1. Log in to your Strapi admin dashboard
  2. Go to SettingsGlobal SettingsAPI Tokens
  3. Click Create new API Token
  4. Enter a name (e.g., “BubblaV Integration”)
  5. Set token duration (recommended: Unlimited or long duration)
  6. Set token type to Read-only or Full access
  7. Click Save
  8. Copy the generated API Token (shown only once)
5

Configure Content Permissions

Ensure your API Token has access to the content types you want to sync:
  1. Go to SettingsUsers & PermissionsRolesPublic
  2. Or create a dedicated role for the integration
  3. Enable find and findOne permissions for desired content types
6

Enter Credentials

Enter your API Token in the connection form
7

Verify Connection

Click Connect. The Strapi card should now show Connected

Available Tools After Connection

ToolWhat It DoesExample Query
strapi_search_contentSearch Strapi content types”Find articles about pricing”
strapi_sync_knowledge_baseSync content to knowledge baseSyncs your Strapi content automatically

Test Your Integration

Try these queries on your website:
  • “What do you have about [topic]?”
  • “Show me articles about [subject]”
  • “Find content related to [keyword]“

Troubleshooting

  • Verify your API Token is correct
  • Check that the token hasn’t expired
  • Ensure the token type is set correctly (Read-only or Full access)
  • Make sure you’re including the full token without spaces
  • Verify your API URL is correct and accessible
  • Check that Strapi is running and the API is available
  • Ensure your site is not blocking API requests
  • Try accessing /api/articles (or another endpoint) to test API availability
  • Wait a few minutes for the initial sync to complete
  • Check that your content types have published entries
  • Verify that the Public role (or your custom role) has find/findOne permissions
  • Check that content types are set to be publicly accessible
  • Strapi uses role-based permissions for API access
  • By default, the Public role has limited access
  • You may need to create a dedicated role with proper permissions
  • Ensure the API Token is associated with a role that has read permissions
  • The integration works with any Strapi content type
  • Custom fields and components are supported
  • Ensure your content types have API enabled in their settings
  • Check that the content schema is properly configured
Security: We use Strapi API Tokens for authentication. These tokens can be revoked or regenerated at any time from your Strapi admin without affecting your application.
Important: Save your API Token securely when you create it. Strapi only shows it once and you’ll need to regenerate it if lost.
Best Practice: Create a dedicated role in Strapi for the BubblaV integration with specific permissions rather than using full admin access. This follows the principle of least privilege.