/
Flag Reasons

Flag Reasons

 

Platform URL

https://[enterprise]/v2/enterprise/flag-reasons

Epic

https://convertr.atlassian.net/browse/CON-5716

API Endpoints

Load Invalid Flag Reasons

GET api/v4/lead-flag-reasons?itemsPerPage=10&page=1&leadFlag.name=invalid

Load Returned Reason Flags

GET /api/v4/lead-flag-reason-categories?itemsPerPage=10&page=1

Add Returned Flag Reason

POST api/v4/lead-flag-reason-categories

Document status

FOR REVIEW

Document owner

@Danny Hannah @Adam Carter

Technical writers

@Arunima Kurup Prasad

Related Content

https://convertr.atlassian.net/wiki/spaces/PF/pages/2011922461 https://convertr.atlassian.net/wiki/spaces/PF/pages/3079667892

Feature Overview

The Flag/Manage option available on Global Leads page and Campaign Leads page allow certain user roles to mark leads as Valid/Invalid/Test/Delivered/Undelivered etc.

While flagging leads using the options Valid, Invalid and Test, the platform provides some default reasons to be selected. Sometime, additional custom reasons need to be available when flagging leads. To facilitate adding custom flag reasons, we have a ‘Flag Reasons’ page at the Enterprise level.

Screenshot 2024-05-29 at 14.46.33.png

This page currently has a single tab called ‘Invalid' that lists all existing Invalid reasons that are available by default in the system. There is a ‘Configure’ button available in the ‘Actions’ column for the reason: ‘Returned’.

Admin users can click on the Configure button to add custom reasons for the Returned reason category.

Clicking the Configure button opens the below modal, which contains the entry ‘None’ by default.

Screenshot 2024-05-29 at 15.03.05.png

Admins can add new custom reasons for the Returned category by typing in the new category name and clicking on the ‘Add’ button.

On clicking ‘Add’, a warning dialog is shown to the user informing them that adding the category is a permanent action and cannot be undone. This warning is shown specifically because there is no option to edit or delete custom flag reasons, once they are added.

If the user clicks Yes, the category will not be added to the list. If the user clicks Yes, the new category will be added to the the list of Returned reason categories.

The Returned reason categories added in this way will be available in Flag/Manage modal when user selects ‘Mark as Invalid’ and selects the Invalidating reason as ‘Returned’.

The reason category is reportable via both Lead Export and Leads Report Builder.

Lead Export

If a lead is invalidated using 2nd check flag reason as ‘Returned’ and with a custom reason category, then selecting the ‘2nd check flag reason category’ in the fields will show the custom flag reason in the lead export report.

Flagging as Invalid with reason as Returned and with custom reason category

Selecting relevant fields in Lead Export

Lead Export Report showing custom Returned reason category

Report Builder

Similar to lead export, it is possible to report on leads flagged using custom returned reason category.

Report output

Currently it is possible to add custom reason categories only for Returned Reasons.

Summary

Functionality

User Story

Functionality

User Story

1

Add Returned reason categories

An Admin/super admin user can add custom reason categories under the Reason type ‘Returned’, so that when flagging leads as Invalid with reason as returned, they can select the exact reason for returning the lead(s) from the dropdown.

 User Permissions

Only Admin users have access to the Enterprise section of the platform.

https://docs.google.com/spreadsheets/d/1i4qTTKkC3rF3EyEOh2585ktDDGge0L0IMVDNCwriFR0/edit#gid=67588165

Related content

Leads - Flag/Manage Custom Returned Reasons
Leads - Flag/Manage Custom Returned Reasons
More like this
Returned Leads Phase 1: Leads Flag/Manage (Returned)
Returned Leads Phase 1: Leads Flag/Manage (Returned)
More like this
Convertr Connect Integration Job - Set Returned leads
Convertr Connect Integration Job - Set Returned leads
More like this
Filter for Returned Leads
Filter for Returned Leads
More like this