node-red-contrib-whatsapp-link
v0.1.39-C
Published
Node to send and receive whatsapp messages in groups and chats. | No third party APIs
Downloads
473
Maintainers
Readme
Whatsapp Link :iphone:
Simple node for connecting Node-Red to Whatsapp :iphone: Send and Receive Whatsapp Image/Text.
Currently in developing mode, Continous updated may encounter. :sweat_smile:
To Connect with Whatsapp
- Deploy whatsapp admin node (along with whatsappLink node).
- whatsappLink node will initilize, connect with whatsapp and generate a QR code below the Admin Node (in terminal also).
- Scan the QR code with your Whatsapp Mobile App (Go to settings > Linked device > Scan & Connect).
- Done - Whatsapp Connected.
- Send "
!nodered
" to get a reply from Node-Red in Chats/Groups.
if Whatsapp Web not working ?
Their is lite version also avilable in it. Totally different from Whatapp-Web, Whatsapp-Lite (Beta Mode) works on Web-Sockets only, It might work for you also.
Simply chosse Whatsapp Lite
in Whatsapp-Link configration node.
It will create a Whatsapp Web instance in your machine and store your session locally in Node-RED. All data are store in users <user>/.node-red/Whatsapp-Link
folder. Near you Node-Red's settings.js file.
Nodes
Whatsapp Admin : Node used for first time users to connect with whatsapp and other admin related tasks. Admin Node generate QR Code just below the node for easy connection with whatsapp.
| Inputs | Description | |--------|-------------- | | test | Checks the current status of whatsapp and output the same in
msg.payload
| | destroy| Close the client and destroy the whatsapp connection.| | restart | Restart the whatsapp connection. | | logout | Simply log you out and close the session. || Output | Description | |--------| ------------| |
status
| provide status onmsg.payload
for all and each input mentioned in above table. | | Connecting..| When whatsapp attempting to connect. | QR Code (image) | when QR code is generated. This method can also be used to get QR Code (image) generated by whatsapp. | Connected | When whatapp is sucessfully connected.| | Group Joined or Removed |msg.paylod
: Group Name.msg.type
: joined / Removed from group.msg.notification
: Complete notification.msg.chat
: Complete Group Details.Chats In : Node to recive all messages send to connected number.
- Simply deploy the node and wait for green (connected) status.
- After succesfully connection, Node is able to recive all messages.
| Output | Description | |--------|-------------| |
msg.paylod
| Recived message | |msg.from
| Sender Number | |msg.chatID
| Chat ID of Group chat / Personal chat | |msg.message
| Complete message object. Some extra details for advance users |Their are many other events options avilable along with
message
event in Chats-In Node. For details refer documentation for Chats-In Node.Chats / Group Out : As simple as mention on name, node will send
msg.payload
recived at input to the number mentioned in node.ImageMessage.json
example is avilable in examples to import.MultiMedia Message: Requirments- | Input | Description | |--------|-------------| |
msg.image
| Base64 (encoded image),image-tool
node work fine for incoding base64| |msg.payload
| Image Caption | |msg.toNumber
| Reciver number (if number not provided in node) |Don't forget to mention international dialing code befor your number. Number must be in format like +11 99999 99999 without any space. OR Leave the Number blank and provide the number along with paylod at
msg.toNumber
with international code. To send message on multiple contacts an Arrar of number can be passed onmsg.toNumber
likemsg.toNumber
= ["+1199999999", "+12990000099", "+1311111111"].Group Message : Whatsapp Group Node to send message in a Group.
The node will send recived
msg.payload
to a group chat.
A-reply-to-All.json
example is avilable in examples to import.
- Reply Node : In Beta mode. (Chats-out Node can be used instead of reply node)
Node will reply(the payload
) on each message starting with string mentioned in instruction coloum or defaults !red
. Avoid using it please.
Issues & Updates
Issues and Suggestions are welcome here.
Ver-0.1.21
: Group Message Node added.Ver-0.1.23
: Nodes are formatted correctly and names are updated.Ver-0.1.28
: Now QR Codes are directlly avilable in run time on Whatsapp-Admin-Node.Ver-0.1.30
: Message can be send to an Array of contacts provided atmsg.toNumber
.Ver-0.1.32
: Socket basedWhatsapp Lite
config node added in beta mode. Image message sending support added in chats-out node.Ver-0.1.33
: Button and list support added, Minnor bugs fixed.Ver-0.1.34
: Multiple Events reading options are added in Chats-In Node.Ver-0.1.36
: Check box added to show status asOnline/Offline
in Whatsapp-Link Node, to get push notifications. Ping-Interval added to keep whatsapp alive for long time. Multiple examples added.Ver-0.1.37
: Changes for correction of send message with images and use Chromium profiles in Puppeteer.Ver-0.1.39B
: Broken "Whatsapp-Web & Lite" fixed. Able toSend/Receive
whatsappImage/Text
in both Whatsapp-Lite & Web. working on easy to use nodes.
Future Nodes
Currently working on more Whatsapp Node and will be avilable soon -
- Chat Reply node. (working)
- Whatsapp button message.
- Whatsapp List message.
- Instruction (smart) Reply Node.
Complete detail for Nodes will also be updated as soon as possible.
Please don`t try to spam with your personal Number, Suspicious activities might be tracked by whatsapp.
Thanks to bear with me