chrishubert / whatsapp-api Goto Github PK

This one is a lot of work,

I use Swagger Autogen (swagger-autogen)
I'm calling for potential contributors to help improve it 🥰

The syntax is quite straightforward with multiple examples across the code with an example here

Once written, it's as easy as running npm run swagger to generate the doc!

I was testing the api today, I thought it was really cool, congratulations, I would like to ask a question in case I can't send the buttons, am I doing something wrong or it still doesn't work? my wpp is business

When I terminate a session, it doesn't seem to logout of the session on the whatsapp, it still shows on mobile app as paired. is that right or am I doing something wrong?

also how do I fetch group messages, I haven't been able to find a way, when I use a serialized chatid(###########-##########@g.us) the fetchMessages doesn't like it and throws a 404 error. is there a way of doing it that I missed?

thanks for the awesome project!

any plan to route the QRCode, than we use webhook?

Hello, can you add poll sending option through api?

I have this problem, could you explain to me what I'm doing wrong?

Hello, because in my normal WhatsApp sending buttons and sending lists does not work.

it's work ?

Hi Chris,

how we use other webhook.site alternative like

https://github.com/syifarahmat/webhook

what can i do? after.

the development idea is really cool,

but I tried to run tests with the methods in swagger but many are still confusing or showing errors,

Does the one marked with ✅ mean it's ready to use?
or how?

I ask for an explanation..

After deployed prod it is not working always give you

{
"success": false,
"message": "qr code not ready or already scanned"
}

Today starting the server:

> [email protected] start c:\node\WAppAPI\whatsapp-api
> node server.js

Server running on port 8800
existing session detected session
Failed to send new message webhook: session loading_screen Request failed with status code 404 { percent: 0, message: 'WhatsApp' }
Failed to send new message webhook: session loading_screen Request failed with status code 404 { percent: 100, message: 'WhatsApp' }
Failed to send new message webhook: session authenticated Request failed with status code 404 undefined
Failed to send new message webhook: session ready Request failed with status code 404 undefined

After a while, it start receiving (very old) messages, but it's impossible to send one, with error:

Session state: session CONNECTED
TypeError: data.id.id.substring is not a function
    at Message._patch (c:\node\WAppAPI\whatsapp-api\node_modules\whatsapp-web.js\src\structures\Message.js:91:75)
    at new Message (c:\node\WAppAPI\whatsapp-api\node_modules\whatsapp-web.js\src\structures\Message.js:18:24)
    at Client.sendMessage (c:\node\WAppAPI\whatsapp-api\node_modules\whatsapp-web.js\src\Client.js:699:16)
    at runMicrotasks (<anonymous>)
    at processTicksAndRejections (internal/process/task_queues.js:95:5)
    at async sendMessage (c:\node\WAppAPI\whatsapp-api\src\controllers\clientController.js:29:22)

It was working until yesterday.

hello, I did not find these things in the documentation, can you tell? everything I tried didn't work either, can you help with easas 3 questions?

How can I send a message to a number?

How can I send a message to a group?

how can i create a group?

Sir,
Can you please add Text Button with Message ? If possible please do it

When I run http://localhost:3000/api/startSession/ABCD QR not Received in Callback. but response showing {"success":true,"message":"Session initiated successfully"}
Please guide me how i can solve the issue.

I setup ENV in Production like Below -

# Application
PORT=3000 # OPTIONAL
API_KEY=your_global_api_key_here # OPTIONAL
BASE_WEBHOOK_URL=https://webhook.site/9d706220-f9cb-4a59-97c9-09bcfa6caccd # MANDATORY
ENABLE_LOCAL_CALLBACK_EXAMPLE=FALSE # OPTIONAL, NOT RECOMMENDED FOR PRODUCTION
MAX_ATTACHMENT_SIZE=10000000 # IN BYTES

Is it possible to send a message to multiple numbers with just one api call? Or is there any other way to, if sending the same file multiple times, not have to download the whole file every time?

Hi, i would like to suggest to implement qrcode visibility in web browser (when accessing session start endpoint).
This project apparently works well on CasaOS Home assistance, all based in docker compose applications.
This way, i cant see qrcode on docker startup.

Expected Behavior:
When initiating a session through the /start endpoint, the response should include a QR code that users can scan with their devices to complete the session setup process.

Current Behavior:
Currently, the /start endpoint response does not include a QR code for session setup, which makes it less intuitive for users to complete the process.

Steps to Reproduce:

1. Make a POST request to the /start endpoint with the required parameters.
2. Check the response received from the endpoint.

Proposed Solution:
Include a QR code image in the response JSON of the /start endpoint. The QR code should contain a unique identifier or session token that can be used by the client to confirm and finalize the session setup. This would improve user experience and streamline the process.

Labels:

• enhancement
• API

How do I convert the qr_code that comes in the webhook to a qr_code in a format that I can scan on the device?

My suggestion is to add additional case to make possible to send message with media:

clientController.js

case 'MessageWithMedia': {
        const { mimetype, data, filename, filesize } = options.media
        options.media = new MessageMedia(mimetype, data, filename, filesize)
        messageOut = await client.sendMessage(chatId, content, options)
        break
}

After I updated to the latest docker image, I can no longer send messages. I always receive {"success":false,"error":"session_not_connected"} even I restarted the session many times for different devices

In Ampere A1 Compute

I got this message

ERROR: for app no matching manifest for linux/arm64/v8 in the manifest list entries
ERROR: no matching manifest for linux/arm64/v8 in the manifest list entries

hello!

I was able to install it, but I am not able to show the QRCODE in a URL so that it can be scanned, how could I do that?

thanks.

Hey,

I'm looking to know if a phone number is in-use on Whatsapp and get their profile picture. I can do that on my phone but I've been interested to know if it's possible with your library ?
I've looked at your swagger.json but I don't think I'm seeing something related. I did see /client/getProfilePicUrl/{sessionId} but I'm guessing anything starting with /client/ is for our account and not someone else account so I can't use it to lookup someone else profile's picture.

Something that seems like it could be what I'm looking for in your README, is "Is On Whatsapp ?" feature, however I'm not seeing something anything about it in the swagger.json

Is anyone experiencing an issue with whatsapp messages stop sending about 2 days ago. IT was working fine all along and then 2 days ago messages keep failing. Any ideas?

Hi, can you tell me if it is possible to implement a new method or algorithm for checking the validity (activity of a particular session) in my practice there are cases when the container works, there are no errors in the logs, but when a request for session status is thrown out, it is simply expired after the waiting timeout, this applies to all aspects related to session administration, there are also cases when there are several sessions on one service, but one of which stops working in this way, while the other works fine, so the question is whether it is possible to implement a method of restarting a session or service of everything, or advice from your side?

Hello,
I tried to start a new session by using the endpoint http://localhost:3000/session/qr/:sessionId/image/,
the response returned {"success":false,"error":"Session should be alphanumerical or -"},
could you please tell me how can I start a new session an save it ?
thank you in advance,

Sir,
When i create an Instance it continue send QR code in call back in every second . it stop when Instance is Deleted.

My point is:
After creating an instance , After 1-2 minute , if QR not scan within 2 minute , this will go to sleep mode and will not send any Call back for that QR of specific Instance.

Later if need to Scan QR again , we have to call a api and then again QR receving will start.

It may help us to Reduce server Load

Hello,

I don't know why after success scan barcode then wait until some minutes then try to call session/status/:sessionId always get response below.

Running with docker.

Could you help me?

Thanks.

Can this API supply bulk message with delay by default?

Hi @chrishubert, first of all - thx for your solution, it's good!

But, could you please add some tags for the builds on Docker Hub?
Smth like this:

      - name: Build and push
        uses: docker/build-push-action@v4
        with:
          push: true
          tags:  | 
             'chrishubert/whatsapp-web-api:latest'
             'chrishubert/whatsapp-web-api:${{ env.SHORT_REF_NAME }}_${{ env.SHORT_SHA }}

It will be more convenient to use on K8S.

it's missing REST API or DOC?

I'm trying develop with HTTPS but it's failed, forbiden status when i change to http, it's normal.

i'm trying running production mode with nodejs command

node server.js

I need images to be displayed on my frontend

Hi,
Is it posssible through a contactId that we haven't chatted with, get their Bio ?
On web.whatsapp.com when I search for a new phone number, that I check their profile, sometime I can see this :

I did try :

curl -X POST http://localhost:3000/contact/getAbout/ABCD
-H "Content-Type: application/json"
-d '{"contactId": "{phone}@c.us"}'

I get: {"success":true,"result":{}}
(nothing in the result property)

Thank you !

After setting up a new server from scratch, logging in and then sending a message I get the error "session_not_connected".

In the webhook it does not show the "authenticated" and "ready" messages and stops at the message "A carregar as suas conversas".

I encountered the following error when trying to send a message:

{"success": false, "error": "Evaluation failed: TypeError: Cannot read properties of undefined (reading 'createWid')\n at __puppeteer_evaluation_script__:2:53"}

Hi,

In my logs I see that the following message is delivered every time I start a new session, what is that?

Failed to send new message webhook: ABCD media Request failed with status code 413 {
  messageMedia: MessageMedia {
    mimetype: 'video/mp4',
    data: 'AAAAHGZ0eXBtcD.....'
message: Message {
    _data: {
      id: [Object],
      body: '',
      type: 'video',
      t: 1690598727,
      notifyName: '',
      from: 'status@broadcast',
      to: '[email protected]',
      author: '[email protected]',

After decoding the above message, I see this:

Thanks,

I cannot figure out how to archive a chat.
I tryed to read whatsapp-web.js documentation with no success.
Can you help me?

As the subject.

Windows 11, do you need more informations?

Hi there, thanks for the amazing build. Am running well but need some feedbacks on the production.

for Production, it stated
Run periodically the /api/terminateInactiveSessions endpoint to prevent useless sessions to take up space and resources

in My Case, I'm only running 1 whatsapp instance using 1 session-id. Send message occasionally (probably 1-2 message per day).
Do I have to run that periodically?

At the moment, I only started the instance once, and will keep running unless server restart or so.

Sir,
Chrome Take High Memory resources. some plugings using WebSocket. Not running Selenium or Chromimum saves you like half a gig of ram. How it can be possible here ?

Thanks for the great repo!!!
I'd suggest two things:

• create git tags for every release? So, we that we can compare changes between versions
• create tags for docker images, so that we can use old image versions as sometimes the lastest one could fail

Great job, Christophe! I hope we'll see these benefits soon."

Send Image Message
Send Video Message
Send Audio Message
Send Document Message
Send File URL
Send Button(Template) Message
Send Contact Message
Send List Message
Set Status
Send Button With Media
Is On Whatsapp?
Download Profile Pic
User Status
Block/Unblock User
Update Profile Picture

Create Group
Leave Group
All Groups
Invite User
Make Admin
Demote Admin
Group Invite Code
All Groups
Update Group Participants
Update Group Setting
Update Group Subject
Update Group Description

Thank you for your effort.

Hello, thanks for putting this together, and sorry my dumb questions below (Im more used to "MyZap api").

If I understand correctly, the webhook url is stored in the .env, and there is no endpoint or way to update the .env webhook urls while the node app is running, right?

I ask this because my use case is several clients with unique, optional, webhook urls, as its used in MyZap and some others...

For now my osha solution is to route every client to BASE_WEBHOOK_URL, and then re-route them again individually, unless Im missing something as big as a house?