Altan
HomeDiscordStatus
HomeDiscordStatus
  1. Integration
  • What is Altan?
  • Support Options
  • Projects
    • Create Your First Project
    • App Navigation & Settings
    • Building Tips
    • The Art of Prompting
    • Publishing Your App
    • Rollback and Checkpoints
    • Instantly Resolve Errors
  • Databases
    • Introduction
    • Security
    • Technical Overview
  • AI Agents
    • What is an AI Agent?
    • Create your first AI Agent
    • Tools
    • Interacting with Your AI Agent
    • Technical Overview
    • Altan Frontend SDK
      • Altan Frontend SDK
  • Flows
    • Create your first Flow
    • Automation basics
    • Adding modules
    • Types of modules
    • Passing data
    • Filters
    • Debugging
    • Retrigger events
    • Version History
    • Overwrite connection
    • Task credits
  • Integration
    • Magic Link
    • Altan Integrator
    • Create your integration
  • Authentication
    • Authentication
  • Payments
    • Checkout Session
    • Object Storage
  • Media
    • Media
  • Partner Program
    • Who are our Partners?
    • Partner Program Benefits
    • How to import projects into Altan
    • How to export projects from Altan
    • Work collaboratively
    • How to start on Altan
    • Become an Altan Partner
  • API Reference
    • account
      • Create Account
      • Get Account Gq
      • Get Account Public
      • Get Account Usage
      • Patch Account
      • Delete Account
      • Get Account Users
      • Create Custom Webhook
      • Create Media
      • Create Media From Url
      • Create Multiple Media
      • Create Token
      • Create Agent
      • Upsert Flow
      • Fetch User Account Notifications
      • Create Altaner
      • Get Selected Template Version
      • Get Latest Template Version
      • Get Template Version
      • Invite User
      • Create Interface
      • Get Members
      • Get Account Connections
      • Get Apikey
      • Delete Apikey
    • project
      • Get Altaner
      • Create Project V2
      • Update Altaner
      • Delete Altaner
      • Get Altaner Flows
      • Clone Altaner
      • Update Altaner Positions
      • Create Altaner Component
      • Update Altaner Component
      • Get Altaner Component
      • Atomic Update Altaner Component
      • Delete Altaner Component
      • Duplicate Altaner
      • Create Idea
    • interface
      • Start Dev Server
      • Get Dev Status
      • Send Dev Error To Agent
      • Revise Interface
      • Get Dev Errors
      • Log Error
      • Create Or Overwrite File
      • Update File
      • Create Multiple Files
      • Read File
      • Read Multiple Files
      • Delete File
      • Rename File
      • Update Files Pattern
      • Search In Files
      • Search And Replace
      • Preview Updates
      • Install Libraries
      • List Tree
      • List Tree Json
      • Get Repo Status
      • List Branches
      • Create Branch
      • Delete Branch
      • Switch Branch
      • Clone Repo
      • Merge Branch
      • Commit Changes
      • Get Diff Changes
      • Accept Changes
      • Discard Changes
      • Push Changes
      • Pull Changes
      • Reset Repo
      • Get Repo Log
      • Restore Main
      • Get Public Interface
      • Get Interface By Name
      • Get Interface
      • Update Interface
      • Delete Interface
      • Get Interface Screenshot
      • Update Interface With Ai
      • Publish Interface
      • Vercel Webhook
      • Get Deployment Status
      • Add Collaborator
      • Get Deployment Logs
      • Fix Deployment With Ai
      • Add Domain
      • Get Domains
      • Remove Domain
      • Verify Domain
      • Add Env Variables
      • Get Env Variables
      • Delete Env Variable
      • Sync Env Variables
      • Rollback Deployment
      • Get Commit Details
      • Restore To Commit
    • flows
      • modules
        • Fetch Module
        • Update Flow Module
        • Delete Module
        • Fetch Graph Module
        • Rename Module
        • Update Position In Canvas
        • Update In Edge Filter
        • Update Route Condition Filter
        • Add Condition
        • Get Available Variables For Mappings
      • hooks
        • Get Webhook
        • Update Hook
      • executions
        • Get File Signed Url
        • Stream Execution
      • Fetch Flow Execution
      • Fetch Flow
      • Update Flow
      • Delete Flow
      • Get Latest Execution
      • Fetch Flow Schema
      • Get Flow From Hook
      • Get Flow Hook
      • Fetch Flow Executions
      • Fetch Flow Executions
      • Upsert Flow Module
      • Add Flow Module
      • Create Flow Duplicate
      • Clone Flow Modules
      • Paste Flow Modules
      • Delete Modules
      • Update Edge
    • media
      • Get Media Url
      • Delete Media
      • Get Multiple Media
      • Get 3D Media
      • Delete Model
      • Create 3D Model
    • agents
      • tools
        • Patch Tool
        • Patch Tool
      • authorizaiton requests
        • Create Authorization Request
        • List Authorization Requests
        • Get Authorization Request
        • Delete Authorization Request
        • Reject Authorization Request
      • Get Altan Agents
      • List Voices
      • Get Agent
      • Update Agent
      • Delete Agent
      • Get Agent
      • Create And Add Tool To Agent
      • Remove Tool And Space
      • Get User Agent Dm Room
      • Get Agent Gate
      • Get Agent Member Usage
  1. Integration

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.
image.png

πŸš€ 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#

1
Step 1: Define the External App
Add an external app (e.g., Google) to your integrator with its associated developer configurations.
2
Step 2: Set Up Connection Types
Configure the connection type, authentication method, and supported actions.
3
Step 3: Add Action and Resource Types
Map API calls (action types) to their corresponding outputs (resource types) using JSON Schemas.
4
Step 4: Configure Webhooks (Optional)
Define webhook endpoints and monitor specific event types.

🌟 Benefits of Altan Integrator#

1.
Unified API: Streamline external app connections for workflows and AI agents.
2.
Real-Time Updates: Handle webhook events for real-time automation.
3.
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! πŸŽ‰
Modified atΒ 2024-11-29 20:10:18
Previous
Magic Link
Next
Create your integration
Built with