Skip to main content

Contentstack Connector

Ai12z Contentstack Connector Setup Guide​

Step 1: Enable Connector​

  1. Log in to the Ai12z portal using admin credentials.
  2. In the organization settings, verify that the connectors are enabled. Organization settings screen showing enabled connectors
  3. Navigate to your Agent.
  4. Select Agent Settings.
  5. Click on the edit button next to Connectors and enable Contentstack.

Step 2: Configure Connector​

  1. Select Connectors from the Agent left navigation.
  2. From the connector list, click on Contentstack
  3. In the Connector Configuration screen, fill out the information
    • Contentstack Name - The name of the connector to use in the document for vectorization.
    • Delivery Token - The token to read the content from the CMS.
    • Management Token - The token to write the content to the CMS.
    • API Key - The API key for the Contentstack account.
    • Site URL - The rest api path for ai12z to use.
    • Environment - In which channel we are accessing the API (e.g. website, mobile, etc.)
    • Contentstack Models - Where the laguage specfic urls with key values 
      {
       "langCode": "en-us",
       "url": "https://api.contentstack.io/"
      }
  4. Continue with Save action.
  5. Once the configured was successfully saved, now the "Configure Webhook" action and "Sync Now" action button are enabled to trigger it.

2.1 Configure Webhook​

  1. Click on the "Configure Webhook" button.
  2. It will create and configure the webhook in Contentstack cms.
  3. The webhook will now be set up to listen for changes in Contentstack content.
  4. You will see a confirmation message indicating that the webhook has been successfully configured.
  5. Ensure that the webhook is active and correctly set up to trigger on content changes in Contentstack.
  6. You can verify the webhook configuration in the Contentstack dashboard under Webhooks.

2.2 Sync Now​

  1. Click on the "Sync Now" button to initiate a content sync.
  2. This will fetch the latest content from Contentstack and update it in Ai12z.
  3. The sync process may take some time depending on the amount of content.
  4. Once the sync is complete, you will see a confirmation message indicating that the content has been successfully synced.
  5. You can now access the Contentstack content through Ai12z.

Step 3: Verify Integration​

  1. Navigate to the Ai12z Agent where you configured the Contentstack connector.
  2. Get into the Documents section and select the Contentstack connector document.
  3. Verify that the content from Contentstack is being displayed correctly under the Vector tab.
  4. You can also test the integration by querying the Contentstack content through the Ai12z Agent.

Source Reference​

For more information on the Contentstack API and its capabilities, refer to the Contentstack API Documentation.