Quickstart

This walkthrough takes you from a cold Voxa signup to a working WhatsApp competition: you’ll create an account, connect WhatsApp, build a three-step flow, and capture your first entry.

Note

You’ll need a verified Meta Business Manager account with access to WhatsApp Business Cloud API. If you don’t have one, start that process first — Meta verification can take anywhere from an hour to several days.

Before you start

• A phone number you can receive SMS on (for Meta’s phone-number verification).
• Your Meta app_id, app_secret, phone_number_id, waba_id, and a long-lived access_token. See Connecting channels if you haven’t generated these yet.
• A valid credit card or Paystack-supported payment method (you won’t be charged during the 14-day trial, but the method is required at signup if you pick a paid plan).

Step-by-step

1. Create your workspace. Head to voxa.software/signup. Enter your name, work email, password, and the name of your tenant workspace. Every new workspace starts on a 14-day trial with full access to every paid-plan feature.

   On first login you’ll be asked to set your own password — this replaces any auto-generated password and is standard whether you self-signed-up or were invited to an existing workspace.

2. Connect WhatsApp. In the workspace, open Settings → Meta credentials. Paste the five values from Meta (app_id, app_secret, phone_number_id, waba_id, access_token). Voxa encrypts all five at rest with AES-256-GCM before storing them.

   Copy the webhook URL that Voxa generates (https://voxa.software/webhooks/whatsapp/<token>) and paste it into your Meta app’s Webhooks panel. Click Verify in Voxa — the dashboard shows a green check once Meta has handshaken the endpoint.

3. Create a flow. Go to Flows → New flow. Name it “Quickstart entry” and open the visual builder.

   Drag these three nodes onto the canvas and connect them in order:

   Node	What to configure
   Message	Set the body to Hi! Welcome to the Voxa quickstart.
   Question	Prompt: What's your full name? Store answer in variable full_name.
   Submission	Title: Quickstart entry.

   Click Publish. Voxa snapshots this as flow version 1 and creates a fresh draft version 2 for future edits.

4. Create a campaign. Go to Campaigns → New campaign. Name it “Quickstart”, pick the flow you just published, and set:

   • Entry mode: link
   • Requires opt-in: false (for this test)
   • Entry limit per contact: 1

   Save, then flip the campaign status to Live. Voxa generates a wa.me deep link and a QR code for the campaign.

5. Send a test message. Open the generated wa.me link on your own phone. WhatsApp opens with a prefilled message — send it. You should see Voxa’s welcome message in a couple of seconds.

   Reply with your name. Voxa stores the answer, runs through the submission node, and writes a new entry to the campaign.

6. See the entry. Back in the dashboard, go to Entries. Your submission appears with your WhatsApp profile name, the full_name you entered, and a timestamp.

   Open Analytics → pick the Quickstart campaign → you’ll see unique_contacts: 1, started_count: 1, completed_count: 1.

Where to go next

• Build a more realistic flow with validation and branching — Building your first flow.
• Understand the pieces — Core concepts.
• Prepare for launch — Production checklist.