Ad welcome messages

When someone taps a Click-to-WhatsApp ad on Facebook or Instagram, WhatsApp opens a chat with your business. A welcome message makes that first moment useful instead of an empty chat:

a greeting (text)
a message already typed in their box, ready to send (prefill)
a few quick questions they can tap (quick_replies)

You create welcome messages in LazyApp, then pick one when you build the ad.

Create one

curl -X POST https://lazyapp.in/v1/connections/{connection}/welcome-messages \
  -H "Authorization: Bearer $LAZYAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Driver sign-up",
    "text": "Hi! Thanks for your interest in driving with Acme. What would you like to know?",
    "prefill": "Hello! I want to sign up as a driver.",
    "quick_replies": ["How much can I earn?", "What documents do I need?"]
  }'

{ "sequence_id": "186473890" }

Field	Required	Notes
`name`	Yes	Only you see it, when picking it for an ad. Up to 128 characters
`text`	Yes	The greeting. Up to 1024 characters
`prefill`	No	Text placed in their message box
`quick_replies`	No	Up to 5 questions, 80 characters each

Welcome messages belong to the WhatsApp Business Account of the number you name, and need the templates:write scope to change.

Use it in an ad

Ads Manager: in the ad’s Message template section, choose Partner app, pick your app, then pick the welcome message under Message sequence.
Marketing API: set the id in the ad creative:

{
  "asset_feed_spec": {
    "additional_data": { "partner_app_welcome_message_flow_id": "186473890" }
  }
}

List, change and delete

GET /v1/connections/{connection}/welcome-messages lists them, with in_use: true for ones a running ad uses.
PUT /v1/connections/{connection}/welcome-messages/{sequence_id} changes one (same fields).
DELETE /v1/connections/{connection}/welcome-messages/{sequence_id} deletes one (204).

A welcome message used by a running ad cannot be changed or deleted; remove it from the ad first. LazyApp explains Meta’s 4027xxx errors in plain words.

Know which ad they came from

The first message from someone who tapped an ad carries the ad in data.message.content.referral on message.received:

{
  "referral": {
    "source_url": "https://fb.me/…",
    "source_id": "120208…",
    "source_type": "ad",
    "headline": "Earn on your own schedule",
    "body": "Sign up in 5 minutes",
    "media_type": "image",
    "image_url": "https://…",
    "ctwa_clid": "ARAkL…"
  }
}

Use source_id (the ad id) and ctwa_clid (the click id) to attribute leads and report conversions back to Meta. The inbox shows “From your ad: …” on that message.

In the console

WhatsApp numbers → Settings → Messaging → Welcome message for your ads: create, edit, delete and copy the id of each welcome message.

Getting started

Core concepts

WhatsApp

Security

Billing

Sending

Receiving

Platforms

Migrating

Reference

Ad welcome messages

Create one

Use it in an ad

List, change and delete

Know which ad they came from

In the console

​Create one

​Use it in an ad

​List, change and delete

​Know which ad they came from

​In the console

Create one

Use it in an ad

List, change and delete

Know which ad they came from

In the console