Kentico.Xperience.Zapier 0.1.0-prerelease-1

Xperience by Kentico Zapier

[!WARNING]
This integration is currently preview only with limited Kentico Labs support. The Zapier application is in public beta, you can get access through this link: https://zapier.com/developer/public-invite/197164/a81b6e163e6b8128b380c7a72e10552d/

Fully featured and supported Zapier integration is coming in Xperience by Kentico April Refresh

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

Library Version Matrix

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

Dependencies

• ASP.NET Core 8.0
• Xperience by Kentico

Package Installation

[!WARNING]
The nuget is not published yet, include this respository into your project directly

Add the package to your application using the .NET CLI

dotnet add package Kentico.Xperience.Zapier --prerelease

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 ZapierConfiguration in appsettings.json of your application.

   • Specify the domain of your application and the allowed objects that can interact with your Zapier triggers and handlers.

       // appsettings.json
      "ZapierConfiguration": {
        "WebAdminDomain": "myzapierapp.com",
        "AllowedObjects": [
          "cms.user",
          "CMS.EventLog",
           // ...
          "DancingGoat.Banner",
          "DancingGoat.ConfirmationPage",      
           // ...
          "BizForm.DancingGoatContactUs",
        ]
      }
   

3. In the administration go to UI application 'Zapier'.

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
   • Select Event "Catch Xperience by Kentico Webhook"
   • Then you have to connect an Account using URL of your website (without trailing slash) and your generated API Key from previous step
   • After your connection, you can set configuration for your trigger.
     • Name your trigger
     • Pick object in Xperience by Kentico which you want to set for an automation process
     • Select type Event for your object
   • Test your trigger

6. Now you can create your own workflow eg. connect with Gmail, Microsoft Teams, ...

   • You can find more information on https://zapier.com/workflows

7. After you finish your automation workflow... Publication of your Zap will create an object in your Xperience by Kentico application.

   • You can find it in administration → Zapier UI application → 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

This project has Kentico Labs limited support while in PREVIEW version. You can expect our 7-day bug-fix policy support when full version is released.

See SUPPORT.md for more information.

For any security issues see SECURITY.md.