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 a working 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 WhatsApp API service. ConnectiveOne receives and sends messages through Maytapi.
• Product ID and Token (API Key) — in the Maytapi console: Developers → Product ID & Token (/developers/token).
• Phone ID — the number (instance) id under Phones (the id in the list). One product can have multiple numbers.
• API Key (x-maytapi-key) in ConnectiveOne = the TOKEN field on the Product ID & Token page. Keep it secure.
• Channel status — after connecting, ConnectiveOne shows the state: connected, QR scan required, reconnecting, or unknown.

Current Connection Capabilities

After a successful WhatsApp Maytapi connection you can:

• Receive messages — text, images, video, audio, documents, location, contacts (vCard), stickers.
• Send messages — the same from Operator Line or via the bot scenario.
• Receive reactions — client emoji reactions are stored and shown in the chat.
• Monitor channel status — settings show the state and QR when needed; if the number disconnects, ConnectiveOne can show an in-app warning and a banner above the chat with a link to the QR screen.

For numbered Viber / Telegram / WhatsApp via another gateway, see Connect via e-chat.

Part 1. Registration and Data from Maytapi

Before connecting in ConnectiveOne you need Product ID, API Key (Token), and Phone ID. Console: console.maytapi.com.

1. Register with Maytapi

1. Go to Maytapi or straight to the console and sign up / log in.
2. Check pricing (a trial is available). ConnectiveOne requires WhatsApp API access via Maytapi.

2. Where to find Product ID and Token (most important)

Common confusion: credentials are not under Phones and not under Webhooks.

1. In the console left menu open Developers → Product ID & Token.
   Direct link: console.maytapi.com/developers/token.
2. On Developers / Token you will see two fields with a Copy button:
   • PRODUCT ID — in ConnectiveOne this is MayTApi Product ID;
   • TOKEN — in ConnectiveOne this is MayTApi API Key (x-maytapi-key).
3. Copy both values. Do not publish the Token or share it in chats unless required.

3. Phone ID and QR (number)

1. In the left menu open Phones.
2. Select an instance in the list on the left — the row shows id (this is the Phone ID, for example 153599). You can also pick Phone ID later in ConnectiveOne after Verify connection.
3. If the status is qr-screen / scan required — on the QR Code tab scan it in WhatsApp on that phone (Linked devices) and wait until Maytapi shows a connected status.

You should now have three values for ConnectiveOne: Product ID, Token (API Key), Phone ID.

Part 2. Connecting in ConnectiveOne

Before You Start

• You are logged into ConnectiveOne and have access to Bot Settings.
• You have Product ID, API Key, and (if needed) Phone ID from Maytapi.
• Maytapi is enabled on your instance (an administrator does this if required).

Step-by-Step

1. Open bot settings

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

You can also do this in Scenario Builder on the start node → Channels trigger.

2. Open the WhatsApp MayTApi channel

1. In the Channels block, find WhatsApp MayTApi.
2. Open the channel panel — the setup steps appear.

3. Step 1. Credentials and connection check

1. Fill in:

2. Click Verify connection (Ukrainian UI: Перевірити зв’язок).
3. On success, a confirmation appears; you can select the number next.

If verification fails, check Product ID and API Key (no extra spaces; key must be active in Maytapi).

4. Step 2. Number and bind

1. In MayTApi Phone ID, pick a number from the list (after verification) or enter Phone ID manually.
2. Click Connect (bind number) (Ukrainian UI: Підключити (прив’язати номер)).
3. On success you see a webhook confirmation (for example, “Webhook set WhatsApp Maytapi”).

5. QR code (if required)

1. If the channel state is QR scan required, a QR code appears on the page.
2. Scan it with WhatsApp on the phone for this number (Linked devices).
3. Use Refresh if you need a new QR.
4. After a successful scan, the state should become Connected, can send.

6. Step 3. Status and management

After binding you see:

Other actions:

• Check status — refresh state from Maytapi.
• Re-bind number (QR) — get a new QR to re-link the number.
• Unbind process — disconnect the channel from this bot.

If the number disconnects while you work, ConnectiveOne may show an in-app warning and a banner above an open WhatsApp chat with a link to the QR screen. While the channel is not in “can send” state, new outbound messages may fail.

After Connecting

• Incoming messages to the number appear in ConnectiveOne (scenario and operators).
• Outgoing messages from Operator Line or the scenario go through Maytapi.
• The chat shows delivery statuses (sent / delivered / read) and client reactions.
• Messages a manager types directly in the WhatsApp app or WhatsApp Web on the channel number also appear in the chat, with a phone icon next to the author's name and the tooltip "Written manually by operator via messenger". Media and reactions sent from the phone do not reach the chat.

Related Articles

• Connect WhatsApp — via 360dialog or SendPulse.
• Connect numbered channels via e-chat.
• Channels hub.