Integrations Overview

Overview

Beyond messaging channels, Happ integrates with AI providers, CRM systems, notification services, telephony providers, and custom webhooks to create a complete automation platform.

For the full API reference, see api.happ.tools/reference.

Integration Categories

AI Providers

Power your assistants with your preferred AI model. Each provider requires an API key added via Integrations > Add Integration.

See Assistants > AI Model Configuration for the full model list and recommendations.

CRM Systems

Sync conversations and customer data with your CRM:

• KeyCRM — Ukrainian CRM for sales and customer management
• NetHunt — Gmail-based CRM
• Odoo — Open-source ERP and CRM
• SalesDrive — Sales management platform
• Bookon — Booking and scheduling
• SmartCRM — CRM for small and medium businesses
• Altegio — CRM for service businesses (salons, clinics)

Webhooks

Build custom integrations by receiving real-time events:

• Chat webhooks — Receive events when messages arrive
• Call webhooks — Receive events after phone calls

Notifications

Send alerts and updates to your team:

• Telegram Push Notifications — Instant alerts to a Telegram group
• Google Spreadsheets — Log events to spreadsheets

Telephony Providers

Connect SIP phone numbers for the voice assistant:

• Binotel, Ringostat, Phonet, Unitalk

See Telephony Providers for setup details.

Voice Services

• ElevenLabs — Premium text-to-speech voices for the voice assistant

Vector Database

• Qdrant — Powers the Knowledge Base vector search. Happ uses OpenAI text-embedding-3-large for embeddings and Qdrant for semantic retrieval.

Three-Tier Integration Model

Happ uses a three-tier model for all integrations:

1. Integration — Master definition (e.g., "Telegram type", "Binotel type")
2. Company Integration — Your company's specific connection (your credentials and configuration)
3. Assistant Integration — Which assistant handles this connection

This means you can connect multiple accounts of the same type and assign different assistants to each.

Managing Integrations

Adding an Integration

1. Go to Integrations in the sidebar
2. Click Add Integration
3. Select the integration type
4. Enter the required credentials (API keys, tokens, URLs)
5. Assign an assistant (for channel-type integrations)
6. Click Connect

Viewing Integrations

GET /api/company-integrations
X-Access-Token: happ_your_token_here

Editing

Click on any active integration to update its configuration.

Removing

Delete an integration you no longer need. This disconnects the service and stops all data flow. For channel integrations, all related chats are cleaned up when deactivated.

API Keys Best Practices

• Keep your API keys secure — never share them publicly
• Use separate API keys for Happ (don't reuse keys from other services)
• Monitor usage through each provider's dashboard
• Rotate keys periodically for security