Migasender user manual

Chapter 1

Welcome to Migasender

What it is, what it does, and the vocabulary used throughout this manual.

Migasender connects your company's WhatsApp numbers to a single dashboard. From there you can answer conversations, send campaigns to lists of contacts, let an AI assistant reply when nobody is available, and check how many messages were delivered and read.

Words that keep coming up

Chapter 2

Signing in

Getting into the dashboard, and recovering your password.

How to sign in

1. Open https://dashboard.migasender.com. It is the same address for everyone, whichever platform your account belongs to.
2. Type your email address and password.
3. Press Sign In.
4. If you have one app, it opens straight away. If you have more than one, a window appears so you can pick which one to work on.

Once an app is open, the address in the browser becomes https://dashboard.migasender.com/p/ followed by a long code: that code is your platform's registration token (see below). You can switch app at any time with Change App at the top left.

Forgotten password

1. Open https://dashboard.migasender.com and press Forgot Password?.
2. Enter the email you sign in with and press Send Reset Link.
3. Open the message you receive and follow the link.
4. Type the new password twice (at least 8 characters) and press Save New Password. You are taken back to the sign-in screen.

If the screen says password reset by email is not available on this platform, the platform has no outgoing email configured yet. Contact support and they will reset it for you.

Your platform registration token

The registration token is the long code after /p/ in your addresses. It identifies your platform and is required in every API call, which always starts with https://apidb.migasender.com/p/<registration token>/ (see the API reference). You can find it in three places:

Your platform token (Line, QR, Instances and Groups APIs)

The platform token is a separate 64-character code, different from the registration token. The Line Management, QR Code, Instances / Line Log and Groups APIs need it in the request body: as platform_token for api_qr/*, api_linelog/* and Groups, and as security_token for api_line/* and api_instances/*. All other parameters work exactly as on the legacy API; the only new part is the /p/<registration token>/ prefix in the address.

The platform token is not shown in the customer dashboard. Ask your platform administrator for it. Administrators find it in two places, and it is the same token in both:

Chapter 3

How the interface is laid out

The left menu, the top bar, the theme, and using it on a phone.

The left menu

At the bottom of the menu you will find the dashboard version and an Online indicator confirming the connection to the server.

The top bar

• Change App — switch between companies, if you manage more than one.
• Messages Left — how many messages you can still send this month.
• Language — English or Italian; your choice is remembered.
• Reset Module — returns the configuration to its initial state. Only use it if support asks you to.
• Support — the question-mark icon opens the frequently asked questions in another browser tab.
• Theme — switch between light and dark.
• Account — sign out.

Language and theme

On a phone

The side menu turns into a drawer, opened with the three-line icon at the top left.

Chapter 4

Line Management

The page that tells you at a glance whether your numbers are live.

The two cards on top

• Maximum Number of Lines — how many lines your plan allows.
• Max Messages / Month — your monthly message ceiling.

A line's card

• Name and ID — what you called the line and its identifier. CURRENT marks the line used by default.
• Number — the connected WhatsApp number.
• Edit Line — opens the configuration (chapters 5 and 6). If the line is not ready yet the button reads Configure.
• Master and Slave — the state of the two connections.
• Last checked — when the dashboard last verified the status.
• Trust Score — a health indicator for the number.
• Expiry — how long the line stays active.
• Configuration state — CONFIGURED or NOT CONFIGURED.

What the statuses mean

The actions menu

The three-dot icon at the top right of each card opens the actions available for that line.

Telemetry Logs

Telemetry lists the technical events exchanged between the line and the server over the last 2 days, split into two tabs: Master Gateway and Slave Gateway. The header repeats which line you are looking at and when the view was last updated, and the box below searches the entries.

When there are events, each one is listed with its outcome — success or error — its date and time, and the raw content the server received. An empty panel is not a fault: it simply means nothing has passed through that gateway in the window.

The toolbar

• Search lines… — filter by name or number.
• The two icons next to the search box switch between card view and table view.
• Copy, CSV, Excel — export the list of lines.
• Reload Lines — re-reads the list from the server.
• Update lines status — asks each connection for its current state.

Chapter 5

Connecting a WhatsApp number

The three-step setup.

Step 1 — the line's details

The panel is headed Create New Line, whether you are adding a number or editing one that already exists.

1. Give the line a recognisable Line Name, for example "Support" or "Sales".
2. Enter the WhatsApp Number with its international prefix, for example +39320….
3. Press Next Step.

Step 2 — connecting the phone

The panel is headed Instance Registration and holds two blocks.

• Primary Connection — required. This is what messages are sent through.
• Backup Connection (Auto-Failover) — optional. If the primary drops, sending moves here automatically and messages keep going out.

How to scan the code

1. Press Load QR Code.
2. On your phone open WhatsApp and go to Settings → Linked Devices → Link a Device.
3. Scan the code shown on screen.
4. When the status turns CONNECTED, press Send Test Message for a final confirmation.

Step 3 — the settings

The last step is headed Instance Settings and gathers four panels — General, Meta Cloud API Fallback, Migachat Integration and Line Status Notifications — described in the next two chapters. Press Save when you are done.

Chapter 6

Line settings

The General, Migachat and Notifications panels.

General

Migachat Integration

With the integration on, messages arriving on this line are handed to the AI assistant, which composes and sends the reply. Select Instance chooses which assistant to use.

Line Status Notifications

• Notification email — when on, you get an alert as soon as the line disconnects.
• GDPR Consent — authorises storing and analysing this line's conversations. Turning it off disables AI analysis of incoming messages.
• Notification Email — the list of addresses that receive the alerts. Add as many as you need with Add Email.

Chapter 7

Meta Cloud API Fallback

The safety net that keeps messages going out when the normal line is not enough.

WhatsApp limits how much an ordinary number can send before it starts to look suspicious. When you pass the threshold you set here, Migasender does not stop sending: it switches to Meta's official channel, the Cloud API, which uses approved templates.

How the daily counter works

• The threshold is counted per line, not per contact. Only the messages that go through the threshold check add one: the fallback must be active for that message (Fallback Enabled on the line, or a fallback template in the API call), and in STANDARD mode a contact who wrote in the last 7 days is skipped and not counted.
• The counter goes back to zero every day at 00:00 UTC (01:00 in Italy in winter, 02:00 in summer).
• As long as the counter is below the threshold, messages go through the line as usual. From the threshold onward, they go through the Cloud API as a template.
• The master and slave sides of a line each keep their own counter.

A different template for each message

The template set on this panel is the same for every message. A system that sends through the API (an order-ready notice, a birthday, a reminder…) can instead send, with each message, the template that fits it. If that message ends up in the fallback, Migasender uses the template from the call instead of the line's one. The parameters are listed in the API documentation, under fallback_template_name.

A message that carries its own template:

• is switched at the threshold even when Fallback Enabled is off on the line;
• is also switched when the line cannot send: the line does not exist, is not connected, or the send is refused (for example a disconnected or banned number). Without a template in the call, these cases return an error as before.

Chapter 8

Chat

Answering customer conversations from the dashboard.

Conversations on the left, the open one on the right. At the top you pick the Active Line, that is the number you reply from.

The tools in the left column

• Single / Multi — show conversations for one line only, or all of them together.
• Filter contacts and search — to find a conversation again.
• All operators — filter by whoever is handling the conversation.
• STANDARD / AI PRIORITY — changes how the list is ordered.
• Manage Tags — create coloured labels ("VIP", "Call back") and assign them to contacts.

Writing and attaching

You can send text, images, documents and voice notes. WhatsApp formatting works: *bold*, _italic_, ~strike~.

Messages sent through the API

Messages your system sends through the API (api_send/message) also appear in the conversation: those sent from a line and the Cloud API templates. So when the customer replies, you can see which message they are answering. The ticks update like on every other message.

When a line is disconnected

A disconnected line stays in the Active Line list, marked Disconnected in red. You can still open it and read its conversations, including the replies that arrive on the Cloud API during the outage.

Writing is disabled on that line until it is reconnected (chapter 5). In Multi mode, pick a connected line to reply from. When the Chat opens, it starts on the first connected line.

Chapter 9

Broadcast — sending

Sending the same message to a group of contacts.

Preparing a send

1. Target Audience — choose the Group of recipients and the WhatsApp Line to send from.
2. Message Content — write the text. The switch at the top right picks the channel: MIGASENDER (the ordinary line) or Meta Cloud API (approved templates).
3. Media Attachment — optional: image, PDF, Excel, audio or video, up to 26 MB, by URL or upload.
4. Delivery Settings — the delay between messages. Leave the defaults unless you have a specific reason.
5. Start the send and follow it in the History (chapter 12).

Chapter 10

Broadcast — Phonebook

The list of contacts you can write to.

Adding a contact

1. Press Add Contact.
2. Fill in at least the phone number, with its international prefix. Name, email and notes are optional.
3. Save.

Importing and exporting

Import CSV loads many contacts at once. The file needs the columns phone, name, email, notes. Before anything is written, the dashboard shows a preview of how many rows are valid and which are duplicates.

Export CSV downloads the phonebook, which is useful as a backup.

Chapter 11

Broadcast — Groups

Sets of contacts to use as the recipients of a campaign.

1. Press New Group and give it a name, with a description if that helps.
2. Open the group and add contacts from the phonebook; you can select them in bulk.
3. The group then appears among the recipients in the Send Broadcast tab.

Chapter 12

Broadcast — History

What happened to every campaign, contact by contact.

The contact-by-contact detail

Click a row to open it: the outcome for every single recipient appears underneath. The detail lists Phone, Name, Status, Error and Sent at. This is the right place to find out why a customer did not receive the message.

Chapter 13

Templates and WABA Config

Messages pre-approved by Meta, and the link to your WhatsApp Business account.

Why they exist

WhatsApp does not let you message a customer first with free text. You need a template: a message Meta has already read and approved. The same applies once more than 24 hours have passed since the customer's last message.

The statuses

Creating and syncing

• Create Template — compose a new message, pick its language and category (UTILITY or MARKETING) and submit it to Meta for approval.
• Sync from Meta — re-reads the list and the current statuses from Meta.
• The eye icon opens a preview of the message.

Variables

The {{1}}, {{2}} placeholders are replaced at send time. A template like Hi {{1}}, your order {{2}} has shipped. becomes a different message for every recipient.

WABA Config

The second tab holds your Meta WhatsApp Business credentials: WABA ID, the phone number identifier and the access token. Without them neither templates nor the fallback in chapter 7 will work.

Chapter 14

Roundbin

Spreading sends across several lines, in turn.

A Roundbin group pools several lines. When a message is sent to the group, the dashboard picks the next line in rotation: the load spreads out instead of falling on one number.

Creating a group

1. Press New Group and give it a name.
2. Add the lines that should belong to it.
3. Optionally set a fallback template, used when the rotation has to move to Meta's channel.

Each row in the list shows how many lines the group holds and its fallback template, if any.

Chapter 15

Logs

The record of every message in and out.

The monthly summaries

• Total Messages — how many you have used out of your plan.
• Sent Successfully — those that went through.
• Failed — those that did not.
• Sent via API — how many came from connected external systems.

The Debug Log

The table lists every message with its Log ID, Line ID, the contact's name and surname, the mobile number, a preview of the message, the sent date and time and the delivery state, shown as a percentage or as Error.

The bar above the table lets you search by number, filter by date range, switch between table and card view, reload, and export.

Chapter 16

Stats

How much arrives, how much is read, and what voice and AI cost.

Messaging

Below the cards, the Delivery Rate and Read Rate sum things up as percentages.

Voice & AI usage

The second tab covers the voice features, and is split into two halves of the same shape.

• Text To Speech (TTS) — replies the assistant turned into a voice note.
• Speech To Text (STT) — the opposite: voice notes from customers turned into text.

Each half shows the same five figures — Total Conversions, Total Characters, Avg. Chars / Day, Total Cost and Avg. Cost / Day — then a usage chart comparing the current period against the previous one, and finally a log of every individual operation: mobile number, gateway type, service, message, cost, character count, size and any error. That log can be searched, reloaded and exported.

The filters

At the top you pick the period — for example Last 30 Days — or a custom range, and which service to include. Press Filter Stats to apply. The band above the controls always states the range currently in effect.

Chapter 17

Settings

Seven panels for credentials, alerts, webhooks and API access.

OpenAI Configuration

Here you enter the AI service key, choose the model and set the voice used for speech synthesis. You can pick OpenAI or ElevenLabs as the voice engine.

General Configuration Settings

Country Code Settings

Lets you accept messages only from certain international prefixes — an effective filter against unwanted traffic.

Webhook Settings

A webhook is the address Migasender calls when something happens — a message arrives, a status changes. It is how you connect the dashboard to other systems.

Webhook Metadata Settings

API Settings

• Chat history API — lets external services read archived conversations.
• Send message API — lets external systems send messages.

Next to each switch, the two icons let you regenerate and copy the token.

Auto-Login Iframe Token

This is for when the dashboard is embedded in another site: the token passed in the address signs the user in without asking them to log in again.

Subscriptions and invoices

To view subscriptions and invoices for purchases made on MigaMATCH, open your purchases area. Enter the email address used for your purchase: you will receive a PIN by email to sign in.

Open subscriptions and invoices