Hub › Lessons › Client onboarding, lesson 1
Write a client welcome message from your own facts with AI
The first message after a client says yes answers the questions they are about to ask: what happens next, what they need to send you and when to pay. This lesson gives you a tested prompt that writes that message from facts you have already confirmed. Where a fact is missing, it writes [ASK] instead of guessing a date or a price for you.
What you will be able to do: turn a short list of your confirmed dates, prices and terms into a WhatsApp or email welcome message you can check in five minutes and send.
Step 1: Write down your facts (10 minutes)
Do this once per type of client, then reuse it. Write what you have actually agreed, not what usually happens.
- What they bought, as agreed. Use the words from your quote or invoice, including limits such as "2 rounds of changes".
- What happens next, with confirmed dates. Only dates that are in your calendar. If a date depends on the client, say so, as in "if your changes come back within 3 working days".
- What you need from them, and by when. Files, answers, access or a decision.
- Payment terms, copied exactly. Amount, method and when each part is due.
- How to reach you, and when you reply. Your channel and working hours.
- Anything you always tell new clients. Extra charges, change rules or cancellation terms.
- Leave a line empty if you have not decided it. The prompt will mark it [ASK], which is better than a guess you have to take back later.
Step 2: The prompt
Fill in the lines at the top, then paste the whole prompt into your AI tool. Use the client's first name only; nothing else about them is needed.
Write a welcome message for a new client. Use only the facts I give you. How I will send it (email or WhatsApp): Client's first name: What they bought, as agreed: What happens next, with the dates I have confirmed: What I need from them, and by when: How and when to pay (my terms, copied exactly): How to reach me, and when I reply: Anything else I always tell new clients: Do this: 1. Start by thanking them by first name in one short sentence. 2. Then, in this order: what happens next with the dates, what I need from them and by when, how and when to pay, how to reach me. 3. WhatsApp: under 150 words, short lines, no subject line. Email: a subject line, then under 200 words. Do not put a label or word count above the message. 4. Copy every date, time, price and deadline exactly as I wrote it. Do not work out new dates (such as turning "within 3 working days" into a date), do not add times, and do not round. 5. If something the client needs to know is missing, write [ASK: what is missing] in the message instead of guessing. Always check for: when work starts, what they need to send me, when payment is due, and how to contact me. 6. Include every price, fee and cancellation or change term I gave. If the message is too long, shorten other lines instead of leaving one out. 7. End with one easy question or next step for the client. After the message, add: - Facts used: each date, time, price and deadline in the message, with the words from my facts it came from. - [ASK] list: each gap, and why the client needs it. - Left out: any fact I gave that is not in the message, and why. Rules: - Never make up a date, time, price, deadline, deliverable, policy or promise. - No praise of my own work (such as "amazing" or "the best") and no promises about results. - Do not ask the client for an NRIC number, bank or card details, passwords or any other personal details I did not list. - If I did not say what they bought, ask me for it and stop.
Step 3: Check it before you send (5 minutes)
- Fill in or remove every [ASK]. Never send a message with [ASK] still in it. Either add the fact or, if the client really does not need it, delete the line.
- Check each date against your calendar. Use the "Facts used" list under the message. Every date and price should point back to a line you wrote.
- Read "Left out". If a price or term you care about is listed there, put it back.
- Read it as the client. After reading it, would they know what to do this week, and what it costs? If not, add the missing fact to your list and run the prompt again.
- Do not ask for more than you need. Leave out NRIC numbers, card details and passwords unless you truly need them. The Personal Data Protection Commission has advisory guidelines on NRIC numbers; read them before you ask a client for one.
- Send it to yourself first. Check how the line breaks look in WhatsApp or your email app.
Worked example
A made-up freelance brand designer in Singapore has a new client who has agreed to a logo and colour guide. The business, client, dates and prices are illustrative.
Input (illustrative)
Write a welcome message for a new client. Use only the facts I give you. How I will send it (email or WhatsApp): WhatsApp Client's first name: Hui Min What they bought, as agreed: Logo and brand colour guide, with 2 rounds of changes What happens next, with the dates I have confirmed: Kick-off call on Tue 10 Nov, 10am on Zoom. First logo ideas by Fri 20 Nov. Final files by Fri 4 Dec, if your changes come back within 3 working days. What I need from them, and by when: Fill in the brand questionnaire (I will send the link) by Mon 9 Nov. Send your current logo files and 3 brands you like before the call. How and when to pay (my terms, copied exactly): 50% deposit (S$600) by PayNow before the kick-off call. Balance S$600 when the final files are ready, before I send them. How to reach me, and when I reply: WhatsApp this number, Mon to Fri 9am to 6pm. I reply within 1 working day. Anything else I always tell new clients: Extra rounds of changes beyond the 2 included are S$80 per round.
Output (as returned)
The message is shown word for word from our first test of the final prompt with Claude. WhatsApp shows the words between asterisks in bold. The notes after it are summarised.
Thank you, Hui Min! You've got a logo and brand colour guide, with 2 rounds of changes. *What happens next* • Kick-off call: Tue 10 Nov, 10am on Zoom • First logo ideas: by Fri 20 Nov • Final files: by Fri 4 Dec, if your changes come back within 3 working days *What I need from you* • Brand questionnaire (I will send the link) by Mon 9 Nov • Your current logo files and 3 brands you like, before the call *Payment* • 50% deposit (S$600) by PayNow before the kick-off call • Balance S$600 when the final files are ready, before I send them • Extra rounds of changes beyond the 2 included are S$80 per round *Reach me* WhatsApp this number, Mon to Fri 9am to 6pm. I reply within 1 working day. Can you confirm you're free for the kick-off call on Tue 10 Nov, 10am?
Facts used: nine items, each with the line from the designer's facts it came from, from "Tue 10 Nov, 10am on Zoom" to "S$80 per round".
[ASK] list: none in this run.
Left out: nothing. It also noted that the facts had no cancellation or refund terms, and no date for sending the questionnaire link, so the client may ask when it is coming.
When facts are missing
We also tested a made-up home organiser who left the payment and contact lines empty. The email kept the session date, the 4 hours and the cancellation rule exactly as written, and put these in the places a guess would have gone:
"Payment: [ASK: how and when to pay, including the amount and the due date]"
"Contact: [ASK: how to reach me, and when I reply]"
What the test showed
- No new dates, times or prices. In all 13 test runs with facts, every date, time and price in the message came from the facts. The only other numbers were word counts that three first-version runs wrote next to the message, which version 2 now forbids. No run turned "within 3 working days" into a date or added a time.
- Gaps were marked, not filled. In all six home organiser runs, the message asked for the payment terms and contact details instead of inventing them.
- It also spotted gaps we had not planned. In 6 of 7 designer runs it asked for the Zoom link, and in 5 it asked for the PayNow details, because our facts said "on Zoom" and "by PayNow" without saying where. Both are fair questions for a real client.
- No praise or promises. No run called the work amazing or promised a result, and none asked the client for personal details.
What we changed after testing
The prompt above is the second version. Version 1 asked for WhatsApp messages under 120 words. With this many facts, all three designer runs went over, and one dropped the S$80 extra-rounds fee to save words, which is the kind of term a client should hear before work starts. Version 2 allows up to 150 words, says every price, fee and change term must stay in, and asks for no word count above the message. All four version 2 designer runs kept every price and term. Their length was 143 to 151 words, so one run was a word over the limit; trim a line yourself if that happens.
Watch out for
- The AI only knows what you wrote. If your facts are out of date, the message will be too. Update your fact list when your terms change.
- [ASK] is a to-do, not decoration. Each one is a question your client would otherwise send you.
- Keep client details out of the prompt. A first name is enough. Do not paste addresses, phone numbers or ID numbers into an AI tool.
- Payment terms are yours to set. The prompt copies them; it does not check whether they are sensible. See the invoice and reminder lesson for following up on payment.
Next step
Keep your offer and welcome message in step
The facts you wrote in step 1 are the same ones your one-page offer and FAQ should use. If they disagree, a client will notice.
Go to the one-page offer lessonNext: intake questions that ask only what you need
Lesson 2 shows you how to write client intake questions that collect what you need to start, and nothing more.
Go to lesson 2How we checked this lesson
- On 7 Nov 2026 (about 1 to 2 pm Singapore time) we ran the prompt with Claude Code 2.1.319 in print mode on three illustrative inputs: the designer's WhatsApp facts, a home organiser's email facts with the payment and contact lines empty, and a request with no details of what was bought. We ran version 1 eight times and version 2 nine times. The message above is from the first designer run of version 2.
- A separate script checked every output: that every number in the message appears in the facts, that no new date appears, the word limit, a subject line for email and none for WhatsApp, the thank-you with the client's first name, every price and term kept, [ASK] for the missing payment and contact lines, no praise words and no request for an NRIC number, card or bank details or passwords. With nothing about what was bought, every run asked for it and stopped. We also read every output.
- The Personal Data Protection Commission page on NRIC numbers linked above was checked on 7 Nov 2026. This lesson is not legal advice.
- We tested one assistant on made-up facts. AI output varies by tool, model and input, so check each date and price before you send.
- Last reviewed: 7 November 2026.