# iobroker.whatsapp-cmb

> Allows to send to your whatsapp the messages from ioBroker

Latest version **1.1.0** (published 2026-11-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install iobroker.whatsapp-cmb
pnpm add iobroker.whatsapp-cmb
yarn add iobroker.whatsapp-cmb
bun add iobroker.whatsapp-cmb
```

## Health

**Score 60/100 (C)** — status: active.

Positive: no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.1.0 |
| Published | 2026-11-19 |
| First published | 2020-08-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=22.19.0 |
| Dependencies | 2 |
| Unpacked size | 103.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 12 |
| Author | bluefox |
| Maintainers | bluefox |
| Keywords | ioBroker, whatsapp, notifications |

## Links

- npm: https://www.npmjs.com/package/iobroker.whatsapp-cmb
- Repository: https://github.com/ioBroker/ioBroker.whatsapp-cmb
- Issues: https://github.com/ioBroker/ioBroker.whatsapp-cmb/issues
- npm.io page: https://npm.io/package/iobroker.whatsapp-cmb

## Dependencies (2)

- [axios](https://npm.io/package/axios.md) ^1.20.0
- [@iobroker/adapter-core](https://npm.io/package/@iobroker/adapter-core.md) ^3.4.3

## Alternatives

- [update-check](https://npm.io/package/update-check.md) — 4.0M weekly downloads
- [react-native-onesignal](https://npm.io/package/react-native-onesignal.md) — 134.5K weekly downloads
- [react-redux-toastr](https://npm.io/package/react-redux-toastr.md) — 33.7K weekly downloads
- [@nocobase/plugin-notification-manager](https://npm.io/package/@nocobase/plugin-notification-manager.md) — 2.0K weekly downloads
- [react-simple-toasts](https://npm.io/package/react-simple-toasts.md) — 1.9K weekly downloads

## Recent versions

- 1.1.0 (latest) — 2026-11-19
- 0.3.0 — 2024-05-25
- 0.2.3 — 2022-08-29
- 0.2.2 — 2022-03-27
- 0.2.1 — 2022-03-25
- 0.1.6 — 2020-08-31
- 0.1.5 — 2020-08-31
- 0.1.3 — 2020-08-29
- 0.1.2 — 2020-08-29
- 0.1.1 — 2020-08-29
- 0.1.0 — 2020-08-28
- 0.0.2 — 2020-08-28
- 0.0.1 — 2020-08-27

## README

![Logo](admin/whatsapp-cmb.png)
# ioBroker.whatsapp-cmb

![Number of Installations](http://iobroker.live/badges/whatsapp-cmb-installed.svg)
![Number of Installations](http://iobroker.live/badges/whatsapp-cmb-stable.svg)
[![NPM version](http://img.shields.io/npm/v/iobroker.whatsapp-cmb.svg)](https://www.npmjs.com/package/iobroker.whatsapp-cmb)

![Test and Release](https://github.com/ioBroker/ioBroker.whatsapp-cmb/workflows/Test%20and%20Release/badge.svg)
[![Translation status](https://weblate.iobroker.net/widgets/adapters/-/whatsapp-cmb/svg-badge.svg)](https://weblate.iobroker.net/engage/adapters/?utm_source=widget)
[![Downloads](https://img.shields.io/npm/dm/iobroker.whatsapp-cmb.svg)](https://www.npmjs.com/package/iobroker.node-red)

**This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers.** For more details and for information how to disable the error reporting see [Sentry-Plugin Documentation](https://github.com/ioBroker/plugin-sentry#plugin-sentry)! Sentry reporting is used starting with js-controller 3.0.

## whatsapp-cmb adapter for ioBroker
Big thanks to free [CallMeBot](https://www.callmebot.com/blog/free-api-whatsapp-messages/) service, this adapter allows you to send WhatsApp messages to yourself or other number.

**Note** : *The Free API is only for personal use!*

### Configuration
*Following documentation was copied from [callmebot](https://www.callmebot.com/blog/free-api-whatsapp-messages/) page.*

You need to get the API key from the bot before using the API:

- Add the phone number XXXX (get the current one from the CallMeBot page) into your Phone Contacts. (Name it as you wish.)
- Send this message `I allow callmebot to send me messages` (in English) to the new contact created (using WhatsApp of course).
- Wait until you receive the message `API Activated for your phone number. Your APIKEY is 123123` from the bot. As this is still in beta testing, the activation can take up to 2 minutes.
- The WhatsApp message from the bot will contain the API key needed to send messages using the API.
- You can now use the API KEY in the ioBroker configuration.

Example:
![Example](img/whatsapp.jpg)

### Usage
There are two possibilities to send a messages:
- via `whatsapp-cmb.0.sendMessage`. Just write some text into this state and the message will be sent to default number, that was configured in settings dialog.
- via message from javascript adapter:
```
sendTo('whatsapp-cmb.0', 'send', {
    text: 'My message', 
    phone: '+491234567890' // optional, if empty the message will be sent to the default configured number
});
``` 

`sendTo('whatsapp-cmb.0', 'help', {})` answers `{ help, commands }`: a description of all messages with their
parameters for AI agents (e.g. ioBroker.pi-agent) and script authors, and the list of all commands with `write`
(whether the command has an effect, e.g. sends a message).

![Blockly](img/blockly.png)

If you want to send emojis please refer to https://www.callmebot.com/uncategorized/how-to-use-emoticos-with-the-api/

<!--
	Placeholder for the next version (at the beginning of the line):
	### **WORK IN PROGRESS**
-->
## Changelog
### 1.1.0 (2026-11-19)
- (bluefox) Added the message `help`: a description of all messages for AI agents (e.g. pi-agent), and `common.supportedMessages.help`

### 1.0.0 (2026-10-13)
- (ioBroker-Bot) Adapter requires js-controller >= 6.0.11 now.
- (bluefox) The adapter was refactored to TypeScript and JsonConfig
- (bluefox) Breaking: Node.js >= 22.19, js-controller >= 6.0.11 and admin >= 7.0.0 are required now
- (bluefox) Replaced the deprecated `request` package with `axios`
- (bluefox) The Blockly block was migrated to TypeScript and works again with the current Blockly editor
- (bluefox) Blockly: an empty message no longer breaks the script, the log shows the phone number value

### 0.3.0 (2024-05-25)
* Important: Node.js 18 and js-controller 5.0.19 is required at least
* (Sneak-L8) Treats all response codes other than 200 as errors

### 0.2.3 (2022-08-29)
* (Apollon77) Refer to website for current phone number

### 0.2.2 (2022-03-27)
* (Apollon77) Fix message encoding

[Older changelogs can be found there](CHANGELOG_OLD.md)

## License
MIT License

Copyright (c) 2020-2026 Bluefox <dogafox@gmail.com>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

---
_Source: https://npm.io/package/iobroker.whatsapp-cmb · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
