Picky Assist Help Desk
Main WebsiteBlogFacebook Community
Picky Assist Help Desk
Picky Assist Help Desk
  • Welcome To Picky Assist 🙏
  • Setting Up Guide
    • Sending First Message
    • Connecting Channels
      • WhatsApp Web Automation to Official API Migration Guide 2024
      • Connecting WhatsApp Web Automation
      • Connecting Facebook Messenger
        • Introduction
        • Getting Start
        • Guidelines & Compliances
        • Messenger Link
      • Connecting WhatsApp Official
        • Introduction
        • Dashboard
        • Profile
        • Templates
      • Connecting WhatsApp Cloud API
      • WhatsApp Official Managed Service
      • Connecting Instagram
      • Phone Bridge (Call Blaze)
      • Connecting SMTP
      • Connecting Amazon SES
      • Connecting Sendgrid
      • Connecting Additional WhatsApp Numbers
      • Porting WhatsApp Number to Picky Assist
      • WhatsApp Official Message Delivery Issues & Solutions
    • Working With Prebuilt CRM Modules
      • Introduction
      • Onboarding
      • Modules
        • Leads
        • Deals
        • Meetings
        • Company
        • Support Cases
        • System Modules
          • Contacts
          • Notes
          • Task
          • Call Logs
          • Tags
          • Activity Logs
      • Automations
        • Workflows
        • Chatbots
        • Funnels
        • Connectors
        • Scheduler
        • Other Prebuilt Features
      • Reports and Dashboard
      • Mandatory Preconditions for Using Prebuilt
      • Testing Prebuilt
    • Managing Organization
    • Setting Up Teambox
      • Introduction
      • Routing Rules
      • Teambox
      • Inbox View
      • Organization Hierarchy
      • Analytics
    • Setting Up Smart Replies
      • Introduction
      • Train Module
        • Training Bot Introduction
        • Topics / Categories
        • Intent & Context
        • Question Variations
        • Uploading Bulk Questions
        • Reply with Media Files
        • Personalising Replies
        • Smart Actions
        • Direct URL
        • Fall Back Response
        • Small Talks
        • Testing the Bot
        • Publishing Bot
      • ChatGPT Integration
      • Learn Module
      • Stats Module
      • Deep Linking
      • Settings
    • Smart Reply V2
      • Introduction
      • ChatGPT Integration
      • Train Module
        • Training Bot Introduction
        • Topics / Categories
        • Intent & Context
        • Question Variation
        • Uploading Bulk Questions
        • Reply with Media Files
        • Personalizing Replies
        • Smart Actions
        • Direct URL
        • Fall Back Response
        • Small Talks
        • Publishing Bot
      • Learn Module
      • Stats Module
      • Deep Linking
      • Settings
    • Setting Up Broadcaster
      • Introduction
      • Creating a Campagin
      • Sending Message to WhatsApp Groups
      • Reports
      • Broadcaster V2
        • Introduction
        • Creating Campaign
        • Reports
    • Setting Up Sequence
      • Introduction
      • Creating New Sequence
      • Sequence Stats
      • Subscribe & Unsubscribe
      • Disabling Sequence Message
    • Setting Up Reminder
    • Setting Up Mobile App
    • Setting Up Connector
      • Introduction
      • Getting Started
      • Steps
        • Introduction
        • Filters
        • Delay
        • Iterator
        • Stats
      • Actions
      • Formatter
        • Date & Time
        • Counter
        • Math Calculation
        • Data Parser
        • Convert File
        • Line Items
      • Building Mini App
      • Email Parser
      • Data Storage
      • Simulate Test
      • Connector Logs
    • Email Builder
    • Setting Up Flow Builder
      • Fundamentals (Must Read)
      • Basic Terminology (Must Read)
      • Guide to Building an Effective Chatbot (Must Read)
      • Create, Manage, Test & Publish Flows
      • Triggering a Chatbot Flow
      • Steps
        • Introduction (Must Read)
        • Send Message
        • Ask A Question
        • Filter
        • Save Data
        • Actions
        • Check WhatsApp Session
        • Delay
        • Smart Delay
        • Formatter
        • Splitter
        • Data Lookup
        • Trigger HTTP API
        • Webhook
        • Apps
        • Match Keywords
        • Route to Chatbot
        • End
      • Saving Data into CRM
      • Analytics
      • Integrations
      • Flow Builder logs and conversational logs
      • Chatbot Best Practices, Ideas & FAQ
    • Setting up Modular CRM
      • Fundamentals (Must Read)
      • Guide to Building and Implementing a Modular CRM (Must Read)
      • Create & Manage Data Modules
      • CRM Macro Buttons
      • Adding Records into CRM
      • Data View & Manage Records
      • Task
      • Workflows
      • Funnels
      • Data Import
      • Integrations
    • Setting Up Scheduler
    • Media Gallery
    • Quick Replies
    • Opt-out Settings
    • Blacklist
    • Global Variables
    • Setting Up Ad-On's
      • Setting Up WhatsMail
      • Setting Up Zendesk
      • Setting Up Zapier
      • Setting Up Zoho CRM
        • Getting Started
        • Working with Extension
        • Integrating with Zoho Workflow
        • Lead Assignment Rules
        • Integrating into Custom Modules
        • Connecting Multiple WhatsApp Numbers into Zoho CRM
        • Integrating WhatsApp with Zoho CRM Mobile App
        • Keyboard Shortcuts
      • Setting Up Facebook Lead Adform
      • Facebook Lead Ad form V2
      • Setting Up WhatsApp Web
      • Setting Up Pabbly Connect
      • Setting Up ChatGPT App
    • Google Chrome Extensions
      • Extension for Sending WhatsApp Messages from any Webpage
      • Chrome Extension V2
      • Extension for Zoho CRM & Teambox
    • Managing Profile
      • Two Factor Aunthentication
      • Login History
      • Delete Account
    • Quick Rollout Guide
      • WhatsApp Official Account
    • Developers & Partners Guide for Deep Integration of Picky Assist
  • API Documentation V2
    • Introduction
    • Quick Start Guide 🏃
    • Global Webhook
      • How Webhook Works
      • Webhook Variables
      • Configuring Webhook URL
      • Webhook Request & Response
      • Getting the Conversation Context
      • Testing Your Webhook
    • Event Webhook
      • How Event Webhook Works
      • Event Webhook Variables
      • Configuring Event Webhook URL
      • Event Webhook Sample Request & Response
    • Push API
      • Introduction
      • API Variables
      • Sending Single Message - Push
      • Sending Dynamic Messages – Push
      • Sending Media Attachments – Push
      • Sending Interactive List & Buttons
      • Sending Stickers
      • Sending Bulk Messages - Push
      • Sending Contacts
      • Sending Location
      • Sending WhatsApp Template Messages
        • Introduction
        • Sending WhatsApp Template Text Messages
        • Sending WhatsApp Template Image
        • Sending WhatsApp Template Document
        • Sending WhatsApp Interactive Buttons
        • Sending WhatsApp Limited Time Offer Templates
      • Sending Message to Groups
      • Sending SMS Using SIM Card
      • Sending Message to Facebook Messenger
      • Normal Post Method
      • Delivery Reports
      • Push API Must Read Instructions
      • Testing API Requests
    • WhatsApp Template API
      • Introduction
      • API Variables
      • Template Request API
      • Template Status API
      • Languages
      • Guidelines
    • WhatsApp Group API
      • Introduction
      • API Variables
      • Create Group
      • Set Group Permission
      • Add Group Admin
      • Add Group Members
      • Fetch Group Details
      • Update Group Info
      • Remove Group Members / Admin
      • Generate New Invite Link
      • Group Delete Actions
    • WhatsApp Settings API's
      • WhatsApp Profile API
      • 2 Step Verification
      • WhatsApp Status Update
      • WhatsApp Contact & Group Fetching
    • Device Manage API’s
      • Fetching Device Status API
      • Device Commands API’s
      • WhatsApp Automation Server Status API
    • Account API
      • Fetch Balance
    • Project Management API
      • Introduction
      • Create Project
      • Get Project Details
      • Set / Update Webhook
      • Create API Token
      • Manage API Token
      • Change Billing Plan
      • Fetch Account Balance
      • Country Code & Timezones
    • References
      • Status & Error Codes
      • Most Frequent Issues & Solutions
      • Formating & Sending Emojis 😊
      • Postman Collection for Picky Assist API's
      • High Volume Messaging Bots - WhatsApp
    • Sample Codes
      • PHP
      • Python
      • Node JS
      • Ruby
      • Java
      • ASP.NET Using C#
      • Javascript
      • Go
      • Swift
      • C
      • C#
      • Objective C
  • General Guidelines
    • Billing
    • Adding Money Into Account
    • Rate Limits
    • Character Limits WhatsApp
    • Best Practices for Media Handling
    • Roadmap
    • Features In the Early Beta Version
  • Changelog
    • 2021
      • February 2021
      • March 2021
      • April 2021
      • May 2021
      • June 2021
    • 2020
      • February 2020
      • March 2020
      • April 2020
      • May 2020
      • June 2020
      • September 2020
      • October 2020
    • 2019
      • November 2019
      • October 2019
      • August 2019
      • September 2019
Powered by GitBook
On this page
  • Introduction
  • Mini App Builder Possibilities
  • ChatGPT as Mini App Step-by-Step Video
  • Type of Mini Apps
  • Seamless Integration
  • Deep Link Buttons
  • Iframe Embedding
  • Macro Buttons
  • Before Getting Start
  • Getting Started
  • Buttons
  • Setup Trigger
  • Trigger URL
  • Show Forms
  • Trigger URL
  • Show Form
  • Manually Build Form
  • Form Types
  • Editing, Deleting & Changing Position of the Form Fields
  • Hidden Form Fields
  • Error Description & Submit Button Label
  • Prefill Fields
  • Double Confirmation Form Submission
  • Pin to Top
  • Show in Mini App Bar
  • Disable or Enable the Mini App
  • Response
  • Plain Text
  • HTML
  • Permission
  • References

Was this helpful?

  1. Setting Up Guide
  2. Setting Up Connector

Building Mini App

Integrate any 3rd party app into Picky Assist using Mini App builder

PreviousLine ItemsNextEmail Parser

Last updated 8 months ago

Was this helpful?

Introduction

At Picky Assist we want each and every business to achieve maximum automation capabilities and focus on the work that matters most, that’s why we have a mini app builder which is capable to integrate all the software and application you are using to run your business right inside the Picky Assist platform so that you and your users can access them easily without switching between apps, that saves a lot of time when you communicate with your customers.

Kindly note that Mini App works with Picky Assist Connector and API integration is required for creating seamless integrations with the application you are using, You must contact your existing software/application or developer to do this integration and Picky Assist doesn’t provide any support on this integration apart from any issues which are related to the Mini App builder. You can for seeking help from automation experts.

Mini App Builder Possibilities

ChatGPT as Mini App Step-by-Step Video

Type of Mini Apps

We support the following types of Mini Apps and building each type of app requires certain skill sets as mentioned below;

  1. Seamless Integration

  2. Deep Link Buttons

  3. Iframe Embeddings

  4. Macro Buttons

Seamless Integration

Seamless integration generally requires integration through APIs and required the help of a software developer or you should have enough understanding on how to make HTTP API requests from the Picky Assist Connector, for example, seamless integration like getting order details from Shopify, Woo-commerce site, Listing today’s appointment from Zoom or Calendly, create a meeting in the Zoom, adding a meeting into your calendar, generating a payment link through Paypal, Stripe, Razorpay or integrating ChatGPT etc

Skills Needed: HTTP API Integration, Array & JSON basic working

Deep Link Buttons

You can deep link other web-based applications like Linkedin, Twitter, Google, Facebook, WhatsApp, Email, Truecaller, Zoom, and Google Sheets that support deep linking through URLs without the help of a developer.

Skills Needed: No Skills

Iframe Embedding

If your application supports embedding into another software then you can consider iframe-based embeddings, like google calendar, calendly calendar, google forms, or any forms, internal chat widgets etc

Skills Needed: No Skills

Macro Buttons

Macros buttons are capable to take a group of actions when a button is clicked by the user, for example after chatting with a customer your sales team is able to send a business proposal via email and WhatsApp, add the customer to a specific category, tag them, automatically add into a drip campaign, set a followup reminder, add notes automatically, add the details into 3rd party software, etc by just clicking a button.

Skills Needed: No Skills but for performing actions in 3rd party applications need HTTP API Integration skills

Before Getting Start

Before you begin building your mini app please get the following details ready

  1. Decide what type of app you would like to build and the main objective of your mini app.

  2. If you need seamless integration then get the API documentation for the app you would like to build as a mini-app inside the Picky Assist

  3. Make sure that the response from the 3rd party app should be in JSON format

  4. You should be familiar with Picky Assist Connector & Trigger HTTP API to make API triggers from your mini app if you are looking to build seamless integrations

  5. You need to create an HTML page using Picky Assist email builder and should understand the concept of “Loop Blocks” to render array-based output to the mini-app users like listing orders, listing data from another CRM etc

Getting Started

Mini app is associated with the Picky Assist Connector so first, you need to create a new connector and then click on “Min App Builder” from the right side as shown below;

This will open a builder where you can start building the mini-app as shown below;

The mini app builder have 3 sections Form Fields | Response | Permissions as shown above and let's discuss each section in detail;

Form Fields This is where you need to set up the basic details of the mini app as per the requirements

Response This is where you need to build the response which needs to show back to the user when they are interacting with the mini app

Permission You can define the role to whom the mini app should be visible.

Buttons

This is where you need to give a name to your mini app along with a description and can select an icon, color, etc to customize, this will be visible to the user

Setup Trigger

Based on the type of app you wish to build you need to select the “Trigger Type” you can see 2 options Trigger URL & Show Form as shown below;

Trigger URL

This is useful for the following type of integration

  1. Iframe Based Embedding

  2. Macro Buttons

  3. Deep Linking

Show Forms

This is useful for all types of integrations however widely used for a seamless integration, where you can present a form to the user and the user need to manually input the data and submit the form, this data will go to the connector and will take the actions you configured in the connector steps, after that it will return the response back to the user

Trigger URL

Trigger URL has 2 options

Trigger Connector

This means you can trigger a connector whenever the user clicks the mini app button if you wish to pass additional payload to identify the user who clicked or information like mobile, email, or any data stored in the contact fields using the attribute options

Trigger URL

This method allows you to simply trigger a 3rd party URL like doing a LinkedIn search, true caller search, open Gmail compose a page or any application which supports deep linking from 3rd party applications

You can pass dynamic values while calling the URL using the attribute option like agent id, agent name or any value stored in the Picky Assist contact module, simply click on the </> to see the attribute mapping option

You can specify which window the output should show, by default it opens in a new browser tab if you wish to open the response within the mini app, then you must select “Open as Inline Iframe” and this will show the result to the user in the same window

Kindly note that iframe based embedding is generally blocked by almost all software providers so please consult with them before embedding another app in an iframe.

Show Form

This is the powerful feature of the mini app which helps you to build a form and present that to the user whenever they open the mini app, you can build a form in the following ways

  1. Manually build form

  2. Add form details in bulk separated by comma

  3. Build form through JSON

  4. Convert existing connector JSON as a form

Manually Build Form

You can fill in the details like form label, form description, and field type then click on Add button as shown below to create form fields

Form Types

Below are the form types you can choose depending on your requirements, you may use the same.

Supported Form Types

Type
Details

Text

A textbox will show t the user, a maximum of 200 characters allowed

Text Area

A text area will be shown to the user, a maximum of 10000 characters allowed

Number

Allowed only number

Drop Down

You can show a drop-down where users can select one option at a time, you will have the option to set a value for each options for further processing

Phone

Only numbers are allowed

Email

Only valid email address are allowed

Date

The system will present a calendar to choose a date

URL

URL like webiste can be passed

File

You can upload any file upto 25 MB and the uploaded file will be available as a public URL for further processing

Editing, Deleting & Changing Position of the Form Fields

You can edit or delete a form field by clicking the icons as shown below, you can also drag and move the position of the form

Hidden Form Fields

You can pass hidden values to the form like your agent name, id or any values from Picky Assist CRM or Teambox and this will be available in the connector for configurations to perform advanced automation like if a specific agent fills and submit the details in the mini app take a group of actions in the connector

Error Description & Submit Button Label

This message will show to the user when they don’t fill in the mandatory fields, kindly note that we check only mandatory fields, and not possible to validate the input You can also able to customize the label for the submit button.

Prefill Fields

This helps you to auto-append the mobile number, email, or any value saved in your contact module to the mini app form, this helps avoid manual data entry and this will work only if the form is opened through Picky Assist CRM or Teambox

Double Confirmation Form Submission

Double confirmation helps to get a confirmation from the user, you can add a description to show and able to customize the label for Yes & No in your own language

Pin to Top

Make the app top in the mini app list, kindly note if you have another app in the mini app which is pinned to the top then the system will show the app in the alphabetic order

Show in Mini App Bar

This will show the app in the global right sidebar which can access from any pages, if this is not enabled then the app can be accessed only from the Teambox or contact page

Disable or Enable the Mini App

If you would like to disable the mini app then you may enable this, the green tick means the mini app is enabled and grey shows the mini app is disabled and users will not able to see the mini app.

Kindly note that only the mini app get disables however the connecter and actions if any associated will still work

Response

Now we have to set up the response section that is after performing the required action in the connector what response should the app gives back to the user, we have 2 options to show the response

  1. Plan Text

  2. HTML

Plain Text

You can input any non-HTML text here, you can personalize the response dynamically received in the connector for example response from your HTTP Trigger step can be shown back to the user, and use the attribute icon to insert the attributes

You have 2 more settings for the response as shown below;

Show Execution Log

If required you can include the execution log from the connector which shows how many steps are executed in the connector along with its execution status to the user.

Copy to Clipboard

This feature allows you to automatically copy the response to the clipboard of the user so that they can just paste the response wherever they needed, helpful for your users who are assisting customers through Teambox and they fetch information from 3rd party sites like ChatGPT responses or any other response which needs to be sent to the user.

HTML

You can build an HTML web page using our email builder and enhance the user experience like a mobile app, with the HTML you can also achieve advanced automation like Loop an HTML div for showing dynamic data from an array like order details, invoices, data which are in array format, etc.

You can select an existing template or “Create Template” and it opens a new page with the drag-and-drop HTML editor where you can build the HTML contents.

Dynamic response mapping using attributes

If you want to show the dynamic content then you will have the option to map the attributes from the connector to the email template as shown below;

Please note that before building the HTML please configure the steps in the connector so that you can map the dynamic variable into the HTML template editor from the Connector

Permission

By default, the mini app will be available only for Admin but you can enable the mini-app for each user in your organization as per the role you have, so please select the roles to which the mini app should be accessible

Please keep in mind that if you have any privileges in the role which mask the mobile number, and email fields then you must pass these variables as hidden in the Mini App. The trigger URL method is not advised for these roles as the details can be visible to the user while redirecting to the configured URL in the browser bar or developer's network console.

References

HTTP API in Connector

Iterations in Connector
Loop Builder in Email Editor
join our Facebook community