Setting up the integration:
To begin using the PlantechHub/Redtail integration, you first need to establish a link between the two platforms. To begin this process, click the Global menu navigation in PlantechHub (the 3 vertical dots in the header of the application). Then, click "Advisor Integration":
Then, click "Add Integration":
At that point, you'll be prompted to select the integration partner type and integration partner, as well as being prompted to enter your credentials for that partner (in this case Redtail CRM):
Next, click "Save", and, if credentials are entered correctly, you should soon see that the integration has been established between the platforms:
After establishing this connection between PlantechHub and Redtail CRM, you can then configure your plans to pull Redtail account data.
Assigning Redtail Contacts to a Plan
While in context of a plan, click the three vertical dots to launch the plan menu. By clicking the “Plan Integration” selection, you will be navigated to a page to configure the contact linkage to this plan:
Upon clicking Plan Integration, you will be navigated to the screen below:
Any currently configured integrations would show up here. In this case, there are no previously configured linked contacts so the Integration table is blank. Simply click “Add Integration” (this step is a one-time operation for a PlantechHub plan but may be managed in the future).
You'll then be prompted for search information as seen below. Simply select the active integration in which to search (in this case Redtail) and complete the appropriate search criteria to continue:
The application will display a list of Redtail contacts which match your search criteria. If the desired Redtail contact is found in the list, you can link to the plan by selecting the contact and clicking save. Your may repeat this search pattern and link as many contacts as desired to the plan.
In this case, a user has elected to link both Gomez and Morticia to the plan. The integration links for Redtail will be listed in the Integration table. This system will pull account information for each of the listed Redtail contacts for updating balances, staging, and linking within the plan going forward.
Triggering the Integration with Redtail
Once the contacts are linked to the plan, the next time the plan is launched, the integration of accounts will be automatically triggered. You may also navigate back to the Plan Integration and click “Refresh Integrations” for an ad hoc pull of accounts. The automatic pull upon plan launch will only be executed once each day, but the ad hoc pull via “Refresh Integrations” may be used as many times as necessary. Once the accounts have been pulled from Redtail, they will be staged as seen below on the Investment Asset tab on the Plan Integration page:
As you can see, the description of the staged integrated account is the Redtail Account Company Name appended with the last 4 of the Redtail number assigned to the account. This description may be managed later by you but is defaulted here for informational purposes.
Managing the Integrated Redtail Account Data
Ignoring Integrated Accounts
You may choose to “Ignore” the account, which will move it to the “Ignored Data” list seen in the left navigation of the page.
Once an account is ignored, it will not be updated until returned to the staging table and linked or added to the plan. You can elect to stop ignoring the account by clicking “Stop Ignoring” and it will be transferred back to the Pending Data tab as seen above for assignment.
Linking Integrated Accounts to Existing Items
By clicking “Link to Existing Item”, you can link the staged integrated account to an existing manually entered account. Clicking “Link to Existing Item” will bring up a list of unlinked accounts and you'll be prompted to select one and click save.
What does a Linked Integrated Account look like?
In this example, we've selected to link the staged integrated account to a previously manually entered account with description Gomez 401(k).
By navigating to the Investment Assets of the profile, you will now see the linked account in the summary as well as in the Asset Input itself. When linking an integrated account, only the balance is updated in the existing account. You may manage the other account information as necessary in the normal Investment Account input/edit screen. Once the staged integrated account is linked to an account, it will no longer show up in the staged Investment Accounts table.
You should also notice in the screenshot above that in the input for the Gomez 401(k), the application shows the integration type and last updated date timestamp. Additionally, in the summary table on the left side of the screen, a link icon will display beside the linked account. You may break the link to this integrated account by deleting the account or clicking the stop icon seen in the image.
Adding the Staged Account as a Newly Discovered Investment Account
In addition to linking to existing accounts, you may also elect to create a new account based on the staged Redtail Integrated Account. By clicking “Add to Plan” on the Pending Investment Accounts page for a specific staged account, you may begin the process of importing the account into the plan. The Description of the account will be defaulted to match the staged description and you'll be prompted to identify the Investment Type. The Investment Type will be defaulted based on logic provided in Appendix B.
Once you click "continue", you'll be navigated to the appropriate Investment Account input to complete any necessary account information which could not be retrieved and defaulted from Redtail. At this point you can complete the required information, confirm the correctness of the investment account, and save it as a new integration linked account. This ensures that the account has been reviewed and has sufficient information to be used in the plan. For instance, you may assign the allocation which is currently not calculated from the positions if assigned in Redtail.
Integration Data Pull
After the contacts and accounts have been linked or assigned to the plan, the integration will be triggered on the first plan launch each day. You may also elect to make intraday ad hoc integration requests by going to the Plan Integration page and clicking “Refresh Integrations”. Each integration pull will update the linked account balances and stage any new accounts.
Investment Account Actions as Related to Integration
Once an account is linked, you will be presented new action icons (as shown below). Clicking the “Pause” icon will pause the integration of the account in the future thus maintaining the account’s current balance. The “Pause” icon will switch to a “Play” icon once the account integration is paused. To resume integrated balance updates, click the “Play” icon. To delink the integration with Redtail without deleting the account, click the “Stop” icon. This will break the integration and the integrated Redtail account will be eligible to be added or linked to another account. The account on which the “Stop” icon was clicked will remain but will no longer be linked.
Please note that neither clients nor professional access users will be able to see the “Pause”/”Play” or “Stop” icons. The client, if given edit capabilities on the Profile, may delete the account which would result in the integration being broken, and the account deleted.
Appendix A – Included Redtail Account Types
Appendix B – Default Investment Type Mapping
Directly Mapped Account Types
Account Types mapped using the Redtail Tax-Qualified ID
For the above accounts, the following account type default mapping applies based on the Redtail Tax-Qualified ID:
If you are looking for more Financial Planning Tools, click here!