Tonkean Walkthrough Level 1

  • 4 March 2021
  • 0 replies
  • 166 views

Goals

To plan out an onboarding and training plan for new users to Tonkean. To have an environment ready to deploy to each customer to “fill in” but also get certified.

Tonkey Level 1

  • Create and Deploy Modules

  • Add a Data and Communication Components

  • Create a basic flow

  • Assign themselves on Live Report

  • Invite another email and set as maker

 

In this level 1 certification, we are going to do a broad overview and implementation of basic Tonkean components. By the end of this you should have connected an email enterprise component as well as used the inbox to copy the message to another email or communications tool message.

Certification and walkthrough

Module pre-work: None, all these will be components that can be generated through the walkthrough

 

Training and verification steps:

 

toItdT3uWXNCj3e6jCuJ8_-1iO9Bi263sUpVBvoJfzUBWPnl3Zd8FS2CGQAxxEWZu1x2gCUE4v298jUZvZvlY5UBQ80YBtP3azcYDa2h5BSj_G6kdk_EgGuMlgNacQRdQL7Xwe9Q9NWHOSHg9IKKMjv_BuFPjXrLyOgcUWRyNpBd7rBI36LaAceaRW2zrwmdG5LaipeTneI3cZ-S7o-29hrtr9fPxV2r9zgT_kCu6BlM1iJpsg1c1rnbNNULp4uAVcK0WAVD37Bswhju

 

  1. Create an Enterprise Component for Email Inbox and name it “Intake Box”, you’ll have to click +Add Data Source, Email Inbox, and make sure that you specify which Solutions have access by going into the data source and clicking on “Solution Access” and pointing to the Solution, or the folder that has all your future ops modules in your Solution Studio’s page

 

cVHjw0ENN9fTwyur7VqWfoLiD-PVFRJI1teX02DwvinbuU9E9dcWDJm5XVWqiIxu9l2_eqru3f9oSgZcpciGNW8qHpRpjQ0WHXlOY5URtVWbp_2zeNrGEsiIaeg474FLoh0ERFUetDtlvwsu5pIrSqO1QLVHsW_TIIle85ObAgYKgEurUrOdjdnfy1aZGoUKnEMcNdeFMq5FntAuNr3k7l1DM1jPUTtcVFPqlNUBhsSN4mW1HL0n-yQlksh0a4y34r2COPmDug0TBOak

  1. If you go to “Connections” within the Intake Box, click on Edit and you’ll see an Inbox address generated. You can go ahead and copy and paste the email generated and send an email to this data source, this can be populated with any text so that you’re able to see the preview in the data later (nothing will happen yet)

PhWThQ5Efi0dl-EIOCdjuHPOhoBijaC8DIK-j8Z7gsILPUKHfMVv6QI-oFXuTl-IVFLPDvnJuHLInFw9EYjMuVgZEVhhS8fHNex_50kime8cygvDvvQtxdys0Gv8lUaPbQ63VZEI

  1. (Optional) Connect a Communications Source for one of the options, if Slack or MS-Teams is not available, then we will use Email later, this is under the sub tab in Enterprise Components

IAT1NBdyTFVYOmptouZIGKE21yIkwTp0en0fPvT2i-S_fR6F7CZIK7mVsNUpfOvlinA3esspr4k4zdzVgHWZHCHIBxOD0PqaP-8BBQau2GIbSzRNHjgllH4EsGELgd87MdqJ3oe2tPrdeG7j_oM2Imy1VFkJCoUsdfCSycpur0q1qDP1JI9TiQburpxAp2KqsJW3wXwBBS1-mjz6AouH4TM5nQUNhPy4BtYG9QfnrfoifzeiDzSPiVKDkLtgu-9TTnmIhJyQ-8jwUIjC

  1. In Solutions Studio, Create a new Module, Name it Email to Notification

0zBZv_7lUu6C3jEhm92X2vFs_Ff-mnkR3Yy3VYK2MjPzkjecKh6r6Po3gjLfTqwEUuuPtnQw4kv96yMacsBR_MX9mhJIaTCQkDzdDAWbwFJhai9K_aF4uymD9ldCeqd090p9WkqfTXfF-9kuwnzbTvWBRFWJL23nva66lirCndw8EGgyvaHbBN0Oy0J4paLr0i2mY8f_x8tiq8aXLeut-3OLzftmgef5BJT7LVac9ouOGraVhzWqMh1FJtd1gi95twVlJPipxd9WDhLF

  1. Under “Start here” and click on the the Intake Box (Email Inbox), your emails wil now flow into this entry point, but we’ll need some fields

  2. Add relevant email fields from Fields menu 

    • (Click on the “Fields” button VEkTuEv3FGEeCIALi0W953EhgvsaBeEXlUA7Bmu6b9ytDG1hO1xlQPpCsUqovp_6BwjVbEaKsWZbJX0ka8dtpgd8FYXhsz2pn-Py5f5QzKs3HBnNpcc1zagVXQji3Q1OCm1i4dSA, add Subject (clean), Body, From (email), Recipients)

iuLjS6Pae17xgIJaSVfSGfs0V5HNelwFnwyc0qCGzj39pAr_XkIWlrh2Cf-nafVyQsuwGWXVBD4GMeX5BjDh7fUCiru26S87H_2Ta1BxmghfClqSxMVK-Vz4m4We9wy2X0uNTira

  1. Add a “Send Notification” action after the Item is Added trigger

    • Click on the + icon after the “Item is Added” (the lightning bolt signals a trigger), Look for Send Notification (Note, Ask a Question is a similar action block, but it enables you to add buttons for decisions, you can play with this later)

Zv9pi2VjqjAfVrmhgbW7ZcikletoeXk66bfNgxHOv1xvXf3116X-xNdULIT4a1SoyF_Jxxy53YdwZUpLPA6ESUmGYTqbUo6HjfoFh4M5Z3zEGbSML3pA2OKjox4oo5I0MjnW6Aru

  1. Reply back to the Email that came in with the Email Message

    • In Send Notification, select the notification method, and enter your email in the “Email from field” (or use the From (Email) field)

    • If Email, enter anything for subject

    • For rest, for the message body, type in “New Email from: “ then add the From field with the Insert field Y0QafbFNEgOPqjERUzVVblex4XMp1WUqCc29psNWl-aHguoZT4dW6ZvTXVA5KkNme1hbIGEFVP-oEtn9cLtf8-CY4dYFvyKDjfz8Sx_bJLUnFFI3MUwPMYl0Usvtm12L7neZuJkWsign. Then type in “Message body: “ and add the Message Body field

QiMAEjivclcTIL9clH0BwxpCbmOI1KDqHDBSSHaHu9peZOTqFOWnTF55RBF1rTHyMT6EPnlcp0RkzDsFdPn_zeUbQlmQeWjCXrtclsp7CEyDI0sbjaqk1mL5KeOgTL6fM3wKWVd8ehDmXHyVNrV8653kcltQjJIoVW7-34dgi0oKG1Ny7RmwKqDV2vueS3AZ-VjSkDUTpr-sJpQ7xVguVcMkyQmFOMYA4YU8HWT7Ki5l565pC8jjsBo38D_jRv3APF9tPtjw6LmypaCM

  1. Create a new Match Condition to route a subject “hello” differently

    • To the left of the “Item is Added” trigger, click the TquyYe00XBO78WF_QrwuwZzzuJ2DC-8WC92eJO9v0Bi3OtELgYXs5YRUrvk2WWRwCw_7EHX3e_IDQrs27SIm9joT5LGppw9lHv73b6lpWUkucdsDs8O14_S8Pi8sXkt7en4gi-es, and select “Match Condition”, this will create a new conditional trigger

    • On the right side, click on the Add new condition, select the “Subject” field

    • Click on the condition field, select condition “contains” and type in hello)

3I11VxyuRDc-XjPRl8AODiXWZs57yV0MYXPc28W6fz0tiXMz93c4fEbXZ8CNVQ_OTZWUZagaI0TGwO1_zJpOKPdTW-rNuBz0F6k37yhrTAqhS2N8w1yGcGHmlEXN3LVRKT5_y99K

  1. Click on your original Send Notification, the menu drop down has a “Duplicate”, click this to reuse it

uut3mVH3K6yQFZERoqzIs_1pGnJ4L8dOXOM9GvZMXDiqMWjQYrg6AVzpumL-oyF99UnMkp7xA2gzfa1JLiKBQBNTRjfUzlEd-vnjOWPMjGmnNGtXGPvqciYRIq6vlImCutMbOc3m

  1. Drag this to the Match Condition below, turn it on with the top right, then change the Email Subject to, “This message said hello”. You’ve now set two different notifications for different conditions!

  2. While you’re here, you can turn on your module by clicking on BUILD -> PRODUCTION, and turn on the module after publish

kySBoItDVqpGVa-E-XbnqCpQiyGfxmpKgL_CmMYjVMDIFH8sbAW9efRXD9MWnnjViIPbXwoQJJIAwn8TQ2CxxYGDYGRx904rPJG9cQzDW-rGOCjsXAT40CEmc2tCi1wnuOlFAayZ6yKlquAllkEOE1m4lgQHNm0IYOsEcr0gXJ4l17oZLYBttwiQhIUuVSALO8Ohfd_qYYIYc64n8EzDWXD4JS6vMfsNfQioX5H_BDfheV2zmkmLr_ga3-xyCk2KWr8tfquJH53RVoQg

Deploy the module

 

0yZE2ztweNxiitafR5jDdBejdh2KIl0qibKnTox_2Io3pGYpz_twrFRvgn3siikqetU7DXSSoBZBfqzSFvipVXqZOLkLoeUm7PLKUSrQtwhz5L-Lc_WbGTt1RfebN7zN2bxq0gs1

  1. Click on “Mark for Publish”, it will pop up a few test pages, but just click Next and Continue until you get to a “Describe your change”, you can type in “First Draft” for this and click Mark for Publish

FF1zZuDWyYu686aiTdY2gu4CNUkzPyVg1pHVfIs1YXJ0F-g6AxlPCpm0Qx86FgYrv4A_HPzfd5p95ZfNW_N6Yt4xNfBIPOaCQgMbZfn0HFoCih7T78o-zVutHac9TszHfHmXPUYs

xOm7XrUmYSMbnFI-7gRKEAeVXvQjYe40xoWj2pyu1bfCffvmOpNNz9uG3T8tvPM8YbRIg8rjYMVB55ktDPl68wcC-rGIHP8scVpO2ZQ9-CTO55pRSIZpGmdTHXencYDilnhYMLdD

  1. Return to the Solutions Studio page, click on “Publish Version”

  2. If there are other modules waiting to be published, mark them as ready or revert them to go to last version (warning, revert will wipe modules that were never published!)

  3. Click on Publish and fill out the notes. 

 

Send your first Email and test this module

 

-lwezGYUc0cjuaAfCNZoLeA96EtrOo9wmZThFWerBUJLXnZnmnRNS_AvwqJUCmnX-rY6vKFnNRtXQfhUt88adVYTje33a1PkZeyKsI0JKIXcpdpnwwEcgzlsywBIMdeq-WWXfwNqaNL-3QDAbBQAVEq-QYp9d58_RS2Et2G8WMV_9zYpdqAefHbCLDVIYcg58Na8GqNiHbBEbPH32-hUYecihwhF-0ZLyEyxFpRUPOfBcWqT2k5mq-8DipvUmoWGJwk4_TUBDfToXs4K

  1. Make sure to grab your email address

    1. As a reminder,  it’s in Enterprise Components -> Intake Box -> Connections -> Edit, and you can Copy it

    2. A good practice is to add it to an alias or a group so you don’t have to memorize it for future email projects

  2. Send 2 emails to this address, make sure to put “hello” in the subject in one of the emails and not in the other

C0mcg1oWniYxaIqpqLSV2CBHjOmu0KwwMT7F3rNl6gXFhnDQSMdNXoUvGD2NAuFFcV-mB_YYovHSd9nz3rdHu1zz7cnVdmaVy_PKtyyxqQmQgMyURwWLPmJceqREMHJZloBevQrc

  1. Click on View Data and check if they popped up

  2. Check your messaging notification source and see if the right notifications came in!

 

Checking business reports

 

Business reports are a way to monitor each transaction that starts in your module, the “History” is where you can monitor the transaction in each block, and finally the “Runtime” function can monitor transactions across your entire set of workflows

 

Here we’ll just touch base on Business Reports, where you can pull in fields and check status on items if you want to update them in the flow

hQmH_UjXyI4D7XEV9iKzg_7zxyA2wT3dP3HiimQSGMBpxrS_E6pq-gxW-6ntRv3gDQhxDvJ10TnIsD4cCjrns4poUlbwInCxRLCmNKwyXUes4HuqBwSlXccpr-h4fneW7jUrtrQo 

 

  1. Check if emails came to live report

UztV_OEdCvcva47p6i6S4U36P2Yz478xkdVa3GJH8fPgpkSCAOBtLzuAE2P5Vk0J8WJleq8u6vzfGNr4nepjVh2zpKMTGUtyFswJ78Bq6_LHwz9tQmm7IiKr12FGBsFOmG1FFPFU

_PsIXlygSMyJHHLtPJxG1N8WkQe6crif5MLHNwMPBkkQ_gWvdlqrZNxrraKi5a7YJ9uBIA2wifWGSciKF6PqgrhIN5jVyNr5ooKGSyuZNfvcYey8TaUCqwWGXCjH1rmKULT3aD7X

  1. If you’re in build mode, you can add more fields, add Emails - Body, Emails - Subject (Plain), and Emails - From (Email)

Am_5fD_uq0IT46kH_mXtchvWGX3vNp_OV1HVSkKzEVp26wBRClRrG2xuQWyFTFjrt7nEaQRodzO5i34IFtjd9mD6Rl7vV9mBHbwuwIW-xkkfe2qSZuXl57h_7ZNGqa6MLN4do_1Y

  1. You’ll need to republish and deploy the changes, but your Business Report will now have greater visibility with what’s happening to your workflow



 

As reference, -EwizHa4ZAnUwY5Mrj_yZ1hAiU5fra4FoeKs2SlB68btlxLBQlpH2w-_ULoO6dQEf1YcYqWAPVDocl8mxsRsVeMYxtJ3ByU6bK0umbnL75KzkrvkFQjxfDp_mVFPugjpnrQ5JNLois in the module top right corner, and Runtime is in the top left main menus:

 n7xxZZ8xwDUO2Jft3bNpQOXivyQB1saygkZkKFl3SmH3VcRvWaHeajUvJcqz-_k-ereybnLMucDkIwIbc_uh-GkMSn0pKsCa4His4sT-ch5bM_fqdkqBJnz5JnPJ7gpvo7a-l_ql


 

You are now a Tonkey Level 1


0 replies

Be the first to reply!

Reply