Developer Docs | Kommunicate

Developer Docs | Kommunicate

  • Book a Demo
  • Try For Free

›iOS

Web

  • Installation
  • CMS Installation
  • Authentication
  • Conversation
  • Conversation Assignment
  • Customization
  • Localization
  • Logout
  • Troubleshooting

Android

  • Installation
  • Authentication
  • Push Notification
  • Conversation
  • Customization
  • Localization
  • Logout
  • Migration
  • Troubleshooting

iOS

  • Installation
  • Authentication
  • Push Notification
  • Conversation
  • Customization
  • Configuration
  • Localization
  • Logout
  • Troubleshooting

React Native

  • Installation
  • Expo Installation
  • Authentication
  • Push Notification
  • Conversation
  • Customization
  • Logout
  • Troubleshooting

Flutter Mobile

  • Installation
  • Authentication
  • Push Notification
  • Conversation
  • Customization
  • Localization
  • Troubleshooting

Flutter Web

  • Installation
  • Authentication
  • Conversation

Ionic/Cordova

  • Installation
  • Authentication
  • Push Notification
  • Conversation
  • Customization
  • Localization
  • Logout
  • Resolving Errors

Ionic/Capacitor

  • Installation
  • Authentication
  • Push notification
  • Customization

Rich Messages

  • How To Use
  • Types of Rich Messages

Bots

  • Bot setup
  • Dialogflow Integration
  • Lex Integration
  • Kompose Bot Builder
  • IBM Watson Integration
  • Custom Bot Integration
  • Import Kompose Bot
  • Bot Samples

Integrations

  • Zapier
  • WhatsApp
  • WhatsApp 360Dialog
  • WhatsApp Twilio
  • WhatsApp Cloud API
  • Instagram Integration
  • Telegram Integration
  • Sunshine Integration
  • Freshdesk Integration
  • Pipedrive Integration
  • Agile Integration

Platform APIs

  • Authentication
  • Endpoints

Dashboard Features

  • Analytics
  • Conversations
  • Users
  • Bot Integration
  • Helpcenter
  • Campaign Messaging
  • Settings

Configuration

  • Single Sign On (SSO) Setup
  • Webhooks
  • Access Token URL
  • Email Fallback

iOS Troubleshooting

Troubleshooting Guide

This guide will help you in troubleshooting the issues that you may face during the integration. To resolve the issue we need a few details so we can identify the problem and suggest the solution, following guide will help you in fetching those details.

How to report issues with logs?

Share all these details with our team support@kommunicate.io we will debug and suggest the solution

  • Kommunicate version: This can be found in Podfile.lock as explained in the following section.
  • COCOAPODS version: This is also available in the Podfile.lock file.

Cocoapods version

  • Xcode version: Open Xcode tool and click on About Xcode from the top menu as shown below:

Xcode

Another way to check the Xcode Version is by running the following command in the terminal:

xcodebuild -version
  • iOS version of the phone in which you are facing the issue

  • Logs

    • Copy the logs from the Xcode console and share it in the .txt or .log file
    • If there is a crash log, share it in separate file-crash logs and normal logs. Also you can download it from the Crashlytics.

Logs

How to check the current Kommunicate SDK version?

Locate your target Project directory(location of the Kommunicate SDK in your system) and search for the file called Podfile.lock(present in the same directory of the project).

Project Directory

Podfile.lock

Also, you can run the below command in terminal to know the version details

cat Podfile.lock 

Push notification troubleshooting

If you are having problem in receiving notifications on your iOS device, follow these steps:

  1. In your test device, get the User ID of the user which is logged in to Kommunicate.

  2. Open our Push Notification Test Page and enter your APP_ID and User ID which is logged into the device.

  3. Once you submit, the status of that push notification will show.

StatusDescription
Key Store not FoundYou have not uploaded your APNS certificate on the Kommunicate dashboard. Make sure you have uploaded it for both development and distribution. Also, check if the password that you have set is correct. Check this section on where to upload the certificates.
Not ValidAPNS Device token is not coming from the device. Check here the code that you need to add to your project.
Invalid tokenThis error comes when a development certificate has been uploaded in the distribution field or vice versa. So, check the type of certificates and upload them accordingly.
Received Fatal Alert Internal_errorIf the certificate is not correct like if you upload a normal development certificate rather than an APNS certificate then this error will come.
Received Fatal Alert Certificate RevokedIt means that the certificates that you have uploaded have been revoked from your side. Create new certificates and upload them again. After that, you can test the notifications.
Received Fatal Alert Certificate_expiredIt means that the certificates that you have uploaded have been expired. Create new certificates and upload them again. After that, you can test the notifications..

For Xcode 15 and above

DT_TOOLCHAIN_DIR cannot be used to evaluate LIBRARY_SEARCH_PATHS, use TOOLCHAIN_DIR instead

Fix :

  1. Upgrade your Cocoapods version to at least v1.13.0 to resolve the issue.
  2. For versions below v1.13.0, include the following code in your Podfile to resolve the issue.
post_install do |installer|
  installer.aggregate_targets.each do |target|
    target.xcconfigs.each do |variant, xcconfig|
      xcconfig_path = target.client_root + target.xcconfig_relative_path(variant)
      IO.write(xcconfig_path, IO.read(xcconfig_path).gsub("DT_TOOLCHAIN_DIR", "TOOLCHAIN_DIR"))
    end
  end
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      if config.base_configuration_reference.is_a? Xcodeproj::Project::Object::PBXFileReference
        xcconfig_path = config.base_configuration_reference.real_path
        IO.write(xcconfig_path, IO.read(xcconfig_path).gsub("DT_TOOLCHAIN_DIR", "TOOLCHAIN_DIR"))
      end
    end
  end
end

From v7.0.1 and above

If you're experiencing an error during pod installation, add the following code to your Podfile.

use_frameworks!
platform :ios, '13.0'

Additionally, raise the minimum iOS deployment target to version 13.

iOS Runner File

Privacy Manifest (Issue in App Review)

If you encounter issues during the App Review process, add this to your Privacy Manifest file. Skip any key-value pairs already present in your file. If you don't have a Privacy Manifest file, create one.

<key>NSPrivacyTracking</key>
<false/>
<key>NSPrivacyTrackingDomains</key>
<array/>
<key>NSPrivacyCollectedDataTypes</key>
<array/>
<key>NSPrivacyAccessedAPITypes</key>
<array>
    <dict>
        <key>NSPrivacyAccessedAPITypeReasons</key>
        <array>
            <string>CA92.1</string>
        </array>
        <key>NSPrivacyAccessedAPIType</key>
        <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
    </dict>
    <dict>
        <key>NSPrivacyAccessedAPIType</key>
        <string>NSPrivacyAccessedAPICategoryActiveKeyboards</string>
        <key>NSPrivacyAccessedAPITypeReasons</key>
        <array>
            <string>54BD.1</string>
        </array>
    </dict>
</array>

App Store Distribution Issue for Versions up to 7.2.0

If you're encountering issues when uploading the release build to App Store Connect, please take the following actions:

  • Downgrade your Xcode version to 15.4, or
  • Update Kommunicate to version 7.2.1 or later.

iOS Upload Issue

← LogoutInstallation →
  • Troubleshooting Guide
    • Push notification troubleshooting
  • For Xcode 15 and above
  • From v7.0.1 and above
  • Privacy Manifest (Issue in App Review)
  • App Store Distribution Issue for Versions up to 7.2.0

Ready to automate more than 80% of your customer support?

Try for Free
  • support@kommunicate.io
  • United States
    (+1) (310) 402-2374
  • India
    (+91) 974-057-0196
  • Learn
    • iOS Chatbot
    • Amazon Lex Chatbot
    • Chatbot in Android
    • ChatGPT with Flutter
    • Document to Chatbot
    • React Native Chatbot
    • Create Flutter Chatbot
    • Whatsapp Business API
    • Integrate React Js Chatbot
    • Whatsapp Chatbot Using NodeJs
    • Integrate ChatGPT With Whatsapp
    • Integrate Dialogflow With Whatsapp
    • ChatGPT For Product Engagement
    • Product
    • AI Chatbot Builder
    • Generative AI Chatbot
    • Customer Experience
    • Chatbot Features
    • Dialogflow Integration
    • FAQ Chatbot
    • Live Chat
      Industries
    • Healthcare Chatbot
    • E-commerce Chatbot
    • Education Chatbot
    • Banking Chatbot
  • Integrations
    • E-commerce Chatbot Integration
    • Omnichannel Chatbot
    • Chatbot Integration
    • Chatbot for Website
    • Mobile Apps Chatbot
    • Chatbot for CRM's
    • Automation and Analytics
    • Zendesk Chatbot Integration
  • Resources
    • Chatbots Templates
    • Case Studies
    • Whitepapers
    • Chatbot Guide
    • Videos
    • Knowledge Hub
    • Comparisons
    • ROI Calculator
    • Blogs
    • Company
    • Partner Program
    • Affiliate Program
    • Pricing
    • About Us
    • Media
      Support
    • Contact Us
    • HelpCenter
    • Stack Overflow
    • API Status
  • Comapare
    • Kommunicate Vs Verloop
    • Kommunicate Vs Intercom
    • Kommunicate Vs Yellow
    • Kommunicate Vs Twak
    • Kommunicate Vs Ada
Arabic
Hindi
Spanish
French
German
Portuguese
Urdu
Software Advice Frontrunners for Live Chat Mar-22Software Advice Frontrunners for Live Chat Mar-22crozdesk badgeISO certificationHIPAA complianceGDPR compliant - GDPR Copy 12Created with Sketch.COMPLIANT
Copyright © 2025 Kommunicate.io.
T&C Privacy Policy Career SLA DPA Sitemap