Skip to content

Xperience by Kentico integration that enables seamless connectivity between a wide range of web applications using Zapier.

License

Notifications You must be signed in to change notification settings

Kentico/xperience-by-kentico-zapier

Repository files navigation

Xperience by Kentico Zapier

7-day bug-fix policy CI: Build and Test NuGet Package

Description

Zapier integration enables seamless connectivity between a wide range of web applications, allowing users to create automated workflows, or "Zaps," that trigger actions across different platforms based on specified conditions and triggers. This integration empowers users to streamline repetitive tasks, synchronize data, and improve productivity without requiring any coding knowledge, making it an invaluable tool for individuals and businesses alike.

Screenshots

List of zapier triggers Trigger events Action events API Key page API Key generate page

Library Version Matrix

This version supports content workflows added in version 28.3.0. Please ensure that your versions are up to date.

Xperience Version Library Version
>= 29.3.* >= 2.0.0
>= 29.0.* 1.0.0

Zapier cli application

The Zapier cli app version 1.0.1 will initially be beta flagged, but this is the full version. The beta flag is just a zapier flag for new app integrations. This Flag will disappear after 90 days.

Dependencies

Package Installation

Add the package to your application using the .NET CLI

dotnet add package Kentico.Xperience.Zapier

Quick Start (with trigger example)

  1. Register required services into DI container.

    // Program.cs
    var builder = WebApplication.CreateBuilder(args);
    
    // ...
    
    builder.Services.AddKenticoZapier();
    
    // ...
    
    var app = builder.Build();
    
    // ...
    
    app.UseAuthorization() //place under app.UseKentico()
  2. Configure Zapier using CMSZapierConfiguration in appsettings.json of your application.

    • Specify allowed objects that can interact with your Zapier triggers and handlers.
        // appsettings.json
       "CMSZapierConfiguration": {
         "AllowedObjects": [
           "cms.user",
           "CMS.EventLog",
            // ...
           "DancingGoat.Banner",
           "DancingGoat.ConfirmationPage",
            // ...
           "BizForm.DancingGoatContactUs",
         ]
       }
  3. In the administration go to UI application 'Zapier' located at 'Configuration' section.

  4. On the API Key menu generate new API key for your Zapier application.

    • Save the API key as it will appear only once.
  5. Open your Zapier UI and create new Zap.

    • As a trigger pick Xperience by Kentico application
    • In the first step select event of your choice
    • Then you have to connect an Account using URL of your website (without trailing slash) and your generated API Key from previous step
    • In the third step you need to set configuration for your trigger
    • Test your trigger
  6. Now you can create your own workflow eg. connect with Gmail, Microsoft Teams, ...

  7. Publication of your Zap will create an object in your Xperience by Kentico application.

    • You can find the list of created triggers at Zapier application at page List of Zapier triggers

Full Instructions

View the Usage Guide for more detailed instructions.

Contributing

To see the guidelines for Contributing to Kentico open source software, please see Kentico's CONTRIBUTING.md for more information and follow the Kentico's CODE_OF_CONDUCT.

Instructions and technical details for contributing to this project can be found in Contributing Setup.

License

Distributed under the MIT License. See LICENSE.md for more information.

Support

7-day bug-fix policy

This project has Full support by 7-day bug-fix policy.

See SUPPORT.md for more information.

For any security issues see SECURITY.md.