salesforce-messaging-troubleshooting

Diagnose Salesforce Messaging for In-App iOS SDK failures through ordered symptom checks.

10|10|Updated Feb 11, 2021

Search Tags:#debugging #troubleshooting #configuration #ios #push notifications #in-app messaging #sdk crashes

Ready to run

npx skills add https://github.com/Salesforce-Async-Messaging/messaging-in-app-ios --skill salesforce-messaging-troubleshooting

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: salesforce-messaging-troubleshooting
Source: https://github.com/Salesforce-Async-Messaging/messaging-in-app-ios/tree/main/skills/troubleshooting
Command: npx skills add https://github.com/Salesforce-Async-Messaging/messaging-in-app-ios --skill salesforce-messaging-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Troubleshooting the Salesforce Messaging for In-App iOS SDK when something is broken, crashes, shows a blank screen, fails builds, or doesn’t behave as expected.

Core Features & Use Cases

Guided triage: Runs users through an ordered checklist to narrow down root cause by symptoms (debug logging, imports, configuration, delegates, conversation IDs, and SDK version).
Known-symptom routing: Maps common reported failures (build errors, runtime issues, push notification problems, user verification problems, conversation ID issues, pre-chat issues, attachments, business hours, iOS 26 liquid glass, and customization).
Code safety rules: Enforces minimal, targeted fixes and explicit requirements like using the correct SPM product name and importing both SMIClientCore and SMIClientUI for SDK types.

Quick Start

Use this skill when your iOS app using the SDK shows an error banner, crashes, or doesn’t receive notifications, and ask the assistant to walk through the triage steps in order for your specific symptom.

Frequently Asked Questions about salesforce-messaging-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

Why does my Salesforce in-app messaging iOS SDK show a blank chat screen?▼

A blank chat screen in Salesforce in-app messaging often points to missing UI delegate callbacks or incorrect SDK imports. You can diagnose this by verifying that both SMIClientCore and SMIClientUI are imported and running through the conversation lifecycle triage checks.

How do I fix build errors for the Swift-InAppMessaging SDK product name?▼

To fix Swift-InAppMessaging build errors, ensure you use the exact SPM product name and import both SMIClientCore and SMIClientUI. The troubleshooting workflow enforces these strict import constraints to resolve missing module failures.

What is the best way to troubleshoot iOS push notification failures in Salesforce Messaging?▼

The best way to troubleshoot iOS push notification failures is using a symptom-driven workflow that checks SDK configuration, verifies push behavior settings, and validates conversation ID resumption against the reference troubleshooting guide.

How do I diagnose SDK crashes and runtime issues with Salesforce in-app messaging?▼

To diagnose SDK crashes and runtime issues, run an ordered verification checklist covering debug logging, configuration validation, and delegate callbacks. This targeted triage narrows down the root cause of the iOS in-app messaging failure.

Does the Salesforce Messaging triage process handle incorrect customization assets on iOS?▼

Yes, the triage process handles incorrect customization assets on iOS by mapping known symptoms to specific configuration fixes. It applies reference-based solutions to ensure your in-app messaging UI displays the correct customized assets.

What should I do if user verification fails during a Salesforce in-app messaging conversation?▼

If user verification fails, check the ordered verification steps for configuration and conversation ID mismatches. The triage workflow isolates the runtime issue by validating delegate callbacks and SDK version compatibility.