This document provides step-by-step instructions on how to enroll a mywhin instance in WhatsApp.

mywhin is an API that allows you to access WhatsApp features programmatically. By following these steps, you will successfully enroll your instance and start using mywhin features within your application.

Prerequisites: Before you begin the enrollment process, please ensure you have an active subscription on rapidapi for mywhin. Switch the browser to a light background, so that the QR can be read correctly.

Step 1: Create mywhin Instance.

Use the endpoint called create (under instance management category on the playground) to create a mywhin instance:
GET /create
This will create a new mywhin instance, linked to your rapidapi user, that can be enrolled in WhatsApp.

Step 2: Check mywhin Instance Status.

After creating the mywhin instance, use the endpoint called status (under instance management category on the playground) to check its status:
GET /status
The status should be “Pending Enrollment” at this stage.

Step 3: Enroll mywhin to WhatsApp

To enroll your mywhin instance in WhatsApp, use the endpoint called enroll (under instance management category on the playground):
GET /qrpng
This endpoint will provide you with a QR code rendered on the rapidapi playground. You must scan this QR code using the WhatsApp mobile app.

• Make sure you have set rapidapi playground to light mode.
• Open WhatsApp on your mobile device, go to Settings > Linked Devices, and scan the QR code displayed on your computer screen. This step establishes a connection between mywhin and your WhatsApp account.
• Bear in mind you need to wait 10 to 15 seconds for the QR to generate and render on the screen, do NOT call this endpoint twice and wait until the QR is shown to avoid scanning a QR that is expired.

Step 4: Check mywhin Instance status is Enrolled

After successfully scanning the QR code with the WhatsApp mobile app, use the status endpoint again (same as on step 2) to check if your mywhin instance is correctly enrolled:
GET /status
The status should now be “Enrolled,” and it should display the phone number that has been enrolled for WhatsApp on the response body.

Congratulations! You have successfully enrolled your mywhin instance in WhatsApp, and you can now use WhatsApp features within your application.

FAQ:
Can I enroll more than one whatsapp number on mywhin?
You can enroll different numbers to a mywhin instance, but only one at a time. Each instance can be linked to one number.

What happens if I send several requests to the create endpoint?
You can only have one instance, sending requests to this endpoint after your instance is created has no effect.

When I try to enroll a new instance of MyWhin, why can I successfully enroll an iPhone but not an Android device?
Some users have reported that if the background color of the browser displaying the QR code is dark, the QR code may not be read correctly on Android devices. Try switching to a light background.

How many requests can I send to status endpoint?
You can send all the requests you need to this endpoint along the life of your instance, it will help you know the current status among the three possible: sleep, active or pending enrollment.

Do I have to use the RapidAPI playground for enrollment, or can I perform it programmatically?
We recommend using the playground initially to familiarize yourself with the process and the timing of each step, but you can certainly complete the enrollment process programmatically as well. As a practical example, you can learn how to implement these steps using Node-RED watching a video tutorial at this link: https://youtu.be/QFBl6lxJ22E.