> ## Documentation Index
> Fetch the complete documentation index at: https://documents.xobito.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaigns Overview

> Broadcast WhatsApp template messages to groups of contacts — one-time, scheduled, or CSV-driven.

A **campaign** in Xobito is a bulk send of an approved WhatsApp template to a list of contacts. Campaigns are how you launch promotions, send announcements, run re-engagement flows, and deliver any message that goes to more than one person at a time.

## Campaign types

<CardGroup cols={3}>
  <Card title="One-time blast" icon="bullhorn">
    Pick a template, pick recipients, send immediately. Best for quick announcements.
  </Card>

  <Card title="Scheduled campaign" icon="calendar">
    Same as a one-time blast, but queued to go out at a specific date and time in your timezone.
  </Card>

  <Card title="CSV campaign" icon="file-csv">
    Upload a spreadsheet where every row is a recipient with their own variable values. Perfect for personalised bulk sends.
  </Card>
</CardGroup>

<Snippet file="callout-session-window.mdx" />

## Campaign lifecycle

Every campaign moves through a predictable set of statuses:

<Steps>
  <Step title="Draft">
    You've started building the campaign but haven't submitted it yet. Drafts can be edited or deleted freely.
  </Step>

  <Step title="Scheduled">
    The campaign has been submitted with a future send time. It's waiting in the queue. You can still pause or cancel it from the campaign details page.
  </Step>

  <Step title="Sending">
    Xobito is actively dispatching messages to WhatsApp. Progress updates in near real-time on the details page.
  </Step>

  <Step title="Completed">
    Every recipient has been processed. Open the campaign to see delivered, read, and failed counts.
  </Step>
</Steps>

## What's in the Campaigns section

<CardGroup cols={2}>
  <Card title="Create a campaign" icon="plus" href="/campaigns/create-campaign">
    Pick a template, choose recipients, preview, and send.
  </Card>

  <Card title="CSV campaign" icon="file-import" href="/campaigns/csv-campaign">
    Upload a CSV with recipients and per-row variable values.
  </Card>

  <Card title="Schedule a campaign" icon="clock" href="/campaigns/schedule-campaign">
    Queue a send for a specific date and time, and pause or cancel later.
  </Card>

  <Card title="Track performance" icon="chart-line" href="/campaigns/track-performance">
    Monitor delivery, read rates, opt-outs, and export results.
  </Card>
</CardGroup>

## Campaign limits

Your send capacity depends on two things:

1. **Your Xobito plan** — each plan includes a monthly campaign quota. Check your current plan on [Billing & Subscription](/settings/billing-subscription).
2. **Meta's messaging tier** — your WhatsApp phone number has a tier set by Meta (250, 1K, 10K, 100K, or Unlimited per 24 hours). Exceeding this tier will pause delivery until the window resets. See [Phone numbers — Messaging tier](/whatsapp/phone-numbers#messaging-tier) for how to climb tiers.

<Note>
  Xobito automatically paces sends to stay within Meta's per-second rate limit, so you never need to configure throttling yourself.
</Note>

## Best practices

<AccordionGroup>
  <Accordion title="Only send to opted-in contacts" icon="shield-check">
    WhatsApp requires explicit opt-in before you can message a contact commercially. Keep evidence of consent (form submissions, checkout opt-ins, etc.) in case Meta requests it.
  </Accordion>

  <Accordion title="Warm up new numbers" icon="fire">
    If your WhatsApp number is new or recently scaled, start with small campaigns (100–500 contacts) and grow week by week. Sudden large volumes can trigger Meta's quality checks.
  </Accordion>

  <Accordion title="Segment by intent" icon="users-rectangle">
    Instead of blasting your entire list, send to groups filtered by status or source. Smaller, more relevant sends keep your quality rating green.
  </Accordion>

  <Accordion title="Handle opt-outs manually" icon="ban">
    WhatsApp lets recipients block your number directly. Xobito does **not** currently auto-flag opted-out contacts — when a customer asks to stop, an agent must manually disable that contact so they're skipped from future sends. Automatic opt-out handling is on the roadmap.
  </Accordion>

  <Accordion title="Test before you send" icon="flask">
    Use the preview to check variable substitution, and send a test to your own number before launching a large campaign.
  </Accordion>
</AccordionGroup>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Why do I have to use a template?">
    Meta only allows free-form messages during the 24-hour session window after a contact messages you. Campaigns typically target contacts who haven't messaged you recently, so a template is required.
  </Accordion>

  <Accordion title="How much does a campaign cost?">
    You pay Meta per **conversation** (24-hour window with a contact), not per message. The exact rate depends on the template category (marketing, utility) and the recipient country. See [Key Concepts](/key-concepts#conversation-billable-unit).
  </Accordion>

  <Accordion title="Can I edit a campaign after scheduling it?">
    You can pause and cancel a scheduled campaign, but you cannot edit recipients or content once it's queued. Cancel the scheduled campaign and create a new one instead.
  </Accordion>

  <Accordion title="What happens to failed messages?">
    Failed messages are logged on the campaign details page with the reason from Meta. Common causes: invalid phone number, contact opted out, or quality rating too low.
  </Accordion>
</AccordionGroup>