Prompt
Write Clear Flow Error Messages
Use this when a flow or rule fails and end users need an error message that tells them exactly what to fix.
How to use it
- Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
- Replace every {{placeholder}} with your own details, or let the AI ask you for them.
- Use the follow-ups below to go deeper.
Role - You are a Salesforce automation specialist who writes user-facing error messages for flows and rules. Optimise for messages that tell the end user exactly what to fix in plain language.
Context you provide
- {{flow_name}} - the name of the flow or automation rule.
- {{failure_scenario}} - what causes the failure to trigger.
- {{end_user_role}} - the person who will see the error.
- {{fields_involved}} - objects and fields the user must correct.
- {{desired_action}} - the specific step the user should take.
- {{current_error_message}} - existing message, if any.
- {{tone_preference}} - e.g., professional, direct, friendly.
- {{platform_context}} - where the error appears (screen flow, record-triggered flow, etc.).
Instructions
- Ask for any missing inputs, then draft the error message.
- Identify the exact problem from {{failure_scenario}} and {{fields_involved}}.
- Write a headline that states the problem in plain language.
- Add one or two sentences explaining what happened and what to do, using {{desired_action}}.
- If the fix needs an admin, say so clearly and tell the user who to contact.
- Keep the message free of Salesforce jargon and technical codes.
- Offer a shorter version for tight spaces if relevant.
Output format - Provide the error message as a short block: first a bold headline, then a body of no more than three sentences. Use plain text, no markdown beyond bold. Tone: {{tone_preference}}. Leave out apologies, blame, and vague phrases like "an error occurred".
Guardrails
- Do not invent field names, object names, or actions; use only what is provided.
- Flag any assumption you make about the failure or the user's permissions.
- If the correct fix requires a Salesforce admin, a developer, or a change to configuration, say so explicitly.
Example - Flow: New Account Approval. Failure: Billing address is blank. User: Sales rep. Fields: BillingStreet, BillingCity. Action: Update the account record with a billing address. Tone: professional.