https://github.com/microteq/whatsigram_messenger
Sending messages to Whatsapp, Signal or Telegram from Home Assistant
https://github.com/microteq/whatsigram_messenger
home-assistant home-automation homeassistant integration messenger notifications signal telegram whatsapp
Last synced: about 2 months ago
JSON representation
Sending messages to Whatsapp, Signal or Telegram from Home Assistant
- Host: GitHub
- URL: https://github.com/microteq/whatsigram_messenger
- Owner: microteq
- License: gpl-3.0
- Created: 2025-01-29T14:44:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-27T10:37:52.000Z (12 months ago)
- Last Synced: 2025-09-20T09:59:34.700Z (9 months ago)
- Topics: home-assistant, home-automation, homeassistant, integration, messenger, notifications, signal, telegram, whatsapp
- Language: Python
- Homepage:
- Size: 248 KB
- Stars: 47
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](LICENSE)
[](https://github.com/custom-components/hacs)
[](https://github.com/microteq/whatsigram_messenger/releases/latest)
# Home Assistant Whatsigram Messenger
**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 your Whatsapp, Signal or Telegram App using the free CallMeBot service.
## Features
- Send Home Assistant alerts, notifications and messaged to your WhatsApp, Signal or Telegram App on your mobile phone.
- 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.
## Installation
### HACS (recommended)
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=microteq&repository=whatsigram_messenger)
This is the recommended installation method.
- Search for and install the Whatsigram Messenger integration from HACS
- Restart Home Assistant
### Manual
- Download the latest release
- Copy the contents of custom_components into the /config/custom_components directory of your Home Assistant installation
- Restart Home Assistant
## Preparing your mobile phone
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.
### Whatsapp
- 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](https://www.callmebot.com/blog/free-api-whatsapp-messages/) website.
### Signal
- 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](https://www.callmebot.com/blog/free-api-signal-send-messages/) website.
### Telegram
You can try sending the text **/start** to **@CallMeBot_txtbot** in your Telegram app and then send a [test message](https://www.callmebot.com/blog/telegram-text-messages-from-browser/#google_vignette) on the CallMeBot page. If then your account is still not approved for CallMeBot, you can log in via [this link](https://api2.callmebot.com/txt/login.php) and give CallMeBot permission to send you messages.
For more details, please refer to the [CallMeBot](https://www.callmebot.com/blog/telegram-text-messages/) website.
## Configuration
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.
### Whatsapp
In the URL field, copy the exact URL as you received it from CallMeBot in response to your Whatsapp request.
### Signal
In the URL field, copy the exact URL as you received it from CallMeBot in response to your Signal request.
### Telegram
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.
## Usage
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.
### Using the user interface
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.
### Writing YAML
```
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
```
## License
This integration is published under the GNU General Public License v3.0.
## Attribution
This integration is based on the [CallMeBot](https://www.callmebot.com/) notification service, which is kindly provided to the community free of charge.
## About sponsorship
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.
[](https://github.com/sponsors/microteq)
