Integrations
Iverton AI connects with your existing marketing stack to centralize data, automate workflows, and streamline campaign management. All integrations are accessed from Integrations in the main sidebar.
Available Integration Categories
Social Media Platforms
Connect your social accounts to publish content, track engagement, and manage conversations from one dashboard.
| Platform | Features | Status |
|---|---|---|
| Facebook Pages | Post scheduling, insights, message management | Available |
| Instagram Business | Post & Stories scheduling, hashtag analytics | Available |
| Company page posting, analytics, lead management | Available | |
| YouTube | Channel analytics, video statistics, content management | Available |
Twitter integration has been temporarily removed due to a security vulnerability (CVE-2022-39353) in the authentication library. We're working on a secure alternative.
Email Marketing
Send transactional and marketing emails through your preferred provider with full tracking and analytics.
| Provider | Features | Status |
|---|---|---|
| SendGrid | Transactional email, campaigns, deliverability tools | Available |
| Resend | Modern email API, React Email support, webhooks | Available |
| Custom SMTP | Use any SMTP provider (Gmail, Outlook, etc.) | Available |
Google Services
Connect Google's marketing and analytics tools for comprehensive data insights.
| Service | Features | Status |
|---|---|---|
| Google Analytics 4 | Traffic analysis, conversions, real-time data | Available |
| Google Sheets | Data export, report syncing, automated updates | Available |
| Google Workspace | Single sign-on, domain verification | Available |
| PageSpeed Insights | Performance analytics, optimization recommendations | Available |
Advertising Platforms
Manage ad campaigns and track performance across platforms.
| Platform | Features | Status |
|---|---|---|
| Google Ads | Campaign management, keyword bidding, performance tracking | Available |
| Facebook Ads | Campaign creation, audience management, creative library | Available |
| Instagram Ads | Runs through Facebook Ads Manager | Available |
SEO & Analytics
Monitor search rankings, analyze keywords, and optimize content.
| Tool | Features | Status |
|---|---|---|
| SerpAPI | Keyword research, SERP analysis, rank tracking | Available |
| Content Optimization | SEO audits, meta tag generation, content gaps | Available |
Automation & Workflows
Extend Iverton AI's capabilities with powerful automation tools.
| Tool | Features | Status |
|---|---|---|
| n8n | 60+ automated workflows, custom integrations | Available |
| Slack | Notifications, alerts, team updates | Available |
| Webhooks | Send data to any external endpoint | Available |
How Integrations Work
When you connect an integration, here's what happens behind the scenes:
Connection Flow
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 1. Connect │───▶│ 2. Authorize │───▶│ 3. Store │───▶│ 4. Sync & │
│ Button │ │ (OAuth/ │ │ Credentials│ │ Integrate │
│ │ │ API Key) │ │ (Database) │ │ Features │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
- Connect: You click Connect on an integration
- Authorize: You authenticate with the provider (OAuth popup or API key entry)
- Store: Credentials are encrypted and saved to your workspace in the database
- Integrate: The integration syncs data and connects to relevant features
System Integration
Once connected, integrations automatically integrate with relevant Iverton AI features:
| Integration | Integrates With |
|---|---|
| Google Ads | Ad Campaigns dashboard, cross-platform reports, budget tracking |
| Facebook Ads | Ad Campaigns dashboard, audience insights, creative library |
| Google Analytics | Dashboard widgets, client reports, AI recommendations |
| Social Media | Content calendar, post scheduler, engagement tracking |
| Email Providers | Email campaigns, automation sequences, transactional emails |
| Slack | Notifications, alerts, team updates |
For example, when you connect Google Ads:
- Your ad accounts appear in the Ad Campaigns section
- Campaign data syncs automatically on schedule
- Cross-platform reports include Google Ads metrics
- AI recommendations analyze your ad performance
Database Storage
Integration data is stored securely:
- Credentials: OAuth tokens and API keys are encrypted (AES-256) before storage
- Configuration: Selected accounts, properties, and settings
- Sync State: Last sync time, sync status, error logs
- Cached Data: Recent metrics for fast dashboard loading
Authentication Methods
Iverton AI uses industry-standard authentication methods:
- OAuth 2.0: For social media and Google services. You authorize access through the provider's login page - we never see your password.
- API Keys: For email providers and analytics tools. You generate a key in the provider's dashboard and add it to Iverton AI.
- Webhooks: For automation tools. Iverton AI sends data to your configured endpoints.
Security Features
All integrations include:
- Token Encryption: OAuth tokens are encrypted before storage using AES-256
- Automatic Token Refresh: Access tokens are refreshed automatically before expiry
- Webhook Signature Verification: Incoming webhooks are verified using HMAC-SHA256
- CSRF Prevention: OAuth flows use state parameters to prevent cross-site attacks
Data Flow
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Your App │────▶│ Iverton AI │────▶│ Provider │
│ Dashboard │◀────│ Backend │◀────│ (Google, │
│ │ │ (API Proxy)│ │ Facebook) │
└─────────────┘ └─────────────┘ └─────────────┘
All API calls go through Iverton AI's backend, which:
- Handles authentication and token management
- Applies rate limiting to prevent API abuse
- Logs requests for debugging
- Returns standardized responses
Connecting Your First Integration
Step 1: Navigate to Integrations
From your dashboard, click Integrations in the main sidebar. You'll see the Integration Marketplace with all available services organized by category.
Step 2: Find Your Integration
Browse by category or use the search to find the service you want to connect. Each integration card shows:
- Name and logo
- Brief description
- Connection status (Connected/Disconnected)
Step 3: Start the Connection
Click on the integration card, then click Connect. What happens next depends on the authentication method:
For OAuth integrations (Social media, Google services):
- A popup opens with the provider's login page
- Sign in to your account
- Review the permissions Iverton AI is requesting
- Click Authorize or Allow
- The popup closes and you're connected
For API key integrations (Email providers, analytics):
- A form appears asking for your API key
- Go to the provider's dashboard to generate a key
- Copy the key and paste it into Iverton AI
- Click Save to complete the connection
Step 4: Configure Settings
After connecting, you may need to configure additional settings:
- Select properties/accounts: Choose which GA4 property, ad account, or page to use
- Set sync frequency: How often to pull data from the provider
- Enable features: Turn on specific capabilities like auto-posting or alerts
Managing Connected Integrations
Viewing Connection Status
Go to Integrations to see all your connections. Each integration shows:
- Green checkmark: Connected and working
- Yellow warning: Connected but needs attention (token expiring, permissions changed)
- Red X: Disconnected or error
Refreshing Connections
If an integration shows a warning or stops working:
- Click on the integration
- Click Reconnect or Refresh
- Re-authorize if prompted
Disconnecting Integrations
To remove an integration:
- Click on the integration
- Click Disconnect
- Confirm the disconnection
This revokes Iverton AI's access to that service. You can reconnect anytime.
Troubleshooting
Common Issues
"Authorization failed" or "Invalid token"
- The provider may have revoked access. Try reconnecting.
- Your account password may have changed. Re-authorize the connection.
"Rate limit exceeded"
- You've made too many requests. Wait a few minutes and try again.
- If this persists, contact support.
"Insufficient permissions"
- The integration needs additional permissions. Disconnect and reconnect, ensuring you grant all requested permissions.
Data not syncing
- Check the integration status for errors
- Verify the correct property/account is selected
- Try a manual sync if available
Getting Help
If you're having trouble with an integration:
- Check the specific integration guide for troubleshooting tips
- Review the troubleshooting section in the specific integration docs
- Contact support with your workspace ID and error details
API Rate Limits
Different providers have different rate limits. Iverton AI manages these automatically, but heavy usage may hit limits:
| Provider | Typical Limit | Reset Period |
|---|---|---|
| 200 calls/hour | 1 hour | |
| 100 calls/day | 24 hours | |
| Google Analytics | 50,000 requests/day | 24 hours |
| YouTube | 10,000 units/day | 24 hours |
If you consistently hit rate limits, consider upgrading your API quota with the provider.
What's Next?
Choose an integration guide to get started:
- Social Media: Facebook & Instagram | LinkedIn | YouTube
- Email: Email Providers
- Google: Google Services
- Advertising: Ad Platforms
- SEO: SEO Tools
- Automation: Automation Tools