Notifications

Overview

Happ can send notifications about important events to your team through Telegram groups or Google Spreadsheets. This is especially useful for alerting managers when a conversation needs human attention.

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

Telegram Push Notifications

Send instant notifications to a Telegram group or channel when events occur. This is the recommended way to alert your team when the AI hands off a conversation (see AI Control & Human Handoff).

Setup

1. Create a Telegram bot via @BotFather (or use an existing one)
2. Add the bot to your target Telegram group/channel as an admin
3. In Happ, go to Integrations > Add Integration > Telegram Push Notifications
4. Enter:
   • Bot Token — From BotFather
   • Group/Channel ID — The Telegram group or channel ID
5. Complete the authorization process
6. Activate the integration

Use Cases

• Human handoff alerts — Get notified when AI mode is turned off for a conversation (either manually or via the turnOffAiMode built-in tool). This tells your team a customer needs human attention.
• New lead alerts — Get notified when a new customer starts a conversation
• Escalation alerts — Notify the team when AI cannot handle a specific query
• Daily summaries — Receive conversation summaries in your group

How It Works with Human Handoff

1. A customer asks to speak with a human, or the conversation requires escalation
2. The AI assistant calls the turnOffAiMode built-in tool (see Tools > Built-in Tools)
3. AI mode is disabled for that conversation
4. If Telegram Push Notifications are configured, your team is instantly alerted in the Telegram group
5. A manager can open the conversation in the dashboard or mobile app and respond manually

Google Spreadsheets

Log events to a Google Spreadsheet for tracking and analysis.

Setup

1. Go to Integrations > Add Integration > Google Spreadsheets
2. Authorize access to your Google account
3. Select or create the target spreadsheet
4. Configure which events to log

Use Cases

• Conversation log — Record all conversations in a spreadsheet
• Lead tracking — Log new leads with contact details
• Call records — Track voice call metadata and outcomes
• Reporting — Build custom reports and dashboards in Google Sheets

Tips

• Combine with AI Control — Set up Telegram Push Notifications alongside the turnOffAiMode tool so your team is always alerted when human intervention is needed
• Dedicated group — Create a separate Telegram group specifically for Happ notifications to avoid noise in your main work chats
• Google Sheets for analytics — Use Google Sheets logging alongside the built-in analytics for custom reporting needs