salesforce-messaging-setup

Integrate the Salesforce Messaging for In-App iOS SDK into SwiftUI or UIKit apps.

10|10|Updated Feb 11, 2021
One-click install
npx skills add https://github.com/Salesforce-Async-Messaging/messaging-in-app-ios --skill salesforce-messaging-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: salesforce-messaging-setup
Source: https://github.com/Salesforce-Async-Messaging/messaging-in-app-ios/tree/main/skills/setup
Command: npx skills add https://github.com/Salesforce-Async-Messaging/messaging-in-app-ios --skill salesforce-messaging-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you correctly set up the Salesforce Messaging for In-App iOS SDK so your app can authenticate to Salesforce and present a working chat interface without broken navigation or missing configuration.

Core Features & Use Cases

  • SPM/CocoaPods dependency setup: Adds the required iOS SDK dependencies and resolves the correct Swift-InAppMessaging product wiring.
  • Configuration + conversation routing: Creates Configuration from a config.json (or programmatic values) and manages a persistent conversationId so the user resumes the right conversation.
  • SwiftUI or UIKit UI integration: Integrates the SDK into your existing SwiftUI or UIKit view hierarchy by adapting the provided ContentView.swift or UIKitMIAW.swift example patterns.

Quick Start

Ask the user for whether they use SwiftUI or UIKit and whether they have a Salesforce config.json (or the service API URL, org ID, and developer name), then follow the skill steps to add the dependency, create the Configuration and managed conversationId, and present the chat UI from their existing navigation.

Frequently Asked Questions about salesforce-messaging-setup

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

FAQPage Schema
How do I integrate in-app messaging into my iOS app?

In-app messaging integration requires adding the Salesforce Messaging iOS SDK via SPM, creating a Configuration object, managing a persistent conversationId, and presenting the chat UI. The skill provides validated steps for installing dependencies and wiring the chat interface into your project.

Does the Salesforce Messaging SDK work with both SwiftUI and UIKit?

Yes, the Salesforce Messaging in-app chat SDK works with both SwiftUI and UIKit. The skill provides example patterns for integrating the chat interface into either a SwiftUI ContentView or a UIKit view hierarchy, adapting the UI presentation to your existing navigation structure.

What configuration do I need to set up in-app chat in Swift?

In-app chat setup requires a Salesforce config.json file or programmatic values containing your service API URL, org ID, and developer name. You use these to create a Configuration object that authenticates your app to Salesforce and routes the chat conversation correctly.

How do I manage conversation IDs for in-app chat in iOS?

Conversation ID management involves creating and persisting a conversationId so users resume the correct chat session. The skill guides you through generating this ID during configuration creation and maintaining it across app launches to ensure reliable conversation continuity.

What's the best way to add the Salesforce Messaging SDK using Swift Package Manager?

Adding the Salesforce Messaging SDK via SPM requires editing your project.pbxproj to resolve the correct Swift-InAppMessaging product wiring. The skill enforces example-aligned code generation and validates imports to ensure the dependency is correctly added before you build and present the chat UI.

Why does my in-app chat UI break after adding the Salesforce messaging SDK?

In-app chat UI breaks often result from missing configuration or incorrect dependency wiring. The skill addresses this by enforcing validated imports, SPM project.pbxproj edits, and post-integration build and UI validation checks to ensure the chat interface presents without broken navigation.