Getting Started

Search…
Getting Started
Connector Configuration Help File
​
This Service is Currently in Beta please access it https://pickyassist.com/beta​
Getting Started 
The first step is to create a connector url, to do this from the top left side click on “Add” and in the popup fill the details 
Connecting URL 
This is the unique URL generated for the connector you created, this needs to be configured / added into the 3rd party software / application from which you wish to receive an event to the Picky Assist.
Generally, 3rd Party App call it as below;
1.Webhooks (Mostly Everywhere)
2.Rest Hooks
3.Hooks
4.Call Back URL
5.HTTP Request 
Just check and confirm whether your software supports sending data to 3rd party software through webhooks when an event happens in the software.
Passing Custom Variables
It's possible to pass custom variables in query string method along with the URL apart from the body in JSON i.e you can pass https://url.com/app/349384934?value1=1&value2=2 
The values passed through query string method will be available as "custom_variables" in JSON code and further you can make use of these values in the Steps, refer the below image to understand where the custom variables are visible
Common Usecase of Custom Variables
Custom variables are useful in situations where your application don't allow to pass a custom JSON payload but you want to use the single connecting URL for sending multiple messages for an example you have a flow where you need  to send different messages to a user at different situations as below;

Day 1 -> Message 1
Day 2 -> Message 2
Day 3 -> Message 3

Without the custom variable you need to create 3 Connector URL and configure 3 Actions separately and this process may be hefty if you have high number of automations, so using the custom variable and filter you can achieve this within a single connector.
First pass the variable as value=day1 for the first automation then for second message pass value=day2 and for 3rd day pass value=day3 then create a filter in the Steps for day1 and define the message needs to be send for the day1 similarly you can do this for all the days
Please make sure the variable remains same for all requests 
Generate New URL
Please keep this URL private and in case if you feel the URL is comprised, click the “Generate New URL” and this will generate a new connector URL, please note after generating the new URL please make sure it's updated in the app/software from which the URL is getting triggered.
Map Response 
Map response helps you to send a response back to the app/software, for example, if your application needs to perform certain actions based on the response then you can customise the response in any format and include the attributes from the Picky Assist Platform or even from the inbound received payload.
On clicking "Map Response" a popup will open where you can place response in plan text, html or any other code's as needed, you can also use the "Attributes" to insert the values from the Connector 
​
Field Mapping
This helps you to map the incoming data variables to the Picky Assist Attributes which helps you to create a new subscriber in Picky Assist or sync the data from the 3rd party platform to Picky Assist Attribute values when an event happens in the 3rd party Apps
The usage is like when a new lead is created in your platform add them into Picky Assist so that you will be able to make use of the WhatsApp Drip Campaign, Broadcaster feature through Picky Assist in just a few clicks.
Mapping More Fields 
You can map more fields by clicking the "Add More" button and then click the box which opens a new popup to select the field to be mapped 
Please note in order to map a field it’s mandatory to map the mobile number or email and default channel first. Every time the event is triggered the mapped data fields will get update against each subscriber in the Picky Assist

There is a situation that your 3rd party platform don't have the mobile number of the customer stored but you have the mobile number and email of the customer stored in the Picky Assist Platform, in this case it's possible to find the mobile number using the email address coming from the 3rd party site and able to send WhatsApp messages or take different actions with Picky Assist
Please note if multiple email address are saved in the Contacts/Subscribers in the Picky Assist then we will consider the contact which is added first into the Contacts/Subscribers.
JSON Code 
This is the core of the platform which helps our system to identify the data structure i.e in which variables the data is available for us to process, we support only JSON and Query String Method 
Mostly 99.9% of Webhooks are in JSON Format so it's a widely used format, however if you want to simply POST/GET a Query String then you can pass the data along with the Connecting URL as https://connecting.url/?name=yourvalue&mobile=yourvalue&email=yourvalue and we will convert this as JSON for ease of processing.
Getting the JSON Code Structure 
By default this code is empty until we receive the first event from the 3rd party platform, when we receive the event we automatically Map this and further the data structure will be available in the connector to reuse or configure. 
Once the Connector URL is set as Webhook / Hook / HTTP Request in the 3rd party software/application please trigger the event so that our system received the payload and map the structure.
You will able to see the event trigger logs from the right hand side as shown below, clicking on the even will open a popup and you will able to see the JSON Code Structure in the body 
A popup will open with the structure of the data, you can view the data in 2 ways i.e Design & Code 
If you are a developer and know the structure of the which likely to send from the 3rd party applications then you can click on the "Code" tab and update the code manually as well, we don't recommend this method 
Don't proceed with further steps until you have a JSON Code Updated.
Steps
Steps help you to take different actions based on different conditions, you can create upto 50 Steps with different filter conditions, delay and actions to automate many tedious tasks. 
If you want to send birthday greetings in 5 languages based on the customer country or language settings then you can do this using Multiple Steps, you can create 5 steps and each step will have a filter to check the customer language and have action to send message in different languages. 
A step have 4 components Filter, Delay, Action & Stats as shown below;
When an event enters into a step it start executing the components as per the order it saves, you can drag and change the components order the way
Changing the Order of Components in the Step
You can change the components in the step easily by drag and move so you will have the flexibility to execute the delay first then check for filter and take actions, or you can first take action then filter some data and delay further steps 
Naming the Step 
In order to easily identify what action it performs you can name it by clicking the “Step Name” and entering the Name.
Deleting Step 
On clicking the delete button will delete all actions and filters associated with a step
Adding More Steps
You can add more steps to perform complex filters, actions and delay as per your business requirements 
Changing the Step Order
The step will be executed in the order how it's saved and displayed, you can change the order by click and drag it 
Once the action order is changed please make sure all the filters if any in the actions are re-configured correctly to avoid executing wrongs actions.
Cloning the Step 
You can easily clone and existing step by click the icon as shown below and this helps you to save your time building the filter and action again from the scratch, instead you can simply clone any steps and make necessary changes to the cloned step 
Filter
Filter is one of the most powerful feature which helps you to filter the data coming from another app or the data stored within the picky assist and perform Actions based on the filter matching conditions, 
For example, if the age of the person is between 18-25 and gender is male then perform a set of action defined by you, similarly you can create any number of filters and specify actions which are specified to the filters 
You can create Unlimited AND filter conditions and decide whether to match all conditions or match any conditions to perform the action in the step. 
Match All Conditions : If you select this then the system will match all conditions configured in the filter i.e all conditions should be true to take further actions
Match Any Condition : If "Match Any Condition" is selected then the system will proceed to the next step if any of the condition in the filter becomes true.
Please note if the filter condition is false then it will skip the action configured in the step and moves into the next step in the order, so if you want to perform separate action for both filter conditions i.e true and false then please create another step with the false condition just below the true condition step
Below are the available data types and conditions to filter 
Data Types
Condition
Text 
is
isn't
contains
doesn't contains
starts with
ends with
minimum length
maximum length
is empty
is not empty
Numeric
equals
not equals
greater than
less than
between
not between
minimum length
maximum length
is empty
is not empty
Date & Time
is
isn’t
on
after
before
not before
between
not between
is empty
is not empty
Date
is
isn’t
on
after
before
not before
between
not between
is empty
is not empty
Time
is
isn’t
on
after
before
not before
between
not between
is empty
is not empty
Email
is
isn't
contains
doesn't contains
starts with
ends with
is empty
is not empty
Website
is
isn't
contains
doesn't contains
starts with
ends with
is empty
is not empty
URL
is
isn't
contains
doesn't contains
starts with
ends with
is empty
is not empty
Choice
is
isn't
is empty
is not empty
WhatsApp 
to Filter WhatsApp numbers
is
isn't
Date & Time Formatter 
There will be a situation when working with many 3rd parties that the date and time may not always be in ISO Standards so we have a date & time formatter which helps you to map the Day, Month, Year, Time, Hour, Format virtually from any type of formats when separated a record with a comma, hyphen, slash, dot, semi column 
You will also have the option to convert a date and time from a timezone to another which helps to send messages at the right time.
Date & Time formatter will appear when any of the Filter field type is Date, Date or Time, Time as show below 
Delay 
Delay helps to pause the execution of the steps for a certain period, there are many handy usecases for this feature's few are as below;
1.Sending an Automatic Followup After X days from the Lead Creation Date
2.Sending Periodic Reminders for Webinars like before 2 days, before 5 hours, before 30 minutes, on the specific date, after 1 day etc 
3.Sending Payment Reminders / Due alerts which respects to certain dates 
4.Sending a Meeting Reminders from Google Calendar, Outlook, Calendly etc
5.Sending a Feedback Message form after X hours from the product delivery time
Understand the Delay 
Delay can be configured in 3 ways as below;
Last Step Executed Time 
After ___  minutes /hours/day from last executed Step date
Event Received Time
After ___ minutes / hours / day from Event Received Date
Custom Delay 
Before  ___  minutes /hours/day from a Specified date
After  ___  minutes /hours/day from Specified date
On  ___  a Specified date
Custom delay gives you the power to set a delay based on a specific date in a dynamic way, for an example you can minimise the no show for your Zoom Webinar using the Custom Delay which can send an automatic reminders before, after and on the Webinar Start Date 
Please note if you are not mentioning a date then the delay will execute at 12 am in your Timezone which is configured in your profile, to avoid delivering any messages in 12 am or Odd timings you can add 10 hours after the date so it will deliver messages at 10 am i.e `10 hours from 12 am

Currently we support only ISO Standard Date & Time & Timestamp, mostly all 3rd party providers sends the date and time in ISO Standard format.
Identifier 
Identifier in the delay helps to track the delays which are in the queue to be executed in a future date, you can give a unique name or dynamically set the identifier name based on the event data from the 3rd party like Webinar Name, Webinar Unique ID etc as shown below;
Major usecase of the identifier is to cancel the queue in case something is not right or let's say a Webinar Event is cancelled and you want to stop sending the reminders of that particular webinar. 
Getting the List of Scheduled Delay's
You can see how many executions are in the queue which will be processed in the future date and time
Clicking on this button it opens a popup which contains the Identifier Name & Step which helps you to easily track the identifier which needs to be cancelled as shown below
Clicking on this button it opens a popup which contains the Identifier Name & Step which helps you to easily track the identifier which needs to be cancelled as shown below;
Delay Fallback Action
If the delay date validation is failed or the date/time is passed the current date/time then you can specify what action to be taken further as below;
1) Stop Executing Further Steps
2) Continue Executing Further Steps
Cancelling the Scheduled Delays
Using the filters in the popup you able to filter out all unique identifiers by its name for an example Webinar Name, Webinar ID, you can select one or multiple identifier which need to be cancelled 
Another popup will open which shows all count of the unique identifier, you can select one or multiple
Cancelling Delay is All Steps
There would be a situation that you want to cancel all delays in all the steps you have, this can be done using the Steps in the popup as shown below;
Actions on Cancelling the Delay
When you cancel a delay it prompt to ask the action which needs to be taken, here you have the option to select 3 actions 
1) Stop Executing Further Steps
2) Continue Executing Further Steps
3) Execute As Per Delay Fallback Configuration - This means this will respect the fall back delay you configured while created the identifier
Actions 
Actions help you to take 15+ actions like Sending A WhatsApp Message, Email, Add Tag, Adding into Subscribers, Adding User Into a Sequence etc
Changing the Action Executing Order
You can add multiple actions into a single step which will execute in the order as it displayed on the screen, you can change the action execute order by dragging each actions as shown below;

List of Available Actions

Action Category
Action
Description
Notification
Send Message
Send WhatsApp Message
​
Send Email
Send An Email 
​
Broadcaster
Send WhatsApp Message to a Group of Users, option to segment as well
Counter
Trigger Counter
Setting the Counter Value by a number specified 
​
Reset Counter
Resetting the Counter existing value to its default value
WhatsApp Group
Send Message to WA Groups
Post a WhatsApp message into one or more groups
​
Add User Into WA Groups
Add Members or Admin into one ore more groups
​
Remove user from a WA Group
Remove a users from a WhatsApp Group 
​
Create a WA Group
This will automatically create a new WhatsApp Group
Attributes
Set Attribute
Set an Attribute Value of the Subscriber Field in the Social CRM
​
Clear Attribute
Clear the value saved against the field
CRM
Add Tag
A New tag will be added
​
Remove Tag
A specific tag can be removed
​
Add Category 
A contact can be added into one ore more categories 
​
Remove From Category
A contact can be removed from the category
​
Open Ticket 
Create A new Ticket in the Social CRM
Automation
Add to Sequence 
Add a contact into a Sequence
​
Remove From Sequence 
Remove a contact from a Sequence
​
Pause Smart Replies
Pause the smart replies for X time
Attributes 
Attributes plays an important role in Filters & Actions like Sending Messages, Email etc , attributes helps to personalize the contents in an email or message. There are 3 types of attributes available in the connector as below;
Event Attributes : This is the attributes from the 3rd party Software / Application and will be available to select wherever you see </> symbol 
System Attributes : This is the Picky Assist default attributes i.e Name, Email , Mobile , Time Zone, Current Time 
Subscriber Attributes : This is the Picky Assist Social CRM Attributes created by you. 

Formatter : All the data stored into the formatter will be displayed under the formatter attribute section
Logs
All events triggered from the 3rd party software will be available in the logs and this helps to troubleshoot the issue or copy the JSON code from the body 
Stats
You can see the number of events received from the 3rd party in the right side of each Connector as show below;
The stats shows the lifetime value however if you want to reset the stats then you can reset the stats by clicking the "Reset" option as shown in the above image.
Once you reset the stats it will shows the stats only after the reset date.
Versions 
Version helps you to restore a last saved version in case if the configuration have any issues, you can see last 20 version history and able to restore it.
Use the version restore feature carefully if the JSON structure got changed and you restored to a previous version then it may not work as it should be until it mapped the fields properly, so after the version history restore please test your configuration thoroughly 
​