Hi there! Thanks for dropping in! We're excited to help you get started and we promise to make this as easy as we can! If you have any questions along the way, please drop us a line on hello@integry.io.

Basic Idea

Integry is an integration platform that provides integrations inside your app for your users. You can customize the look and feel of the integrations such that they appear just like your app. For example, your users can connect your app to Slack and send messages to Slack. You can see a list of apps you can embed here.

In order to start building your app, sign-up! There are three basic steps that will get you up and running with Integry:

  1. Create your app with Integry
  2. Add templates in your app
  3. Embed widget inside your app

Creating your app

This step of the app creation process requires technical detailing and configurations. We recommend someone with a technical background works on this. If instead, you would like us to create your app for you, please get in touch.

The apps are created under the Apps tab in your dashboard. Creation of the app consists of five major steps which are as follows:

  1. Create your App: Start by providing basic information about your app
  2. Setup your App’s Authentication: This will help us use your API. We support most of the popular authorization types
  3. Add Activities to your app: An activity can be a trigger or an action.

Trigger:  A trigger is an event that starts with your app. An integration starts with a trigger and ends with one or more actions. For example, If your app is a simple task manager, your triggers can be task completed, task created and more. If you don’t have an API created in your app yet, we’ve written this guide to help you create a basic push API. A visual representation of how it works in case of a trigger inside your app.

Action: An action is a step we can execute on your app. An integration starts with a trigger and can have one or more actions. For example, if your app is a task manager, your actions can be: create a task, mark a task as completed and more. 

 4.  Create Activity Endpoints: Triggers or actions act on your API through endpoints.  These are URLs where Integry sends a request (action) or receives a request (trigger). 

 5. Publishing your app: Once your app is approved by our team, it is listed in our marketplace. Other developers can create workflows with your app. This step marks the end of your app creation and setup process. View how an app appears in the marketplace. 

Adding Templates

A Template is a workflow that connects your app to other apps. An integration can be created against a template later. For example, if your app is a task manager app, a Template could be Send a Slack message when a task is created etc. Templates can be added in following steps:

  1. Create your Template: This creates workflows using actions and triggers. Template creation does not require any technical details.

The figure below shows the Templates page.

2.  Add a Template inside the Bundle: Using Bundles, stack together templates belonging to the same category. So, the users can see what is relevant to them. The image below shows the Bundles page.

3. Test and Publish your Template: You can test your template using your test users before making it live for your users. 

Embedding Widget

The widget is how a user of your app creates and edits integrations. Think of this as the admin panel to manage integrations. It’s designed to be customizable to adapt the look and feel of your app. It is a piece of JavaScript that you embed inside your app, the code is available to you on the Bundles page.

The widget displays the list of templates inside your app as shown below:

The widget needs to be provided with a number of parameters for it to work. Here is our guide that will guide you on how to embed the widget in your app.  

We hope you are now familiar with how things work at Integry. You are now all set to roll-out your integration, in case of any query shoot us an email at hello@integry.io

Happy Integrating!

Did this answer your question?