Introduction A WhatsApp session in GoWAPI allows you to connect your WhatsApp account to our platform, enabling you to send and receive messages programmatically. This guide will walk you through the process of creating your first WhatsApp session. Note: To use GoWAPI, you need an active WhatsApp account on your mobile device. The phone number associated with this account will be used for all messages sent through the platform*.* Before you begin Make sure you have the following ready: - A smartphone with an active WhatsApp account - A stable internet connection on both your computer and smartphone - A GoWAPI account (if you don't have one yet, create your free account) Step-by-step guide Step 1: Access the WhatsApp Sessions page 1. Log in to your GoWAPI account 2. From the dashboard, click on "Devices" in the left sidebar 3. Click the "Create New Session" button in the top-right corner Step 2: Configure your session 1. Enter a name for your Device (e.g., "Business Account", "Customer Support") 2. Add the phone number that will be used to send the message this will help you identify this session later, click "Save" 3. After create choose your session settings: - Message logging: Enable to keep a record of all messages sent and received - Proxy: Enable proxy (server, login and password). - Webhooks: Enable to receive real-time notifications by providing a URL and selecting events (message received, status updates, etc.) (Learn more about webhooks in our webhooks documentation) 4. Click "Save Device" Step 3: Scan the QR code 1. A QR code will be displayed on your screen 2. Open WhatsApp on your smartphone 3. Tap the three dots (⋮) or settings icon in the top-right corner 4. Select "Linked Devices" 5. Tap "Link a Device" 6. Point your phone's camera at the QR code on your computer screen 7. Wait for the scanning process to complete Tip: If you're having trouble scanning the QR code, make sure your phone's camera is clean and the screen brightness is high enough. You can also try adjusting the distance between your phone and the screen*.* Step 4: Confirm connection 1. Once the QR code is successfully scanned, your phone will show a confirmation message 2. GoWAPI will display a "Connection Successful" message and indicate that the session is now connected 3. You can now start sending API requests to this WhatsApp Session 4. Check our API documentation to learn how to integrate GoWAPI with your applications Understanding Session status Your WhatsApp session can have different statuses: - Connected: The WhatsApp session is connected and ready to use - Connecting: The WhatsApp session is in the process of connecting - Pending/Disconnected: The WhatsApp session is disconnected - Needs QR Scan: The WhatsApp session needs QR code scanning to connect - Logged Out: The WhatsApp session is logged out - Expired: The WhatsApp session has expired You can see the status of your session on the WhatsApp Sessions page. If your session becomes disconnected, you can reconnect it by clicking the "Reconnect" button and scanning the QR code again. Important Disclaimers and Limitations Please read these important limitations and disclaimers carefully before using WhatsApp sessions: - Session count: The number of sessions you can create depends on your subscription plan - Periodic re-authentication: WhatsApp may require you to re-scan the QR code periodically for security reasons Important Disclaimer: You are solely responsible for all messages and content sent through your WhatsApp number. GoWAPI is not responsible for any bans or blocks imposed by WhatsApp on your number and cannot assist in unblocking accounts. Messages will be sent from your personal phone number, so use the service responsibly. Troubleshooting connection issues If you're having trouble connecting your WhatsApp session, try these solutions: - Refresh the QR code by clicking the "Refresh QR Code" button - Ensure your phone has a stable internet connection - Restart the WhatsApp application on your phone - Clear your browser cache and cookies - Try using a different browser - Make sure your WhatsApp app is updated to the latest version For more detailed troubleshooting, see our Troubleshooting Connection Issues guide. Next steps Now that you've created your first WhatsApp session, you can: - Check Our API Docs API Documentations Frequently asked questions Can I use my business WhatsApp account with GoWAPI? Yes, you can connect both regular WhatsApp and WhatsApp Business accounts to GoWAPI. Will people know I'm using GoWAPI to send messages? No, recipients will not be able to tell that you're using GoWAPI. Messages will appear as if they were sent directly from your WhatsApp account. Can I connect multiple WhatsApp accounts to GoWAPI? Yes, depending on your subscription plan, you can connect multiple WhatsApp accounts. Each account requires a separate session. What happens if I log out of WhatsApp on my phone? Logging out of WhatsApp on your phone will not affect your GoWAPI session. However, if you log out from "Linked Devices" in WhatsApp, your WasenderApi session will be disconnected. Is it safe to connect my WhatsApp account to GoWAPI? Yes, WasenderApi uses WhatsApp's official connection method for linked devices. We do not store your messages on our servers unless you enable message logging. Your WhatsApp credentials are never shared with us.GoWAPI

Messaging

Sending messages

Introduction Welcome to GoWAPI – your reliable WhatsApp API platform. This guide will walk you through the steps to set up and start sending messages using our powerful API. It's quick, secure, and developer-friendly. Step 1: Create an Account - Go to the registration page. - Fill in your details and verify your email address. - Once verified, log in to access your dashboard. Step 2: Create Your First WhatsApp Device/Session 1. Log In to Your Dashboard: Access your account. 2. Navigate to the Devices Section: In the dashboard, go to the Devices tab. 3. Create a New Device: Click on Create New Device. 4. Scan the QR Code: A QR code will appear. Open WhatsApp on your phone, go to Settings > Linked Devices, and scan the QR code to link your WhatsApp account. 5. Session Activation: Once scanned, your session will connected, and you can copy your API key. Step 3: In the Devices panel you will find the information to use the API - - Session name: {session} - - Server Hub URL: {hub.server} - - API Key of your session: {YOUR-Api-Key} Do not use curly braces { } – Curly braces are only informative and indicate that it is a variable. For a more advanced walkthrough, check config Device Step 4: Send Your First Message API Endpoint POST https://{hub.server}/api/sendText Headers Accept: application/json Content-Type: application/json X-Api-Key: {YOUR-Api-Key} Request Body { "chatId": "212612345678", "text": "Hello from GoWAPI!", "session": "{session}" } Note: "chatId" is the recipient's number. The number you're messaging must have agreed to receive WhatsApp messages. Step 5: Track Message Delivery You can track the status of your messages through the session page or set up webhooks for real-time updates. You can send various types of messages, files, images, videos, and more. Access the complete API documentation to learn about all the features.

n8n Integration

GoWAPI + n8n: No Code Low Code WhatsApp Automation Step-By-Step Guide

GoWAPI + n8n: No Code Low Code WhatsApp Automation Step-By-Step Guide Here’s how you can start developing your WhatsApp automation with using n8n and GoWAPI in pair so you can create your own no-code or low-code WhatsApp automation: Install GoWAPI n8n node We provide GoWAPI Node, which you can install at your n8n installation. Go to your n8n => Settings => Community nodes and install: @gowaplatform/n8n-nodes-gowapi If you need help with that, check the Install community nodes First WhatsApp workflow We’ll build simple workflow - when your WhatsApp account got any message, it responds with “Hi there” message Step 1: Add GoWAPI API credentials Before starting using the node, you need to add GoWAPI API credentials. 1. Go to your n8n => Home => Credentials => Add first credential 2. Find GoWAPI API in dropdown 3. Get the GoWAPI server host URL - http://hub001.gowapi.dev 4. Please provide your GoWAPI WhatsApp session API Key 5. 6. Click Save - it’ll check the connection and save the credentials Click to open full size. If you need help with that, check the Create credentials Step 2: Create a new workflow 1. Go to n8n => Home => Workflows => Create new workflow. 2. If included automatically remove Manual trigger Step 3: Add GoWAPI Trigger Add GoWAPI Trigger node. Step 4: Add Send a text message action Add node, search GoWAPI Add Send a text message GoWAPI Action and connect it to message GoWAPI Trigger output. Step 5: Activate the workflow Click Save and Activate or Publish the workflow: Step 6: Start a new session Open the GoWAPI Trigger and expand Webhook URLs => Production URL Go to GoWAPI Dashboar (Log in to your account) In the Device section, include the Webhook: Step 7: Send a message Now you can send any message to your WhatsApp account, and it’ll respond with “Hi there” message! n8n Help: - Installation guide - Install community nodes - Create credentials If that doesn’t help - kindly open an issue in the GitHub repository gowaplatform/n8n-nodes-gowapi: n8n community nodes for GoWAPI (WhatsApp HTTP API) or NPM package @gowaplatform/n8n-nodes-gowapi - npm , we’re happy to help you out!

Devices and Sessions

Add and manage Devices

Managing WhatsApp Devices and Sessions GoWAPI allows you to connect multiple WhatsApp accounts simultaneously. Each session represents one connected WhatsApp number. Session Limits Your subscription determines how many sessions you can have. Adding a New Device and Session 1. Go to Devices in the sidebar 2. Click "Add New Device" 3. Enter a name for the device and number 4. Scan the QR code with your WhatsApp mobile app 5. Wait for connection confirmation Note: Each session requires a unique phone number. Managing Sessions Viewing Active Sessions The sessions page shows: - Session name and status - Connection timestamp - Quick action buttons Session Actions For each session you can: - Reconnect: If session gets disconnected - Delete: Remove a session permanently - View Logs: See session activity history Best Practices - Use descriptive names for devices - Regularly check session status - Delete unused sessions Troubleshooting Common issues and solutions: - Connection issues: Ensure phone has internet and WhatsApp is open - QR code not working: Try refreshing the QR code - Session disconnects: Reconnect from the sessions page

❇️ Getting Started

About the GoWAPI dashboard

Introduction to the GoWAPI dashboard The GoWAPI dashboard provides a clean, organized view of your WhatsApp messaging activity and account status. It's built with a sidebar navigation layout for easy access to all features. Dashboard Layout Sidebar Navigation The left sidebar provides quick access to all main sections: - Dashboard: Current overview page - Devices: Manage connected accounts - Subscription: manage your subscription Main Content Area The dashboard displays several key widgets: - Subscription Summary: Shows your current plan and usage - Session Stats: Status of your WhatsApp sessions - Recent Activity: Latest actions and events - Message Chart: Visualizes your messaging activity Key Dashboard Components Subscription Summary Displays: - Your current subscription plan - Number of WhatsApp sessions used vs. allowed - Trial status (if applicable) Session Stats Shows the status of all your WhatsApp sessions: - Total number of sessions - Breakdown by status (connected, disconnected, etc.) Message Activity Chart Visual representation of your messaging activity: - Total messages sent - Daily message trends - Interactive chart controls Navigation Features - Breadcrumb navigation shows your current location - Responsive design works on desktop and mobile - Clean, minimalist interface focuses on key metrics

n8n Integration

n8n Template - GoWAPI - Bot Chatting Template

Simple chatting template that replies with “pong” if received “ping” and sends an image if received “image”. How it works When receive a new message on WhatsApp session - send seen always and based on message: - Send back “pong” if message is “ping” - Send back an image if message is “image” Set up steps - Create Workflow - **Download **https://gowapi.dev/public/docs/GoWAPI-Bot-Chatting-Template.json and Copy template and Paste in n8n (Ctrl+V), or Import From file... or Import From URL https://gowapi.dev/public/docs/GoWAPI-Bot-Chatting-Template.json - Configure GoWAPI API credentials and select it for all GoWAPI nodes - Get Webhook URL (production one) from GoWAPI Trigger node - Configure your GoWAPI session to send webhooks with message type to the Webhook URL - Active / Publish your workflow in n8n - Send “image” or “ping” to the WhatsApp account from another one and see the magic!