Skip to content

v1.0.1 - Telegram VoIP Calls

Choose a tag to compare

View all tags
@Sanji78 Sanji78 released this 14 Feb 17:57
v1.0.1
6b93ec5

Telegram VoIP Calls v1.0.0

This release introduces Telegram VoIP Calls, a Home Assistant custom integration that lets you place Telegram voice calls and play a TTS message to the recipient.

✨ Highlights

  • Telegram authentication via Pyrogram
    • Login with API ID / API Hash (verification code + optional 2FA password)
    • Or import an existing .session file (already authenticated)
  • Home Assistant services
    • telegram_voip.call: generates TTS audio and places a Telegram VoIP call
    • telegram_voip.hangup: hangs up an active/ringing call
    • Supports multiple config entries (multiple Telegram sessions) with per-target routing
  • Sensors for automation & monitoring
    • call_state (idle / starting / ringing / in_call / ending / error)
    • call_topic, call_peer, last_error
  • Customizable call appearance
    • Optional topic can be used as temporary profile name during the call
    • Optional image path can be used as temporary profile photo during the call
    • Automatic restore of profile name/photo after the call (configurable)
  • Supported languages (TTS)
    • en, it, es, fr, de, pt, zh, ja
    • Configurable default language in Options

✅ Requirements / Notes

  • Requires FFmpeg available in your HA environment (configurable path in options).
  • Uses gTTS for speech generation (internet access may be required).
  • Session data is stored under the configured session directory (default: /config/.telegram_voip).

📦 Installation

Install via HACS as a custom repository:

  • https://github.com/Sanji78/telegram_voip
Assets 2
Loading