tester-troubleshooting

What problem does it solve?

This skill provides a single, structured diagnostic guide to identify root causes and resolve delivery failures for pushes, in-app messages, banners, segments, API/webhook errors, and race conditions across Braze campaigns and Canvases. It reduces time-to-resolution by directing investigators to the correct failure layer, offering targeted checks for token ownership, segment reachability, payload limits, platform error codes, and network connectivity.

Core Features & Use Cases

• Layered diagnostic workflow: Step-by-step checks from user eligibility and push registration through segment computation, platform-specific error codes, and infrastructure/network verification.
• Error-code mappings and remediation: FCM and APNs error tables, API 4XX/5XX guidance, Braze-specific simulated codes (e.g., 598), and concrete resolution steps.
• Race-condition and timing guidance: Detection patterns and fixes for ordering issues, Canvas delays, synchronous vs asynchronous API calls, and delivery validations.
• Use Case: A QA engineer uses the guide to triage a non-delivering push by verifying push registration, token validity and ownership, segment filters, payload size, and then mapping observed server error codes to remediation steps.

Quick Start

Ask the tester-troubleshooting skill to run a systematic diagnosis for a failing push, segment, in-app message, or API error by providing the affected user ID, app, and observed error or symptom.