Setting Up Connectors

Connectors bridge Saltare with your existing tools. They let agents read from and write to external services — GitHub issues, Slack channels, Google Calendar events, and more — without leaving your workspace.

Connector Types

Saltare supports three types of connectors:

API Connectors (Outbound)

Make outbound API calls to external services. Examples:
- Web Search — Search the internet for information
- URL Fetcher — Read content from any webpage
- News API — Search recent news articles

API connectors are the simplest to set up — they typically just need an API key.

Webhook Connectors (Inbound)

Receive events from external services. When something happens in another tool, Saltare gets notified and can trigger actions. Examples:
- Generic Webhook — Receive POST data from any service
- Incoming events from custom integrations

Each webhook connector generates a unique URL that you configure in the external service.

Integration Connectors (Bidirectional)

Full two-way connections with OAuth authentication. These are the richest integrations:
- GitHub — Read issues, PRs, create issues
- Google Calendar — List events, create meetings
- Google Drive — Search and read files
- Slack — Read channels, post messages
- Discord — Read channels, send messages
- GitLab — Read issues, MRs, create issues

Setting Up a Connector

Step 1: Navigate to Connectors

Go to Settings > Connectors in your workspace.

Step 2: Choose a Template

Select from 20+ pre-built connector templates organized by category:

• Research — Web search, URL fetcher, News API
• Communication — Slack, Discord, Twilio, Email
• Dev Tools — GitHub, GitLab, Linear, Jira, Sentry
• Productivity — Notion, Google Calendar, Google Drive, Airtable
• Business — HubSpot, Stripe, Zapier

Step 3: Configure Credentials

Each connector type has different requirements:

API Key connectors — Enter your API key from the external service.

OAuth connectors (GitHub, Google, GitLab, Discord) — Click "Install" to start the OAuth flow. You'll be redirected to the external service to authorize access, then back to Saltare.

Webhook connectors — Copy the generated webhook URL and paste it into the external service's webhook configuration.

Step 4: Test the Connection

After setup, test the connector to verify it's working. The system will show you the connection status and any errors.

Using Connectors with Agents

Once a connector is set up, agents can use it through their tools. The connector automatically grants agents the relevant tool capabilities.

GitHub Examples

@Assistant list open issues in the saltare/api repo
@Assistant create a GitHub issue titled "Fix login redirect" 
with label "bug" in saltare/web
@Assistant show me the last 5 pull requests for saltare/api

Google Calendar Examples

@Assistant what meetings do I have tomorrow?
@Assistant schedule a 30-minute meeting with the engineering team 
next Tuesday at 2pm titled "Sprint Planning"

Slack Examples

@Assistant read the last 10 messages from #engineering in Slack
@Assistant post "Deploy complete" to #releases in Slack

Research Examples

@Researcher search the web for "AI agent frameworks 2024"
@Researcher fetch the content from https://example.com/blog/post
@Researcher find recent news about our industry

Webhook Events and Skills

Webhook connectors can trigger Skills when events arrive. This enables powerful automations:

1. A GitHub webhook fires when a new issue is created
2. Saltare receives the event
3. A trigger skill activates
4. An agent processes the event and takes action (e.g., creates a task, posts in a channel)

Webhook Security

Webhook-capable connectors support HMAC-SHA256 signature validation. Configure a webhook secret in both Saltare and the external service to verify that incoming payloads are authentic.

Connector Capabilities

Each connector declares its capabilities:
- Read — Pull data from the external service
- Send — Push data to the external service
- Receive — Accept incoming events (webhooks)

When setting up a connector, you'll see which capabilities it supports. Integration connectors typically support all three.

Tips

• Start with research connectors — Web search and URL fetcher are the easiest to set up and immediately useful for agents
• Use OAuth for full integrations — API keys work, but OAuth integrations get richer data access
• Set up webhook secrets — Always configure HMAC validation for webhook connectors in production
• One connector per service — You typically need only one GitHub connector, one Slack connector, etc. per workspace
• Check skill auto-creation — Setting up a connector often auto-creates a Skill that grants agents access to the connector's tools