How to use WApp

WApp lets you send paced, consent-respecting WhatsApp messages and campaigns through your own connected number.

1. Sign up at /signup with your email and a password.
2. Verify your email with the one-time code we send you.
3. Wait for an administrator to approve your account — you will be able to log in once approved.
4. On your first login you will be asked to set a new password.

A "channel" is one WhatsApp number you have paired. You can connect more than one.

1. Open Channels and choose Add channel.
2. Click Connect to show a QR code, then in WhatsApp on your phone go to Settings > Linked devices > Link a device and scan it.
3. When the status turns Connected, the number is ready to send.
4. Set pacing — minimum/maximum gap between messages, quiet hours, and a daily cap — to keep sending human-paced.

Each channel has one bearer token for the public API.

1. On the API page, pick a channel and choose Rotate token.
2. Copy the token immediately — it is shown only once and stored hashed, so it cannot be retrieved later.
3. Send it as an Authorization: Bearer <token> header from your server.
4. Rotating a token replaces the previous one; update your integration when you rotate.

You can send from your server with the public API, or test instantly in the in-portal playground (no token needed there — it uses your session).

1. POST /api/v1/messages with { to, text } (and an optional attachment up to 5 MB) to queue a message.
2. GET /api/v1/messages and GET /api/v1/messages/:id to list and check status.
3. On the API page, use Try it to send a real test from the selected channel using your login session.
4. Messages are queued, then paced out — see the next steps for what the statuses mean.

Contacts hold the people you message and their consent state. Only contacts who have opted in and are not suppressed are messageable.

1. Add a contact manually, or import many at once from CSV or JSON (download the template on the import page).
2. When you add a contact, the consent checkbox records that you have permission to message them — opted-in contacts are messageable; without it the contact is stored as unknown and is not messageable.
3. The suppression list holds numbers that must never be messaged (e.g. people who opted out); suppressed contacts are skipped automatically.

Groups and segments are two ways to target an audience.

1. A group is a static list — you add specific contacts to it.
2. A segment is a saved filter — it is evaluated live each time you use it, so it always reflects current contacts.
3. Both show a total count and a messageable count (how many can actually be sent to right now).

A campaign sends one message to an audience, paced through your connected channel(s).

1. Pick your audience from groups, segments, and individual contacts — duplicates are removed automatically.
2. Write your message; use merge fields like {{name|there}} to personalize, with a fallback after the | for missing values.
3. Choose one or more channels to send through, then schedule the campaign.
4. At schedule time the recipient list is frozen into a snapshot; the executor then sends paced, re-checking consent at the moment each message is enqueued.
5. You can pause, resume, or cancel a campaign while it runs.

Reports show what happened to your messages.

1. See the delivery funnel — sent, delivered, read, and failed counts — overall and per campaign.
2. Failed messages show the reason; you can retry a failed message and it will be re-queued without duplicating.
3. Export a report to CSV for your records.

The platform listens for replies so you can stay compliant without manual work.

1. Incoming messages appear in the Inbox, where you can filter and mark them handled.
2. If someone replies STOP, they are opted out and suppressed automatically, and get one confirmation reply.
3. If they reply START, they are re-subscribed.
4. You can customize the STOP/START confirmation text on your Account page.

Keep your account secure.

1. Update your profile and change your password on the Account page.
2. Forgot your password? Use Forgot password to get a one-time reset code by email.