Sending messages from Home Assistant to Whatsapp, Signal or Telegram.
The Whatsigram Messenger is an integration for Home assistant allowing you to send messages, notifications or alerts to your preferred messenger on your mobile phone. Whatsigram can send messeges to the Whatsapp, Signal or Telegram App using the free CallMeBot service.
- Send WhatsApp, Signal or Telegram messages directly from Home Assistant.
- UI-based configuration for easy setup.
- Backward compatibility with YAML configuration.
- Supports sending messages to multiple recipients.
- Options flow to update configurations without reinstallation.
- Detailed error handling and logging for troubleshooting.
This is the recommended installation method.
- Search for and install the Whatsigram Messenger integration from HACS
- Restart Home Assistant
- Download the latest release
- Copy the contents of custom_components into the /config/custom_components directory of your Home Assistant installation
- Restart Home Assistant
The setup on your mobile phone varies slightly for each app but is always very easy to do. It allows CallMeBot to send you messages and protects your account from spam.
- Add the phone number +34 644 52 74 88 into your Phone Contacts. (Name it as you wish)
- In your Whatsapp App, send the message I allow callmebot to send me messages to the new Contact created
The bot will answer with your personal api key and an URL, you can use to send messages to yourself via CallMeBot.
Please note that using the CallMeBot service sending to Whatsapp is only free for personal use.
For more details, please refer to the CallMeBot website.
- Add the phone number +34 644 52 74 88 into your Phone Contacts. (Name it as you wish)
- In your Signal App, send the message I allow callmebot to send me messages to the new Contact created
The bot will answer with your personal api key and an URL, you can use to send messages to yourself via CallMeBot.
For more details, please refer to the CallMeBot website.
You can try sending the text /start to @CallMeBot_txtbot in your Telegram app and then send a test message on the CallMeBot page. If then your account is still not approved for CallMeBot, you can log in via this link and give CallMeBot permission to send you messages.
For more details, please refer to the CallMeBot website.
In your Home Assistant go to Settings > Devices & services and click on Add integration. In the search field, search for whatsigram and select the integration. This will add a recipient entity, you can use to send notifications to. In the name field, you can enter the recipients name or phone number or whatever you wish.
In the URL field, copy the exact URL as you received it from CallMeBot in response to your Whatsapp request.
In the URL field, copy the exact URL as you received it from CallMeBot in response to your Signal request.
Copy the URL https://api.callmebot.com/text.php?user=@myusername&text=Text into the URL field and replace @myusername with your Telegram user name.
Before submitting the form, you can tick the Send a test message check box to test your url, you have entered.
After having added your integration, you can add more recipients, if needed. Click on your Whatsap Messenger integration and then click on add service. You can add any type of recipient, whether for WhatsApp, Signal, or Telegram, as long as the recipient has prepared their mobile phone to receive CallMeBot messages.
The Whatsigram integration creates recipient entities to which standard notifications can be sent. In Home Assistant, sending a message is typically used as an action in an automation.
In your automation, click on Add action, then on Notifications, and select the action Send a notification message. In the Message field, enter your message, and as Target, click on Choose entity and select one (or more) Whatsigram recipient(s). Then save your action.
alias: Send Test Message
description: ""
triggers: []
conditions: []
actions:
- action: notify.send_message
data:
message: "This is a test message from Home Assistant"
target:
entity_id: notify.whatsigram_recipient_1
mode: single
This integration is published under the GNU General Public License v3.0.
This integration is based on the CallMeBot notification service, which is kindly provided to the community free of charge.
If this Home Assistant integration is helpful to you, please consider supporting this project. Sponsorship helps keep the project going, improve features, and fix any issues that arise. Your contribution goes a long way in making the project better for everyone.
