WhatsApp welcome message for new contacts, with a coupon template
A WhatsApp welcome message greets a customer the first time they write. The WhatsApp Business app's greeting message does this from the phone, and again after 14 days of silence. On a number connected to Meta's Cloud API, an automation can answer a first message with fixed text that uses the customer's first name, or with an approved template that carries a coupon code.
easyCoexistence runs the welcome on the WhatsApp Business number you keep in the app: fixed text with {{first_name}}, or your approved coupon template, built by asking ChatGPT or Claude through the connector or from the Welcome message example in the editor.
Silence after which a contact's next message counts as a first message again for easyCoexistence automations.
Inactivity after which the WhatsApp Business app's own greeting message goes out again to the same customer.
Positional body variables, the kind an automation fills; templates with named variables cannot be used yet.
How long Meta's review of a new template can take before it is approved and can be sent.
Longest code a Meta coupon code template takes, set in its copy code button when the message is sent.
Meta's category for promotional templates such as a coupon, billed per delivered message to the business's own account.
When does a welcome message go out?
On the customer's first message, as the automation sees it. The First message trigger ("The first time someone writes to you.") runs on the first message a contact sends after automations start receiving the number's messages, and again when a contact writes after 30 days without a message from them. Four details decide who gets it:
- Chats from before automations were on do not count, so a long-time customer gets the welcome the first time they write afterwards.
- While automations are on, if you message someone first from the WhatsApp Business app, their reply is not a first message.
- A first message that matches a keyword automation gets the keyword reply instead, because keyword rules rank first, and the welcome does not follow on later messages.
- A regular customer who writes again after 30 quiet days gets the welcome again, coupon included, so word it to suit returning customers, or check your own records through Call my webhook.
What should a welcome message say?
Who you are, what the customer can do next, and when a person answers. A first message is often already a question, so a welcome that only says hello makes the customer wait twice; put the useful link or your hours in the same text. Ready to copy, with your details in brackets:
- Simple: "Hi {{
first_name}}! Thanks for writing to [business]. How can we help you today?" - With the next step: "Welcome, {{
first_name}}! Our menu is at [link], and we deliver until [10 p.m.]. Tell us what you'd like." - With hours and a person: "Hi {{
first_name}}, welcome to [business]! We answer here from [9 a.m. to 6 p.m.], Monday to Friday, and a person from our team will reply shortly." - With the coupon as text: "Hi {{
first_name}}, welcome! Your first order has 10% off with the code BEMVINDO10. Reply here with any question."
How do you send a welcome coupon with a template?
Create a marketing template with the code in its body, wait for Meta to approve it, then point a First message automation at it. It is the classic welcome coupon: a new customer, Ana, writes for the first time and receives BEMVINDO10 for 10% off.
Ask your AI, with the easyCoexistence connector, to create the template, or create it in Meta's WhatsApp Manager: create_template submits it to Meta with example values for each variable, the review can take up to 24 hours, and get_template_status reports APPROVED, PENDING or REJECTED. Marketing templates need a payment method on the WhatsApp Business Account. Then build the automation, in the same chat or in the editor: a Send a template step on welcome_coupon, with Variable {{1}} filled by + First name and Variable {{2}} set to BEMVINDO10. The editor's Preview shows the message with a sample customer's name.
Run test does not call Meta for a Send a template step, so it passes even while the template is PENDING, or typed by name with parts automations cannot fill; confirm get_template_status says APPROVED, and that the editor's list offers it, before you switch the automation on.
create_template {
"connection_id": "…from list_numbers…",
"name": "welcome_coupon",
"language": "en_US",
"category": "MARKETING",
"components": [{
"type": "BODY",
"text": "Hi {{1}}! Welcome to Ana's Bakery. Use the code {{2}} for 10% off your first order.",
"example": { "body_text": [["Ana", "BEMVINDO10"]] }
}]
}
create_automation {
"connection_id": "…from list_numbers…",
"name": "Welcome coupon",
"trigger": { "type": "message_received", "match": "first_message" },
"steps": [{
"type": "send_template",
"name": "welcome_coupon",
"language": "en_US",
"params": ["{{first_name}}", "BEMVINDO10"]
}]
}Which templates can an automation send?
Approved templates of the number's WhatsApp Business Account whose variables are all in the body and numbered, such as {{1}} and {{2}}. Each variable can hold fixed text or the customer's details, inserted with + First name, + Full name, + Their message or + Their phone. The editor lists every template on the number, and greys out the ones it cannot fill yet, with the reason:
- Named variables, such as {{
customer_name}}: "Uses named variables, which automations cannot fill yet." - A header picture, video or document, or a header variable: "Needs a header picture or variable, which automations cannot send yet."
- A button that takes a value at send time, such as a link with a variable or Meta's copy code button for coupons: "Has a button with a variable, which automations cannot fill yet."
- Quick reply buttons, website buttons with a fixed link, a text header and a footer all work.
Should you keep the app's greeting message?
Keep one greeting, not two. The WhatsApp Business app's greeting message, in the Tools tab under Greeting message, keeps working after Coexistence: Meta lists the app's messaging tools as unchanged by onboarding and not supported on the Cloud API, so an automation cannot read its settings or switch it off. WhatsApp sends it on a customer's first message or after 14 days of inactivity, from the phone, while it has an internet connection. With a First message automation also on, a new customer receives both texts. Keep the automation for the first name, the coupon template and replies with the phone off; keep the app's greeting if you rely on its recipient filters, such as Everyone not in address book.
How to set it up
- Start from Welcome messageIn the Automations tab, click New automation, then Use this on Welcome message: the trigger is First message and the step is Reply with text.
- Personalize the textEdit the Message box and keep {{first_name}} where the customer's first name belongs.
- Or send the coupon templateClick + to add Send a template, pick the approved template, fill each Variable, using + First name for the name, then delete the text step.
- Test it switched offSwitch it Off, click Save, open Test and click Run test; a test sends nothing to anyone, templates included.
- Turn it on, and the app's greeting offSwitch it On and click Save. On the phone, open the Tools tab, tap Greeting message and turn off Send greeting message.
Common mistakes
- Sending templates through the API, from your AI or your system, to people silent for 30 days while a Welcome message is on. Their replies count as first messages, so they get the welcome too.
- Leaving a template variable empty. The editor warns "Fill this in, or Meta refuses the send.", and a refused send fails the run; easyCoexistence emails you, at most once per automation every 6 hours, so you can answer that customer yourself.
- Testing twice from the same phone. A contact's first message counts once in 30 days, so the second test message gets nothing; use Run test, which runs the steps without checking the trigger, or another phone.
- Submitting a coupon template as UTILITY. Coupons are marketing under Meta's category rules, and Meta moves a utility template that should be marketing to MARKETING, so submit it as MARKETING from the start.
Templates go out through Meta's Cloud API, and Meta bills them to your own WhatsApp Business Account with no markup from us. US$ 9 down to US$ 0.75 per number per month, falling as you add numbers, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Do I need a template to welcome a new customer?
No. The customer's first message opens Meta's 24-hour customer service window, so a fixed text reply goes out without a template. A template adds an approved layout with buttons and the same wording on every number that uses it, and Meta bills each template message by category and market.
Can each new customer get a unique coupon code?
Yes, through your own system. Add a Call my webhook step: easyCoexistence posts the message, signed, to your URL, and if your system answers {"reply": "Your code is ANA-7Q2K"} within 20 seconds, that text goes to the customer.
Can the welcome match the customer's language?
A fixed text or a template has one language per automation. A Reply with AI step answers in the customer's language, because its built-in instructions ask for it, so an AI welcome can greet a Spanish speaker in Spanish and a Brazilian customer in Portuguese.
Will the welcome go out if a new customer writes at night?
Yes. First message ranks above After hours, so a first-time customer who writes while you are closed gets the welcome, not the away text. Add your opening hours to the welcome so they know when a person will answer.
Keep reading
Ready to get started?
Set up WhatsApp Coexistence in minutes, not months. The app keeps working on the phone.
Start Free TrialVerified on