Skip to main content

Sitefinity

Ai12z Sitefinity Connector Setup Guide

Step 1: Add Connector

  1. Log in to the ai12z portal.
  2. Open Connectors from the left navigation and click Add Connectors.
  3. Select Sitefinity and submit.

Step 2: Configure Connector

  1. Open Connectors and click the row action on Sitefinity to edit.
  2. In the Connector Configuration screen, fill out the following information:

Basic Information

  • Name: Provide a descriptive name for your connector (e.g., "My Sitefinity Site"). Your connector will appear in the document list.
  • Description: Add a detailed description of your connector (e.g., "Connector for My Sitefinity site").

Connection Settings

  • Service URL: Enter your Sitefinity REST API endpoint
    • The interface automatically prefixes https://
    • Example: example.com/api/odata
    • Full URL becomes: https://example.com/api/odata

Content Filtering

  • Exclude Models: (Optional) Specify Sitefinity content types to exclude from indexing
    • Enter comma-separated model names
    • Example: Telerik.Sitefinity.Events.Model.Calendar, Telerik.Sitefinity.Events.Model.Event

Multi-language Support

  • Site URLs: Configure language-specific base URLs (Required - at least one mapping)
    • Language Code: Enter ISO language code (e.g., "en", "es", "fr")
    • URL: Enter the base URL for that language version
    • Click Add to include the language mapping
      The system displays a table showing all configured languages with delete functionality

URL Rewrite Rules (Optional)

  • Configure URL transformation patterns for reference links found in bot responses

  • Match Pattern (RegEx): Enter a regular expression to match URLs (max 2000 chars)

  • Replace Pattern: Define the replacement URL structure using $1, $2, etc. for capture groups

  • Flags: Select regex behavior modifiers (None, g, i, gi, gim)

  • Description: Optional documentation for the rule's purpose

  • Click Add Rule to save the configuration

  • Test URL Rewriting: Test your rules with sample URLs to verify they work correctly

    Example for Blog Post URL Transformation:
    • Match: ^\/(?:blog\/)?(?:post\/)?\?(\d+)$

    • Replace: /blog/$1

    • Description: "Blog Details"

    Test with path /post/2025/1

  1. Click Save to persist all configuration settings
    The webhook endpoint displayed after saving to use in the next step

The interface will display a success message "Configuration saved successfully" when the connector is properly configured.

Step 3: Create a webhook in Sitefinity

  1. Login to Sitefinity as an admin
  2. Go to Service Hook from Administration > Service hooks
    • Fill out a label.
    • Select a trigger when Sitefinity pushes the data to ai12z.
    • Insert the ai12z webhook endpoint as the target URL
    • Authentication set to HMAC Authentication, set Secret Id to your ai12z API key (create a dedicated key for this connector for better security). Sitefinity Service Hook