Altan Integrator

The Altan Integrator is the core system that powers how workflows and AI agents interact with third-party applications. It supports seamless connections to external apps, enabling authenticated actions, webhook event handling, and data management.

🚀 Key Components

External Apps and External Dev Apps

External Apps: Represent third-party platforms (e.g., Google, Microsoft, or custom APIs) that integrate with Altan.

External Dev Apps: Developer-specific app configurations tied to external apps (e.g., OAuth credentials or unique API keys).

Connection Types

A Connection Type defines the authentication and interaction model for an app, including:

Authentication Methods:

OAuth 1 / OAuth 2.0

API Keys

SAML, LDAP

JWT (JSON Web Tokens)

Basic Authentication

Persistent Tokens: Stores hashed credentials (e.g., refresh tokens) securely.

Action Types and Resource Types

Action Types: API calls that interact with external apps (e.g., fetching spreadsheets, sending emails).

Resource Types: Data structures (e.g., a "spreadsheet" or "email") defined using JSON Schemas for compatibility.

📘 Example: Google Sheets Integration

Action Type: get_spreadsheets

Fetches a list of spreadsheets from the user's Google account.

Resource Type: spreadsheet

The structure of the fetched spreadsheet, including properties like name, ID, and URL.

Webhooks and Webhook Event Types

Webhooks enable Altan to receive real-time updates from external apps.

Webhook: A connection to an external app that listens for specific events (e.g., "new email received").

Webhook Event Types: Define the type of event being monitored.

📘 Example: Gmail Webhook Integration

Webhook Event Type: new_mail

Triggers whenever a new email arrives in the user’s inbox.

Use Case: Automatically send the content of new emails to a Slack channel or analyze them with an AI agent.

🔗 How the Integrator Works

Unified for Workflows and AI Agents

Workflows: Use the integrator to trigger actions or process data dynamically.
Example: Create a workflow to upload files to Google Drive using upload_file action.

AI Agents: Leverage the integrator to access external APIs or resources.
Example: An AI agent retrieves the latest Google Calendar events to schedule meetings.

🛠 Integration Workflow

Step 1: Define the External App

Add an external app (e.g., Google) to your integrator with its associated developer configurations.

Step 2: Set Up Connection Types

Configure the connection type, authentication method, and supported actions.

Step 3: Add Action and Resource Types

Map API calls (action types) to their corresponding outputs (resource types) using JSON Schemas.

Step 4: Configure Webhooks (Optional)

Define webhook endpoints and monitor specific event types.

🌟 Benefits of Altan Integrator

Unified API: Streamline external app connections for workflows and AI agents.

Real-Time Updates: Handle webhook events for real-time automation.

Scalability: Integrate new apps effortlessly by defining connection types, actions, and resources.

Altan Integrator is the bridge that connects your workflows and AI agents to the world. Ready to build your own integration? Start now! 🎉

Altan Integrator

🚀 Key Components#

External Apps and External Dev Apps#

Connection Types#

Action Types and Resource Types#

📘 Example: Google Sheets Integration#

Webhooks and Webhook Event Types#

📘 Example: Gmail Webhook Integration#

🔗 How the Integrator Works#

Unified for Workflows and AI Agents#

🛠 Integration Workflow#

🌟 Benefits of Altan Integrator#