Campaigns

Contacts and Campaigns

Import opted-in contacts from CSV, segment them with tags, and send compliant approved-template WhatsApp campaigns.

Updated May 19, 2026

Use https://wapp.chat/whatsapp/contacts to manage contacts and send approved-template campaigns.

Campaign sending is designed for compliance:

  • contacts must be opted in
  • outbound campaign messages use approved Meta templates
  • opted-out contacts are skipped
  • delivery status is tracked after sending

CSV Import #

Minimum CSV:

phone,name,tags
+15551234567,John Doe,customer
+15557654321,Jane Doe,lead

phone is required. name and tags are optional.

Only import contacts who already gave permission to receive WhatsApp messages from your business. Read Templates and Consent.

Campaign Targeting #

Campaigns can target:

  • all opted-in contacts
  • contacts with a selected tag
  • selected contact IDs through API usage

If the UI says No opted-in contacts found for this campaign, check:

  • contacts were imported
  • phone numbers are valid
  • the selected tag exists on at least one contact
  • contacts are not opted out

Create Campaign API #

POST https://wapp.chat/api/whatsapp/campaigns
Content-Type: application/json

Example:

{
  "name": "June reminder",
  "template_id": "template_uuid",
  "target": {
    "type": "tag",
    "tag": "customer"
  },
  "body_params": [
    "{{contact.name}}",
    "June offer"
  ]
}

The template must already be synced and approved.

Contact Variables #

Template body parameters can include contact variables:

{{contact.name}}
{{contact.phone}}

Metadata variables may also be supported depending on the contact data stored for that tenant.