How to Configure Mobile SDK in BoldDesk

The Mobile SDK in BoldDesk enables you to integrate a help widget into your mobile app, providing in-app support with Knowledge Base access, ticket submission, and seamless embedding with minimal code.

Steps to Configure Mobile SDK

1. Navigate to Mobile SDK Settings

1. Go to Admin → Configurations → Mobile SDK.
2. Click Add Mobile SDK on the top-right corner.
   This opens a page with two sections:
   • General
   • SDK Configuration

2. General Settings

In the General tab:

• Mobile SDK Name: Enter a unique name for your SDK.
• Brand: Select the brand for which you want to configure the SDK.
• Contact Form:
  • Enable Contact Form to collect user feedback (Name, Email, Phone Number, Subject, Description).
  • Optionally, enable Contact Form with Ticket Fields to include all system and custom ticket fields mapped to the selected brand.
• Knowledge Base Settings:
  To enable or disable Knowledge Base in your SDK, go to:
  Admin → Customer Portal Settings → KB
• Ticket Management Settings:
  To enable or disable ticket creation, updates, and closure in your SDK, go to:
  Admin → Customer Portal Settings → General

Click Next to proceed.

3. SDK Configuration

In the SDK Configuration tab:

• App ID: Copy the generated App ID for integration.
• Authenticate your SDK:
  • Choose Anonymous or JWT Secret authentication.
  • If using JWT, click Generate new key and store it securely.
• Push Notification:
  • Enable push notifications for real-time updates.
  • Configure Android and iOS settings using Firebase guidelines.

Android Configuration

• Enter Bundle ID.
• Upload the Firebase service account private key file.
  Learn how to create a Firebase project and generate a private key file.

iOS Configuration

• Enter Bundle ID.
• Select Push Notification Category.
• Upload the Firebase service account private key file.

Click Add to complete the setup.

Integrate the SDK into your mobile app using the provided App ID and authentication details.

Frequently Asked Questions (FAQ)

1. What is the Mobile SDK in BoldDesk?
The Mobile SDK allows you to embed a help widget in your mobile app, enabling users to access the Knowledge Base, submit tickets, and interact with support seamlessly within the app.

2. Do I need admin access to configure the Mobile SDK?
Yes. Only users with admin privileges can configure Mobile SDK settings in BoldDesk.

3. How many Mobile SDKs can I create?
The number of SDKs you can create depends on your subscription plan. Check your plan limits under Admin → Billing and Subscription.

4. What authentication methods are supported?
You can authenticate your SDK using:

• Anonymous authentication.
• JWT Secret authentication for secure access.
  If using JWT, generate a new key and store it securely.

5. Can I customize the contact form fields?
Yes. You can:

• Enable a basic contact form for feedback.
• Enable Contact Form with Ticket Fields to include all system and custom fields mapped to the selected brand.

6. How do I enable Knowledge Base and Ticket Management in the SDK?
Go to:

• Admin → Customer Portal Settings → KB for Knowledge Base.
• Admin → Customer Portal Settings → General for ticket creation, updates, and closure.

7. How do I configure push notifications?
For Android and iOS, upload the Firebase service account private key file.

Learn how to create a Firebase project and generate a private key file.

8. Where do I find the App ID for integration?
The App ID is generated in the SDK Configuration tab after you complete the setup. Copy and use it in your mobile app code.

9. What happens if I delete a Mobile SDK configuration?
Deleting an SDK configuration will remove its integration details. Your app will no longer be able to connect to BoldDesk services using that SDK.

10. Can I integrate the SDK in both iOS and Android apps?
Yes. BoldDesk Mobile SDK supports integration with both iOS and Android platforms.