SMRT ChatBot is a multi-platform messaging bot designed to integrate with popular services like WhatsApp, Signal, and Telegram.
It enables seamless communication, automation, and control of smart home devices through Home Assistant.
The bot supports text and voice commands, message sending via REST API, and advanced features like voice transcription and AI-powered summaries.
Always getting endless voice messages from friends? Add this bot to the group or forward the voice message to it and it will give you a transcription and an AI summary.
The bot allows you to forward commands and voice messages to be processed by Homeassistant.
You can send text commands like in homeassistant chat via:
#ha turn the living room light onYou can also use the announce functionality. For this to work you need to tag the assistant device with the label sayCommand. The command will call all assistants.
Then you can use:
#say Announce something. To build the project using Docker Compose, run:
docker compose buildThis command will build all services defined in your docker-compose.yml file. Make sure Docker and Docker Compose are installed on your system.
Before running the project, ensure you have set up your config.yml file in the root directory with the necessary configuration for your messaging platforms.
To start the services, run:
docker compose upThis will launch the bot.
Configuration is done in a config.yml file in the root of the project.
Whatsapp can be integrated using WPPConnect Server project on GitHub. Install wpp-connect server and configure the endpoint in the bot configuration as follows.
whatsapp:
wppconnect_api_key: "Generated API Key"
wppconnect_server: "http://127.0.0.1:21465"Signal Messenger can be integrated using the signal-cli-rest-api project on GitHub.
Install the signal-cli REST API server and register your number with it.
Then configure the endpoint in the bot configuration as follows.
signal:
host: 127.0.0.1
port: 8080
number: "+491712345678"To integrate Telegram Messenger, you need to obtain a bot token. Follow the official Telegram Bot tutorial to create a bot and get your token.
Additionally you have to set Privacy for groups to disabled for commands to work properly. Go to Botfather in Telegram, click edit bot settings and chose Group Privacy. Then set it to disabled. This allows the bot to read and respond to all group messages.
telegram:
telegram_api_key: "XXXX:YYYY" The bot allows to send homeassistant commands either as text or as voice commands.
For voice commands you must set up a voice pipeline, e.g. using Nabu Casa's subscription or local processing with speech-to-phrase or whisper (see https://www.home-assistant.io/blog/2025/02/13/voice-chapter-9-speech-to-phrase/).
Example: #ha turn the living room light on
In the configuration the whitelist is mandatory. This is for you to define in which groups or from which senders the bot should process homeassistant commands.
To get the token, go to your Profile in homeassistant - Security and then click Create Token at the bottom of the ling-lived access token list.
homeassistant:
token: "HOMEASSISTANT_TOKEN"
ws_api_url: "ws://homeassistantIP:8123/api/websocket"
chat_id_whitelist: [
"signal://XXXX", # Signal Home Group
"whatsapp://[email protected]" # Whatsapp Home group
]
process_without_command: true # optional, default = false if true, will process any text command without the #ha prefixThe bot can also translate voice messages using whisper. To enable this, you need to add the following lines.
It is possible to disable the transcription for certain groups by adding them to the blacklist.
To use the AI summary function you must configure ollama.
voice_transcription:
min_words_for_summary: 10 # minimum number of words for a summary to be generated
summary_bot: "ollama:gemma3:12b" # optional
# blacklist chat ids for voice transcription
chat_id_blacklist: [
"signal://XXXX", # Signal Home group
"whatsapp://[email protected]" # Whatsapp Home group
] Ollama can be used in some of the commands, e.g. for summaries in voice transcriptions.
Configure ollama with the following settings.
ollama:
host: "http://127.0.0.1:11434"Models can be chosen via ollama:modelname.
Llama.cpp server can also be used.
ollama:
host: "http://127.0.0.1:8000"Models can be chosen via llama_cpp:modelname.
Note: Models are actually not yet chosable as llama server only loads one model.
For some commands you need to configure the chat ids that should be used. A chat id identifies a contact or group within one of the messengers.
After adding the bot to the group or talking directly with it, you can get the chat id with the #chatid command.
To activate the #chatid command add the following line to your config.yml.
chatid:The bot provides a REST api endpoint which you can pass a message and a list of chatIds. With this you can send messages from other systems, e.g. notifications from Homeassistant.
The chat id for the respective chat you can obtain using the #chatid command after you added the bot to the chat.
curl -X POST http://localhost:5000/send_message \
-H "Content-Type: application/json" \
-d '{"chatIds": ["whatsapp://[email protected]", "signal://KKKKvv+", "signal://+49166666666"], "message": "Hello!"}'In your configuration.yml you need to make homeassistant aware of the rest service to send messages through. The service allows to send messages to one or multiple chat ids.
To get the chat ids, use the #chatid command in the respective chat.
rest_command:
rest_send_chat_notification:
url: "http://127.0.0.1:5000/send_message"
method: post
headers:
Content-Type: application/json
payload: >
{
"chatIds": {{ chat_ids }},
"message": "{{ message }}"
}You can use the rest command directly or add scripts to send to specific groups.
To create a script, add a new one under Settings - Automations & Scenes - Scripts.
alias: Send Chat Notification
description: Sends a message via chat
fields:
message:
name: Message
description: The message to send to the channel
required: true
example: Hello from Home Assistant!
sequence:
- data:
message: "{{ message }}"
chatIds:
- "signal://YourSignalChatId"
- "whatsapp://[email protected]"
action: rest_command.rest_send_chat_notification