Help the user with Braze platform questions — from Canvas Flow journey orchestration and cross-channel campaigns through BrazeAI, Braze Data Platform, segmentation, Catalogs, Feature Flags, and REST API integrations.
Step 1 — Gather context
If references/learnings.md exists, read it first for accumulated knowledge.
Ask the user:
What area of Braze do you need help with?
A) Canvas Flow — journey orchestration, multi-step cross-channel flows
B) Campaigns — single-send or API-triggered messages
C) Email — templates, drag-and-drop editor, Liquid, Connected Content
D) Push notifications — iOS, Android, web push, rich push (for cross-platform strategy, hand off: /sales-push-notification {your question})
Q) Admin — workspaces, API keys, SCIM, permissions, billing
R) Migration from Appboy or another platform
S) Something else — describe it
What's your role?
A) Marketing / CRM / lifecycle marketer
B) Growth / product manager
C) Developer / engineer
D) Data / analytics
E) Admin / ops
F) Other
What are you trying to accomplish? (describe your specific goal or question)
If the user's request already provides most of this context, skip directly to the relevant step. Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end.
Step 2 — Route or answer directly
If the request maps to a specialized skill, route:
Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
Instance-specific endpoints: Braze has many regional instances (US-01 to US-08 and US-10 — there is no US-09 — plus EU-01/02, AU-01, ID-01, JP-01, KR-01). US and APAC instances use .braze.com; EU instances use .braze.eu. Using the wrong instance URL (or wrong domain for EU) for your API calls will silently fail. Always check Settings → APIs and Identifiers for the correct REST endpoint.
Canvas vs Campaign confusion: Braze has both "Campaigns" (single-step) and "Canvas" (multi-step). Users asking about "sequences" or "journeys" want Canvas, not Campaign. Users asking about "blasts" or "one-time sends" want Campaign.
MAU-based pricing can spike unexpectedly: Braze charges by Monthly Active Users, not contacts. If you run a reactivation campaign that wakes up dormant users, your MAU count (and bill) will increase. Warn users about this when designing win-back campaigns.
Liquid vs Handlebars: Braze uses Liquid templating (like Shopify), NOT Handlebars (like SendGrid/Postmark). Syntax is {{${first_name}}} not {{first_name}}. The double-dollar-sign wrapping is Braze-specific Liquid.
Connected Content rate limits: Connected Content API calls happen at send time. If you send to 1M users and each message calls an external API, that's 1M API calls to your server. Implement caching ({% connected_content ... :cache_max_age 300 %}) and ensure your API can handle the load.
Self-improving: If you discover something not covered here, append it to references/learnings.md with today's date.
Step 5 — Related skills
/sales-push-notification — Push notification strategy across platforms
/sales-in-app-messaging — In-app messaging and content card strategy across platforms
/sales-email-marketing — Opt-in email marketing strategy across platforms
/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do
Examples
Example 1: Building an onboarding Canvas
User says: "How do I create a 7-day onboarding journey in Braze for new app users?"
Skill does: Guides through creating a Canvas with action-based entry (session start, first time = true) → Day 0 welcome push + in-app → Day 1 email with getting started guide → Day 3 Decision Split (completed setup? yes → feature highlight Content Card, no → reminder push) → Day 7 survey in-app message. Includes setting conversion events and A/B variant setup.
Result: Complete onboarding Canvas with branching, multi-channel messages, and success metrics
Example 2: Setting up Currents data export
User says: "I need to stream Braze engagement events to our Snowflake data warehouse"
Skill does: Walks through Dashboard → Data Settings → Currents → Create New Current → Snowflake → configure connection credentials, select events to stream (email opens, push clicks, in-app impressions, purchases), set data format. Explains the Snowflake Data Sharing alternative for zero-ETL access.
Result: Real-time engagement data flowing from Braze to Snowflake
Example 3: Using Connected Content for personalized recommendations
User says: "How do I pull product recommendations from our API into Braze email at send time?"
Skill does: Shows Connected Content syntax: {% connected_content https://api.example.com/recs/{{${user_id}}} :save recs :cache_max_age 900 %} → iterate with {% for item in recs.products %} → build product cards in email. Covers error handling ({% if connected_content_status == 200 %}), caching, and load testing.
Result: Dynamically personalized product recommendation emails pulling from external API
Troubleshooting
Canvas not sending to expected audience
Symptom: Canvas shows 0 entries or far fewer users than expected
Cause: Entry audience filters too restrictive, rate limiting too aggressive, re-eligibility disabled, or entry schedule not matching expected trigger
Solution: 1) Check entry audience — preview the segment size. 2) Verify the trigger event is actually firing (check user profile event log). 3) Check rate limiting settings. 4) Ensure re-eligibility is enabled if users should enter multiple times. 5) For API-triggered Canvas, verify the API call includes the correct canvas_id.
Push notifications not delivering
Symptom: Push campaigns show sends but low/zero deliveries
Cause: Invalid push tokens, expired APNs certificate, incorrect FCM key, or users unsubscribed
Solution: 1) Check push token validity in user profiles. 2) Verify APNs certificate or FCM key in Dashboard → Settings → App Settings. 3) Check push subscription status — filter segment by "Push Enabled". 4) For iOS, ensure push primer was shown and user accepted. 5) Test with a known-good device first.
Connected Content returning errors
Symptom: Emails rendering with blank personalization or error fallbacks
Cause: External API unreachable at send time, rate limited, or returning unexpected format
Solution: 1) Test the API URL manually with a sample user_id. 2) Add error handling: {% if connected_content_status == 200 %}. 3) Add caching: :cache_max_age 300 to reduce API calls. 4) Ensure your API can handle the send volume (1 call per recipient). 5) Add a fallback: {% else %}Default content here{% endif %}.
