Je kennisbank synchroniseren

4. Stel de toegang in en publiceer

Koppel voor dit voorbeeld van een privé-helpcentrum eerst inloggen voor geverifieerde klanten. Maak de doelgroep aan en bewaar de teruggegeven data.id:

curl --fail-with-body -X POST "$BASE/audiences" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Pro customers","rules":{"match":"all","conditions":[{"trait":"plan","op":"in","value":["pro","business"]}]}}'

Vervang AUDIENCE_ID, ARTICLE_ID en de inlog-URL hieronder. Het eerste verzoek zet het helpcentrum Live en beperkt het tot Pro-klanten. Het tweede publiceert het artikel. De inlogflow van je app moet een ondertekende klant-JWT uitwisselen met het helpcentrum; alleen signInUrl instellen logt niemand in.

curl --fail-with-body -X PATCH "$BASE/help-center" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled":true,"title":"Acme Help Center","audience":"verified","audienceId":"AUDIENCE_ID","signInUrl":"https://app.example.com/login"}'

# Replace ARTICLE_ID and AUDIENCE_ID with the returned data.id values.
curl --fail-with-body -X PATCH "$BASE/articles/ARTICLE_ID" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audienceId":"AUDIENCE_ID","status":"published"}'

Gebruik de URL die GET /help-center teruggeeft om de weergave voor ingelogde lezers te testen, en ook een uitgelogde browser. API-sleutels en MCP werken als teamlid en kunnen content lezen binnen hun scopes; een geslaagd antwoord bewijst dus niet dat een klant het artikel kan zien.

Gebruik voor een openbaar helpcentrum audience: "everyone" en audienceId: null op het helpcentrum en het artikel, en controleer ook de toegang van de categorie. Wil je alleen een benoemde groep weghalen, stuur dan audienceId: null; de beperking tot geverifieerde klanten blijft dan staan, tenzij je audience zelf aanpast. Laat je audienceId weg, dan blijft de vorige toewijzing gelden. Alle beperkingen op helpcentrum, categorie en artikel moeten kloppen.

Benoemde regels gebruiken match: "all" of "any", maximaal 10 voorwaarden en strikt getypeerde waarden. Operatoren: eq, neq, in, not_in, exists, not_exists, gt, gte, lt, lte. Numerieke vergelijkingen verwachten getallen; in/not_in verwachten arrays met 1–100 enkelvoudige waarden; bij exists/not_exists laat je value weg. Ontbrekende kenmerken laten een vergelijking mislukken. Bekijk hoe regels werken, overerving en problemen met toegang oplossen.

5. Houd de synchronisatie actueel

curl --fail-with-body --get "$BASE/articles" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  --data-urlencode "page=1" --data-urlencode "limit=100" \
  --data-urlencode "status=published" \
  --data-urlencode "updatedSince=2026-09-01T00:00:00Z"

# Get the full sanitized HTML and read-only analytics for one article.
curl --fail-with-body "$BASE/articles/ARTICLE_ID" \
  -H "Authorization: Bearer $SONNY_API_KEY"

curl --fail-with-body -X POST "$BASE/media" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  -F "file=@billing.png;type=image/png"

curl --fail-with-body -X PUT "$BASE/articles/reorder" \
  -H "Authorization: Bearer $SONNY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids":["ARTICLE_ID_1","ARTICLE_ID_2"]}'

Dezelfde werkwijze via MCP

1. Koppel je MCP-client en kies de juiste werkruimte. Controleer of hij kb:read en kb:write heeft, met toegang tot je kanaal.
2. Gebruik het kanaal-ID uit het dashboard, of roep list_sources aan als je sleutel ook conversations:read heeft. Gebruik nooit de siteId van de widget in plaats daarvan.
3. Voer de eerste vijf voorbeelden hieronder op volgorde uit. Vervang SOURCE_ID door je kanaal-ID, en ARTICLE_ID/AUDIENCE_ID door de data.id uit het eerdere resultaat. Vervang de inlog-URL en koppel het inloggen voordat je publiceert.
4. Gebruik list_kb_articles om wijzigingen te bekijken. Voer een herschikking pas uit nadat je de volledige, ongefilterde lijst hebt opgehaald, inclusief concepten. Vernieuw je lijsten na geslaagde schrijfacties.

Elk voorbeeld toont de naam van de tool en de argumenten. Upsert-velden staan direct in de argumenten; update-tools zetten gewijzigde velden in updates. Dit zijn invoerwaarden voor een tool-aanroep, geen HTTP-verzoek naar het MCP-endpoint.

{
  "name": "upsert_kb_category",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "externalId": "billing",
    "name": "Billing",
    "position": 0
  }
}

{
  "name": "upsert_kb_article",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "externalId": "billing-guide",
    "title": "Manage billing",
    "body": "## Find your invoices\n\nOpen **Settings → Billing** in your account.",
    "bodyFormat": "markdown",
    "categoryExternalId": "billing",
    "status": "draft"
  }
}

{
  "name": "create_kb_audience",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "name": "Pro customers",
    "rules": {
      "match": "all",
      "conditions": [
        {
          "trait": "plan",
          "op": "in",
          "value": [
            "pro",
            "business"
          ]
        }
      ]
    }
  }
}

{
  "name": "update_help_center",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "updates": {
      "enabled": true,
      "title": "Acme Help Center",
      "audience": "verified",
      "audienceId": "AUDIENCE_ID",
      "signInUrl": "https://app.example.com/login"
    }
  }
}

{
  "name": "update_kb_article",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "articleId": "ARTICLE_ID",
    "updates": {
      "audience": "verified",
      "audienceId": "AUDIENCE_ID",
      "status": "published"
    }
  }
}

{
  "name": "list_kb_articles",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "page": 1,
    "limit": 100,
    "updatedSince": "2026-09-01T00:00:00Z"
  }
}

{
  "name": "reorder_kb_articles",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "ids": [
      "ARTICLE_ID_1",
      "ARTICLE_ID_2"
    ]
  }
}

{
  "name": "update_kb_audience",
  "arguments": {
    "sourceId": "SOURCE_ID",
    "audienceId": "AUDIENCE_ID",
    "updates": {
      "name": "Paid customers"
    }
  }
}