Skip to content

Manage Integrations

This guide covers how to manage integrations, configure API keys, and connect external services to your RhinoAgents.

Overview

Integrations extend your agent's capabilities by connecting to external services and APIs. RhinoAgents supports a wide range of integrations including:

  • AI Services - RAG Service, LangChain, OpenAI
  • Communication - Twitter, Slack, Email, Socket.io
  • Data Sources - Databases, CRMs, Cloud Storage
  • Custom APIs - RESTful services and webhooks

Understanding Integration Status

Each integration displays a status badge indicating its configuration state:

Status Indicators

Badge Meaning Action Required
No config needed (Green) Ready to use immediately None - start using
Wallet Config Available (Blue) Optional configuration available Configure if needed
Not configured (Orange) Requires API keys or setup Must configure before use
Used in X workflow Currently active in workflows Review before modifying
Used in X Node Connected to specific nodes Check dependencies

Adding Integrations

Browse Available Integrations

  1. Open your agent in the dashboard
  2. Click on the Integrations tab
  3. Browse the integration catalog
  4. Each card shows:
  5. Integration name and icon
  6. Configuration status
  7. Usage information
  8. Number of nodes using it

Add an Integration

  1. Find the integration you want to add
  2. Click on the integration card
  3. Review the integration details
  4. If configuration is required, click Configure
  5. Enter the necessary credentials (see below)
  6. Click Save to activate the integration

Configuring API Keys and Credentials

Step-by-Step Configuration

  1. Navigate to Integration Settings
  2. Click the Settings icon (⚙️) on the integration card

  3. Or click Configure when adding a new integration

  4. Enter Credentials

  5. API Key - Your service API key or token
  6. API Secret - Secret key for authentication (if required)
  7. Endpoint URL - Custom API endpoint (if applicable)
  8. Region - Service region (e.g., us-east-1, eu-west-1)

  9. Additional Parameters - Service-specific settings

  10. Save Configuration

  11. Click Save Configuration
  12. The status badge will update to show the integration is configured
  13. You can now use this integration in your workflows

Example: Configuring Twitter Integration

  1. Go to Integrations tab
  2. Find Twitter integration
  3. Click the Settings icon
  4. Enter your credentials: 
    API Key: your_twitter_api_key
API Secret: your_twitter_api_secret
Access Token: your_access_token
Access Token Secret: your_token_secret
  5. Click Save Configuration
  6. Status changes to "No config needed" (Green)

Example: Configuring RAG Service

  1. Navigate to RAG Service integration
  2. Click Configure
  3. Set up your knowledge base: 
    Endpoint: https://your-rag-service.com/api
API Key: your_rag_api_key
Model: gpt-4 (or your preferred model)
Max Tokens: 2048
  4. Upload knowledge base documents (optional)
  5. Click Save

Managing Integration Credentials

View Configured Integrations

To see all configured integrations:

  1. Go to Integrations tab
  2. Filter by status: Configured or In Use
  3. Review which integrations are active
  4. Check usage counts for each integration

Update API Keys

To update existing credentials:

  1. Find the integration in the Integrations tab
  2. Click the Settings icon (⚙️)
  3. Update the credentials
  4. Click Save Configuration
  5. The integration will use the new credentials immediately

Credential Updates

Updating credentials affects all workflows using this integration. Test thoroughly after updating.

Revoke or Remove Integration

To remove an integration:

  1. Ensure no workflows are using the integration
  2. Click the Settings icon (⚙️)
  3. Click Remove Integration
  4. Confirm the removal
  5. The integration will be disconnected from your agent

Using Integrations in Workflows

Add Integration to a Node

  1. Open the Nodes tab
  2. Click + Add Node
  3. Select a node type that supports integrations
  4. In the node configuration:
  5. Find the Integration dropdown
  6. Select your configured integration
  7. Configure integration-specific parameters
  8. Save the node configuration

Integration Usage Examples

RAG Service Node: 

Node Type: RAG Service
Integration: RAG Service (configured)
Query: User's question
Max Results: 5
Similarity Threshold: 0.7

Twitter Node: 

Node Type: Twitter Action
Integration: Twitter (configured)
Action: Post Tweet
Content: Generated response
Include Media: Yes/No

LangChain Node: 

Node Type: LangChain
Integration: LangChain (configured)
Model: gpt-4
Temperature: 0.7
Max Tokens: 1000

Integration Security

Best Practices

✅ Do: - Store API keys securely in the integration settings - Use environment-specific keys (dev, staging, production) - Rotate API keys regularly - Monitor integration usage and logs - Remove unused integrations - Use read-only keys when possible

❌ Don't: - Share API keys in chat or documentation - Use production keys in development - Leave test integrations configured in production - Grant more permissions than necessary - Ignore security warnings or alerts

Credential Storage

RhinoAgents securely stores your credentials:

  • Encrypted at Rest - All API keys are encrypted in the database
  • Encrypted in Transit - HTTPS/TLS for all API communications
  • Access Control - Only authorized users can view/edit credentials
  • Audit Logs - All credential changes are logged

Monitoring Integration Security

  1. Review integration access logs regularly
  2. Set up alerts for failed authentication attempts
  3. Monitor API usage for anomalies
  4. Rotate credentials if suspicious activity is detected

Testing Integrations

Test Integration Configuration

After configuring an integration:

  1. Navigate to the Preview tab
  2. Create a test workflow using the integration
  3. Send a test message or trigger
  4. Check the Logs tab for:
  5. Successful API calls
  6. Response data
  7. Any error messages
  8. Verify the integration is working as expected

Troubleshooting Integration Issues

If an integration isn't working:

  1. Check Credentials
  2. Verify API keys are correct
  3. Ensure keys haven't expired

  4. Check for typos in configuration

  5. Review Logs

  6. Go to Logs tab
  7. Look for error messages

  8. Check API response codes

  9. Test Connectivity

  10. Verify the service is online
  11. Check network connectivity

  12. Ensure firewall rules allow access

  13. Common Error Messages

  14. 401 Unauthorized - Invalid API key
  15. 403 Forbidden - Insufficient permissions
  16. 429 Too Many Requests - Rate limit exceeded
  17. 500 Server Error - Service issue

Advanced Integration Features

Custom API Integrations

For services not in the integration catalog:

  1. Use the Custom API integration
  2. Configure:
  3. Base URL
  4. Authentication method (API Key, OAuth, Basic Auth)
  5. Headers and parameters
  6. Request/response format
  7. Test the integration thoroughly

Webhook Integrations

To receive data from external services:

  1. Go to Webhook Setup tab
  2. Copy the webhook URL
  3. Configure the webhook in the external service
  4. Set up authentication (optional but recommended)
  5. Test with a sample payload

OAuth Integrations

For services requiring OAuth:

  1. Click Configure on the OAuth integration
  2. Click Authorize with [Service]
  3. You'll be redirected to the service's login page
  4. Grant the requested permissions
  5. You'll be redirected back to RhinoAgents
  6. The integration is now configured

Integration Limits and Quotas

Understanding Limits

Each integration may have:

  • Rate Limits - Maximum requests per minute/hour
  • Quota Limits - Monthly API call limits
  • Concurrent Requests - Maximum simultaneous connections
  • Data Limits - Maximum payload size

Monitor Usage

  1. Go to Integrations tab
  2. Click on an integration
  3. View usage statistics:
  4. Total API calls this month
  5. Average response time
  6. Error rate
  7. Remaining quota

Next Steps