Documentation

iOS TappaText Customisation

TappaText enriches your iOS application by adding a conversational AI assistant. To ensure this feature complements your app's design and branding, we've made the title, icon, and chat messages fully customizable. Follow these steps to personalize the TappaText feature for your application:

Changing the Feature Title

The title of the TappaText feature can be customized via the KBToolbar.json configuration file. This allows you to rename the feature to better fit your application's branding.

  1. Locate the KBToolbar.json file in your project. This file contains the configuration for keyboard toolbar items.
  2. Modify the title attribute for the TappaText button configuration. Replace the default TappaText value with your desired feature name. For example, to change the title to "ChatBot", update the file as follows:
{
  "order": 8,
  "buttonType": "tappaText",
  "useTint": true,
  "iconResource": "mocha_tappa_text_icon",
  "title": "ChatBot"
}

Customizing the Feature Icon

To change the icon associated with TappaText, you'll need to replace the existing icon resource in your project.

  1. Prepare your custom icon ensuring it matches iOS design standards and dimensions appropriate for toolbar items.
  2. Replace the mocha_tappa_text_icon resource in your project with your custom icon file, keeping the same file name. This ensures the system uses your icon for the TappaText feature.

Personalizing Chat Messages

The chat prompts and welcome messages for the iOS version of TappaText can also be customized to suit your application's tone and user engagement strategies. You'll modify these strings in the appropriate Localizable.strings file within your project.

Finalizing Your Customizations

After making these changes, ensure to test the TappaText feature within your app to verify that the customizations have been applied correctly and that the feature operates as expected. Check the appearance of the icon and title in the keyboard toolbar and interact with the chatbot to see your personalized messages in action.