whatsapp-api-client library for javascript
This library helps you easily create a javascript application to connect the WhatsApp API using service green-api.com. You need to get ID_INSTANCEand API_TOKEN_INSTANCE in the control panel in order to use this library.
Документация на русском языке
Смотрите readme на русском здесь
API
The API corresponds with REST API from green-api since the library wraps own methods as https calls to the service. Therefore using these docs is highly encouraged.
Installing
Library supports both browser environment without package managers and Node/Webpack apps with package manager that can handle require or import module expressions.
For webpack and npm based apps:
npm i @green-api/whatsapp-api-client
For vanilla html-js website modify index.html:
<script src="https://unpkg.com/@green-api/whatsapp-api-client/lib/whatsapp-api-client.min.js"></script>Authentification
Sending WhatsApp message like any other call to the API requires account registered on green-api.com and authentication completed on mobile WhatsApp app. To register account you have to proceed to the control panel. After registering you wll get own unique pair of ID_INSTANCE and API_TOKEN_INSTANCE keys.
WhatsApp mobile app authentication may be achived by using control panel. You need to scan QR-code generated within the control panel.
Examples
Send WhatsApp message
Use common javascript
const whatsAppClient = require('@green-api/whatsapp-api-client')
const restAPI = whatsAppClient.restAPI(({
idInstance: "YOUR_ID_INSTANCE",
apiTokenInstance: "YOUR_API_TOKEN_INSTANCE"
}))
restAPI.message.sendMessage(null, 79999999999, "hello world")
.then((data) => {
console.log(data);
}) ;or use browser js script
<script src="https://unpkg.com/@green-api/whatsapp-api-client/lib/whatsapp-api-client.min.js"></script>
<script>
const restAPI = whatsAppClient.restAPI(({
idInstance: "YOUR_ID_INSTANCE",
apiTokenInstance: "YOUR_API_TOKEN_INSTANCE"
}))
restAPI.message.sendMessage(null, 79999999999, "hello world")
.then((data) => {
console.log(data);
}).catch((reason) =>{
console.error(reason);
});
</script>Or use ES6 syntax. For node js app, you propably have to add in package.json property "type": "module". Notice that all examples below are ES6 based.
import whatsAppClient from '@green-api/whatsapp-api-client'
(async () => {
const restAPI = whatsAppClient.restAPI(({
idInstance: "YOUR_ID_INSTANCE",
apiTokenInstance: "YOUR_API_TOKEN_INSTANCE"
}))
const response = await restAPI.message.sendMessage(null, 79999999999, "hello world");
})();Receive notifications using webhook service REST API
import whatsAppClient from '@green-api/whatsapp-api-client'
(async () => {
let restAPI = whatsAppClient.restAPI(({
idInstance: "YOUR_ID_INSTANCE",
apiTokenInstance: "YOUR_API_TOKEN_INSTANCE"
}))
try {
// Receive WhatsApp notifications. Method waits for 20 sec and returns empty string if there were no sent messages
console.log( "Waiting incoming notifications...")
let response
while (response = await restAPI.webhookService.receiveNotification()) {
let webhookBody = response.body;
if (webhookBody.typeWebhook === 'incomingMessageReceived') {
console.log('incomingMessageReceived')
console.log(webhookBody.messageData.textMessageData.textMessage)
// Confirm WhatsApp message. Each received message must be confirmed to be able to consume next message
await restAPI.webhookService.deleteNotification(response.receiptId);
} else if (webhookBody.typeWebhook === 'stateInstanceChanged') {
console.log('stateInstanceChanged')
console.log(webhookBody.instanceData.wid)
} else if (webhookBody.typeWebhook === 'outgoingMessageStatus') {
console.log('outgoingMessageStatus')
} else if (webhookBody.typeWebhook === 'deviceInfo') {
console.log('deviceInfo')
}
}
} catch (ex) {
console.error(ex.toString())
}
})();Send WhatsApp file
import whatsAppClient from '@green-api/whatsapp-api-client'
(async () => {
const restAPI = whatsAppClient.restAPI(({
idInstance: "YOUR_ID_INSTANCE",
apiTokenInstance: "YOUR_API_TOKEN_INSTANCE"
}))
const response = await restAPI.file.sendFileByUrl(null, 79999999999, 'https://avatars.mds.yandex.net/get-pdb/477388/77f64197-87d2-42cf-9305-14f49c65f1da/s375', 'horse.png', 'horse');
})();Send WhatsApp message and receive webhook
Webhooks are event-based callbacks invoked by green-api server as responses to client API calls. Webhooks support node js and express based apps only.
import whatsAppClient from '@green-api/whatsapp-api-client'
import express from "express";
import bodyParser from 'body-parser';
(async () => {
try {
// Set http url, where webhooks are hosted.
// Url must have public domain address.
await restAPI.settings.setSettings({
webhookUrl: 'MY_HTTP_SERVER:3000/webhooks'
});
const app = express();
app.use(bodyParser.json());
const webHookAPI = whatsAppClient.webhookAPI(app, '/webhooks')
// Subscribe to webhook happened when WhatsApp delivered a message
webHookAPI.onIncomingMessageText((data, idInstance, idMessage, sender, typeMessage, textMessage) => {
console.log(`outgoingMessageStatus data ${data.toString()}`)
});
// Run web server with public domain address
app.listen(3000, async () => {
console.log(`Started. App listening on port 3000!`)
const restAPI = whatsAppClient.restAPI(({
idInstance: MY_ID_INSTANCE,
apiTokenInstance: MY_API_TOKEN_INSTANCE
}));
// Send test message that triggers webhook
const response = await restAPI.message.sendMessage(null, 79999999999, "hello world");
});
} catch (error) {
console.error(error);
process.exit(1);
}
})();Deploying development environment
Any help with development and bug fixing is appreciated. In order to deploy test-ready environment please make the steps:
- Сlone repo with
git clone - Install dependencies with
npm install - Install globally libraries
rollupfor bundled builds. - Add webhooks as new dev express via npm
npm isntall express --save-dev. Dont forget to delete it before making pull request - Create .env file in root folder and add environment variables using example file env.example
- Add
"type": "module"to the package.json
Build
Compile browser and node|webpack versions with single command:
npm run build
Third-party libraries
License
Licensed on MIT terms. For additional info have look at LICENSE