This plug-in uses Telegram API to send push notifications via a Telegram Bot.
It's compatible with both Vera and openLuup.
This plug-in is available on both AppStore (Vera) and AltAppStore(AltUI/openLuup). Search for it and press Install.
To manually install, simply upload the files (minus license and readme, if you go for the full source code) in the release using Vera's feature (Go to Apps, then Develop Apps, then Luup files and select Upload) and then create a new device under Vera.
To create a new device, got to Apps, then Develop Apps, then Create device.
- Upnp Device Filename/Device File: D_VeraTelegram1.xml
- Upnp Implementation Filename/Implementation file: I_VeraTelegram1.xml
- Parent Device: none
After installation, ensure to change mandatory variables under your Device, then Advanced, then Variables. Please adjust BotToken and DefaultChatID to your settings.
In order to run this plug-in, you'll need to create a Telegram Bot.
No worries, it's all covered here. Go to point #3 for instructions.
Get your token and be sure the edit the BotToken variable to it. It's suggested to get your group ID or personal ID at this stage. It's covered in the aforementioned guide.
You can use this plug-in with no-code solutions (scenes, Reactor, PLEG) or using code.
Here's how to send a text message:
luup.call_action("urn:bochicchio-com:serviceId:VeraTelegram1",
"Send",
{
Text = "Hello from my home automation system",
ChatID = whatever
}, 515)
Or an image:
luup.call_action("urn:bochicchio-com:serviceId:VeraTelegram1",
"Send",
{
Text = "Hello from my home automation system",
ImageUrl = "https://media.giphy.com/media/3o84sIqsVAJNfWyjy8/giphy.gif"
}, 515)
Or a a gif/video:
luup.call_action("urn:bochicchio-com:serviceId:VeraTelegram1",
"Send",
{
Text = "Hello from Vera",
VideoUrl = "https://media.giphy.com/media/3o84sIqsVAJNfWyjy8/giphy.gif"
}, 515)
Or a silent text notification (no audio, but the notification will always appear in your notifications):
luup.call_action("urn:bochicchio-com:serviceId:VeraTelegram1",
"Send",
{
Text = "Hello from my home automation system (Silent)",
Format = "HTML",
DisableNotification = true
}, 515)
Where 515 is your device ID, ChatID is the chat id (if omitted DefaultChatID variable will be used).
Groups are supported as well. Get your group ID and just use it instead of ChatID.
If you need to pass authentication, just use UrlParams. It's a standard CURL command line switch, so be sure to test for it before adding it.
Anything CURL supports is supported (authentication headers, user agentc, ect).
luup.call_action("urn:bochicchio-com:serviceId:VeraTelegram1",
"Send",
{
Text = "Hello from my home automation system",
ImageUrl = "http://192.168.x.x/axis-cgi/admin/param.cgi?action=update&root_Image_I0_Overlay_MaskWindows_M0_Enabled=no",
UrlParams = "--digest -u username:password" -- <== curl parameters!
}, 515)
You can format your message using HTML or Markdown (default).
Send in HTML (see below for supported tags):
luup.call_action("urn:bochicchio-com:serviceId:VeraTelegram1",
"Send",
{
Text="This is <b>bold</b>\nHTML message!",
Format = "HTML",
DisableNotification = false
}, 515)
Or in Markdown (see below for supported format):
luup.call_action("urn:bochicchio-com:serviceId:VeraTelegram1",
"Send",
{
Text="This is *bold*\nMarkdown message!",
Format = "Markdown",
DisableNotification = false
}, 515)
MarkdownV2 needs to escape these special chars:
_ * [ ] ( ) ~ > # + - = | { } . !Use it only if you already escaped them in your code (use
\as prefix, ie\.).Markdown is suggested if your want to use this format and don't need advanced formatting.
See options for tags and formats.
The device is working and supported under OpenLuup and AltUI.
In this case, if you're using an old version of AltUI/OpenLoop, just be sure the get the base service file from Vera (automatically done if you have the Vera Bridge installed).
Before asking for support, please:
- change DebugMode variable to 1 (on the device itself, not on the master)
- repeat your problem and capture logs
- logs could be captured via SSH or by navigating to
http://VeraIP/cgi-bin/cmh/log.sh?Device=LuaUPnP. More Info
If you need help, visit SmartHome.Community and tag me (therealdb)./community.getvera.com/t/telegram-plug-in-to-send-text-images-and-video-notifications/215219)