Retour au tableau de bord

Documentation

Apprenez à utiliser Asyntai

Set Up Real-Time Data Feed Max on Strapi

Expose any Strapi content type as a public JSON feed for your chatbot

Back to Real-Time Data Feed Max
Plan Pro

What Your Feed Should Look Like

Real-Time Data Feed Max accepts any public URL returning JSON or plain text. The AI reads whatever you give it — products, services, bookable slots, property listings, menus, opening hours, anything — and uses it to answer visitor questions. There is no required shape or field name.

The one exception is Dynamic Product Cards. If you want matching items to render as visual cards in the chat, use these specific field names: name, price, description, image_url, button_link, in_stock.

Example — products (triggers Dynamic Product Cards)

{
  "products": [
    {
      "name": "Wireless Headphones Pro",
      "price": "$149.99",
      "description": "Premium over-ear wireless headphones with ANC.",
      "image_url": "https://example.com/images/headphones.jpg",
      "button_link": "https://example.com/products/headphones",
      "in_stock": true
    }
  ]
}

Example — services (any shape works)

{
  "services": [
    {
      "service": "Deep tissue massage",
      "duration_minutes": 60,
      "price_from": "$95",
      "therapists_available": ["Anna", "Mark"],
      "booking_link": "https://example.com/book/deep-tissue"
    },
    {
      "service": "Haircut & style",
      "duration_minutes": 45,
      "price_from": "$55",
      "booking_link": "https://example.com/book/haircut"
    }
  ]
}

Example — plain text (works too)

Opening hours: Mon-Fri 9-6, Sat 10-4, closed Sunday.
Delivery: Free over $30, minimum order $15, within 5 miles.
Lunch specials (weekdays only):
- Margherita pizza $12
- Caesar salad $9
- Soup of the day $7

Rule of thumb: Use descriptive field names the AI can interpret (service, duration, price, location, etc.). If Dynamic Product Cards make sense for your business, follow the exact field names above. If they don't, use whatever shape fits your data — the AI still searches it and answers questions correctly.

Why Strapi Is Easy

Strapi generates a REST API automatically for every content type you create. You just need to flip a permission switch, and your content becomes publicly readable at a predictable URL — no code required.

Setup via Public Permissions

1
Open Strapi admin Usually at your-site.com/admin.
2
Grant public access to the content type Settings → Users & Permissions Plugin → Roles → Public → under your content type (e.g. Product, FAQ, Service), tick find and findOne → Save.
3
Build your feed URL The API route is /api/{plural-name} — use populate to include related fields and media.
4
Paste into Real-Time Data Feed Max Open the URL in a private browser tab to confirm you see JSON (not a 403 Forbidden).
https://your-site.com/api/products?pagination[pageSize]=100&populate=*

Replace products with your content type's plural API ID (e.g. faqs, services, properties, articles). populate=* pulls related components and media URLs — drop it if you want a flatter response.

Custom Fields Selection

By default, Strapi returns every field on your content type, which can bloat large feeds. Use the fields parameter to select only what you need:

https://your-site.com/api/products?fields[0]=name&fields[1]=price&fields[2]=description&populate[image][fields][0]=url

Custom Controller (cleaner JSON)

Strapi wraps every response in a data / attributes envelope. If you want a flatter output that matches our format exactly, override the controller:

// src/api/product/controllers/product.js
'use strict';
const { createCoreController } = require('@strapi/strapi').factories;

module.exports = createCoreController('api::product.product', ({ strapi }) => ({
  async aiFeed(ctx) {
    const rows = await strapi.entityService.findMany('api::product.product', {
      populate: ['image'],
      limit: -1,
    });
    const products = rows.map(p => ({
      name:        p.name,
      price:       p.price ? `$${p.price}` : '',
      description: p.description,
      image_url:   p.image?.url,
      button_link: `https://your-site.com/products/${p.slug}`,
      in_stock:    p.in_stock,
    }));
    ctx.body = { products };
  },
}));

Add the matching route at src/api/product/routes/custom.js pointing to aiFeed on path /ai-feed, then the feed lives at /api/ai-feed.

Astuce : Strapi's default pagination limit is 25 items. Always set pagination[pageSize]=100 (or higher, up to the maxLimit in your config) — otherwise the AI only sees a fraction of your content.

Dépannage

I see a password page instead of JSON

Your site is in maintenance, staging, or password-protected mode. Real-Time Data Feed Max needs a fully public URL.

Real-Time Data Feed Max says the feed failed

Open the URL in a private browser window. If you don't see JSON, the URL is wrong or the endpoint is down. If you see JSON but we still fail, the response may be missing a Content-Type: application/json header or exceeding the 10,000,000 character limit.

Product cards don't render

Dynamic Product Cards require specific field names (name, price, image_url, button_link, in_stock). If your platform uses different names, reshape the response in a small custom script before exposing it.

Data looks wrong or outdated

The feed auto-refreshes every 24 hours. For immediate updates, click Refresh Now in Real-Time Data Feed Max. For live fields (price, stock), the AI pulls fresh data on every message — so the 24h cycle only affects which items are known, not their current state.

Feed size exceeded

Real-Time Data Feed Max accepts up to 10,000,000 characters (~25,000 items). If you exceed that, trim fields (skip long HTML descriptions), split your catalog, or use the standard Real-Time Data Feed alongside for secondary data.

Still stuck? Start with the simplest option for your platform and verify the URL works in a browser before pasting it into Real-Time Data Feed Max. You can always upgrade to a more advanced option later — only the URL field changes on our side.