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.

​
Why Connect Strapi?

Content Search

Chatbot can search and retrieve Strapi content

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 Dashboard → Integrations 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 Settings → Global Settings → API 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 Settings → Users & Permissions → Roles → Public
  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”

​
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
  • 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.