Integrations: Connect FlameTree with External Systems and Services
FlameTree platform supports dynamic integration with various external systems and services. Integrations enable your agents to communicate through different channels and connect with external systems for enhanced functionality.
Prerequisites
- FlameTree platform account access
- Administrative permissions for integration management
- External system credentials and access tokens (for custom integrations)
- Basic understanding of API concepts for advanced configurations
Integration Categories
Communication Channels
Connect agents to messaging platforms and communication services:
Messaging Platforms
- WhatsApp - Connect to WhatsApp Business API for customer messaging
- Bird API - Virtual phone numbers (no SIM card required), media support, templates
- Telegram - Bot-based communication with inline keyboards and file sharing
- Facebook Messenger - Integration with Facebook business pages and rich media support
Email Communication
- Email (IMAP/SMTP) - Compatible with most email servers, attachment handling, HTML/plain text support
- Microsoft Exchange - Advanced authentication, Office 365 integration, calendar and contact support
- Mail (SMTP) - Simple SMTP for email notifications
Voice Communication
- Twilio - Reliable cloud-based voice service with global numbers and programmable workflows
- SIP - Softphone integration, PBX connection, call recording, and IVR
Third-Party Platforms
- Bird API - WhatsApp integration with virtual phone numbers and delivery tracking
- Intercom - Multiple operation modes (Chatbot/Co-pilot), performance analytics
- Chatwoot - Unified customer communication with CRM functionality
Web Integration
- Web Widget - Embeddable chat widget with customizable appearance, visitor tracking, and mobile-responsive design
AI Models
Language models, speech recognition, and text-to-speech services:
Core AI Models
- Large Language Model (LLM) - Primary AI model for agent intelligence (essential for all agents)
- OpenAI-compatible API endpoint required
- Essential integration for all agent functionality
- Fast LLM - Quick responses for voice optimizations and filler phrases while main agent processes
Speech and Audio Processing
- Speech-to-Text (STT) - Voice message processing, SIP transcription, audio file analysis
- Text-to-Speech (TTS) - Voice responses in chat, call responses, accessibility features
- Transcription - Audio file transcription for Import Session feature, quality control, and conversation analysis
Specialized AI Models
- Embedder Model - Convert text to mathematical representations (required for Knowledge Base functionality and semantic search)
- Translator - Multi-language support for specialized or less common languages, real-time conversation translation
External Systems
Databases, CRM systems, and custom APIs:
Database Integration
- Databases - SQL query execution with read/write operations and secure connections
- Supported Types: MySQL, PostgreSQL, Microsoft SQL Server, Oracle Database, SQLite
- Use Cases: Customer information lookup, order status queries, inventory management, data validation
Custom Integrations
- Custom APIs - Integrate with external APIs and services through custom implementations
System Monitoring
- Health Monitoring - Integration health status, performance metrics, and monitoring capabilities
Managing Integrations
View Options
- Card View: Visual overview of available integrations
- Table View: Detailed list with filtering and search options
Table Information
- Connector Name: Integration identifier
- Linked Agent: Agents currently using this integration
- Default: Default integration used for new agents
- Status: Active, configured, or requires setup
Default vs Custom Integrations
| Aspect | Default Integrations | Custom Integrations |
|---|---|---|
| Configuration | Pre-configured by FlameTree | Created and configured by users |
| Availability | Available immediately upon platform access | Must be set up by users |
| Editability | Cannot be edited or modified | Fully customizable parameters |
| Maintenance | Managed by FlameTree | Can be modified and deleted by users |
| Use Cases | Common use cases and standard configurations | Tailored to specific requirements |
| Setup Complexity | No technical configuration required | Requires understanding of external systems |
| Deployment Speed | Quick setup and deployment | Longer setup time for configuration |
| Reliability | Tested and optimized configurations | Depends on user configuration quality |
| Support | Fully supported by FlameTree | User responsibility with FlameTree assistance |
| Examples | Standard WhatsApp, Email, LLM integrations | Custom API endpoints, specialized authentication |
When to Use Each Type
Choose Default Integrations when:
- You need quick deployment
- Standard functionality meets your requirements
- You prefer minimal technical setup
- You want guaranteed reliability and support
Choose Custom Integrations when:
- You have specific API endpoints or services
- You need custom authentication requirements
- You require specialized configurations
- You're integrating with proprietary systems
Best Practices
Security Considerations
- Store API keys and tokens securely
- Limit integration access to authorized personnel
- Ensure compliance with data protection regulations
- Regular security audits and updates
Performance Optimization
- Monitor API response times and latency
- Check rate limiting and throttling settings
- Review integration configuration for optimization
- Consider load balancing and scaling options
Preparation Checklist
- Gather all required credentials and access tokens
- Understand external system requirements and limitations
- Plan integration architecture and data flow
- Prepare testing scenarios and validation criteria
Common Issues & Solutions
Authentication Failures
Symptoms: Connection errors, access denied messages
Solutions:
- Verify credentials and API keys
- Check authentication method and parameters
- Validate account permissions and access levels
- Review API rate limits and usage quotas
Message Delivery Issues
Symptoms: Messages not sending or receiving properly
Solutions:
- Check network connectivity and firewall settings
- Verify webhook configurations and endpoints
- Review message format and content requirements
- Test with different message types and sizes
Performance Problems
Symptoms: Slow response times, timeouts, delays
Solutions:
- Monitor API response times and latency
- Check rate limiting and throttling settings
- Review integration configuration for optimization
- Consider load balancing and scaling options
Configuration Errors
Symptoms: Integration not working as expected
Solutions:
- Review integration parameters and settings
- Compare with working integration examples
- Check external system configuration and status
- Validate data formats and expected responses
Working with FlameTree Support
When to Contact Support
- Initial integration setup for complex systems
- Custom integration requirements
- Troubleshooting persistent issues
- Performance optimization and scaling
Information to Provide
- Integration type and specific requirements
- Error messages and logs
- Configuration details (without sensitive credentials)
- Expected vs. actual behavior descriptions
Support Process
- Initial Consultation: Discuss requirements and approach
- Configuration Planning: Design integration architecture
- Implementation Support: Assist with setup and configuration
- Testing and Validation: Help validate integration functionality
- Ongoing Support: Provide maintenance and optimization assistance
FAQ
Can I modify default integrations?
No, default integrations are pre-configured by FlameTree and cannot be modified. You can create custom integrations with your specific requirements.
How many integrations can I create?
There's no hard limit on the number of integrations. However, consider performance and maintenance implications when creating multiple custom integrations.
What's the difference between channels and integrations?
Regular integrations allow one agent per channel, while shared channels enable multiple agents to use the same communication channel with configurable routing rules.
Do I need technical knowledge to set up integrations?
Basic integrations can be set up with minimal technical knowledge, but complex integrations typically require understanding of APIs and external systems. FlameTree support is available to assist with configuration.