How to Connect WhatsApp via Maytapi

This guide helps you connect a WhatsApp number to ConnectiveOne through Maytapi: from signing up in the Maytapi dashboard to connecting the channel in Bot Settings. Once set up, you can receive and send messages, see delivery statuses, and view client reactions.

When You Need It

  • You want to connect a WhatsApp number (not a bot) to exchange messages with clients.
  • You have chosen Maytapi as your WhatsApp API provider.
  • You need step-by-step instructions from Maytapi registration to a working channel in ConnectiveOne.

What You Should Know

  • Maytapi — a third-party service that provides an API for WhatsApp. ConnectiveOne receives and sends messages through Maytapi.
  • Product ID — the identifier of your product in the Maytapi dashboard.
  • Phone ID — the identifier of a specific WhatsApp number (instance) in Maytapi. One product can have multiple numbers.
  • API Key (x-maytapi-key) — the secret key for Maytapi API access. Keep it secure and do not share it.
  • Channel status — after connecting, ConnectiveOne shows the channel state: connected, QR scan required, or temporary connection issues.

Current Connection Capabilities

After successfully connecting the WhatsApp Maytapi channel, you can:

  • Receive messages — text, images, video, audio, documents, location, contacts (vCard), stickers.
  • Send messages — the same from the Operator Panel or via the bot scenario.
  • Receive reactions — if a client adds an emoji reaction to a message, it is stored and shown in the chat.
  • Monitor channel status — the system shows whether the channel is connected or if you need to scan the QR code again. If the connection is unstable, you can go to settings and refresh the QR.

For other options (e.g. a different provider or number-based messaging via e-chat), see Connect number-based messaging via e-chat.

Part 1. Registration and Getting Data from Maytapi

Before connecting the channel in ConnectiveOne, you need a Maytapi account and three values: Product ID, API Key, and Phone ID.

1. Register with Maytapi

  1. Go to Maytapi and sign up or log in.
  2. Check pricing and terms. ConnectiveOne requires access to WhatsApp API via Maytapi.

2. Create a Product and Number (Instance)

  1. In the Maytapi dashboard, create a product if you do not have one yet. This is the container for one or more WhatsApp numbers.
  2. Add a number (phone instance) to the product. Maytapi will let you link the number via QR code or another method according to their interface.
  3. Copy or note the Product ID — it is shown in the product info (e.g. in the product section or in the URL).

3. Get API Key and Phone ID

  1. In the Maytapi dashboard, open the API or key settings section.
  2. Create or copy the API Key (in Maytapi docs it may be called x-maytapi-key). This is a secret key — do not publish or share it.
  3. Open the list of numbers (phones) in your product and copy the Phone ID for the number you want to connect to ConnectiveOne.

You should now have: Product ID, API Key, Phone ID. You will enter these in ConnectiveOne in the next part.

Part 2. Connecting the Channel in ConnectiveOne

Before You Start

  • You are logged into ConnectiveOne and have access to Bot Settings.
  • You have Product ID, API Key, and Phone ID from the Maytapi dashboard.
  • ConnectiveOne is configured for Maytapi (your administrator does this if required).

Step-by-Step

1. Open bot settings

  1. In the main menu choose Settings → Bots.
  2. Select the bot you want to connect WhatsApp Maytapi to.

2. Enable the WhatsApp Maytapi channel

  1. In the Channels block, find WhatsApp Maytapi (or WhatsApp MayTApi).
  2. Enable this channel for the bot — fields for entering data should appear.

3. Enter Maytapi data

Fill in the three fields with data from the Maytapi dashboard:

Field in ConnectiveOneWhat to enter
Maytapi Product IDYour product identifier from Maytapi.
Maytapi API Key (x-maytapi-key)Your API secret key from Maytapi.
Maytapi Phone IDThe number (instance) identifier. If a dropdown of numbers appears after entering Product ID and API Key, you can select the number from the list.

If a list of numbers appears after entering Product ID and API Key, choose the Phone ID you need from that list.

4. Connect the channel

  1. Click Connect.
  2. The system will register the connection with Maytapi and save the settings. On success you will see a message like “Webhook set WhatsApp Maytapi” or similar.
  3. If you see an error, check Product ID, Phone ID, and API Key. Ensure the key has no extra spaces and that the number is active in Maytapi.

5. Channel status and QR code (if needed)

  1. After connecting, a channel status block appears. The status may be: Connected, QR scan required, Unstable connection, or Unknown.
  2. If the status is QR scan required:
    • A QR code appears on the page. Scan it with WhatsApp on the phone linked to this number in Maytapi (as a linked device).
    • The QR code refreshes automatically until the channel becomes Connected.
  3. After a successful scan, the status should change to Connected. You can then receive and send messages.

If the connection is lost later (e.g. after logging out of WhatsApp on the phone), the chat may show a message that you need to scan the QR again. Go to Bot Settings → WhatsApp Maytapi channel and scan the new QR code.

6. Disconnect the channel (optional)

  1. In the WhatsApp Maytapi channel settings, click Disconnect.
  2. The system will remove the Maytapi connection for this bot. Outgoing messages will no longer be sent via Maytapi for this bot.

After Connecting

  • Incoming messages to the connected WhatsApp number will appear in ConnectiveOne and be handled by the bot scenario and operators.
  • Outgoing messages from the Operator Panel or scenario will be delivered to clients via Maytapi.
  • The chat shows delivery statuses (sent, delivered, read) and client reactions to messages.