- CategoryCRM
- AuthAPI key + webhook
Overview
Connect ScoreApp to start MessageMind campaigns when people sign up for, start or finish one of your ScoreApp quizzes. Each lead who gives an email address or phone number is added to your Contacts, and their quiz results can go into the campaign's messages and conditions. You connect it with a ScoreApp API key and a webhook that you add to each scorecard in ScoreApp.
What MessageMind can do with it
- Start a campaign when a lead signs up, starts your quiz, finishes it, or updates their details on the result page.
- Add each lead to Contacts with their name, email address and phone number. If a contact with the same email or phone already exists, the lead is matched to that contact.
- Put the lead's score, score tier and highest category into campaign messages.
- Send leads down different paths of a campaign depending on how they answered a specific quiz question.
Requirements
- A ScoreApp account where you can create API keys and add webhooks to your scorecards.
- A MessageMind Starter, Professional or Enterprise plan.
- If you are a team member, a role that is allowed to connect integrations.
How to connect
- In ScoreApp, click the ScoreApp logo at the top left, then Account settings > API keys.
- Click add API key, name the key and click Create secret key.
- Copy the key right away.
- In MessageMind, open Connections > Integrations and pick CRM in the left rail.
- Click Connect on the ScoreApp row. The Connect ScoreApp window opens.
- Paste your key into API Key.
- Keep this window open and do the next steps in ScoreApp in another browser tab. The Webhook URL and Secret key shown here are the ones saved when you click Connect.
- In ScoreApp, open the scorecard you want to use, go to Integrate > Webhooks and click Connect.
- Copy the Webhook URL from the MessageMind window with the copy button next to it, and paste it into the URL field in ScoreApp.
- Copy the Secret key the same way and paste it into the Webhook Secret Key field.
- Turn on all four events and click Save in ScoreApp.
- Go back to MessageMind and click Connect. The window closes and the ScoreApp row shows a tick.
- Repeat steps 8 to 11 for every other scorecard that should start campaigns, using the same Webhook URL and Secret key.
- Build a campaign with a ScoreApp trigger (see the example workflows below). New leads go into Contacts from now on.
Authentication and permissions
- Mechanism
- You paste a ScoreApp API key into MessageMind. You then copy the Webhook URL and Secret key shown in the Connect ScoreApp window into the webhook settings of each scorecard in ScoreApp.
- Credentials
- Create the API key in ScoreApp under Account settings > API keys. ScoreApp keys start with a number and a vertical bar (|). The Webhook URL and Secret key are created for you in the Connect ScoreApp window.
Available data and actions
Reads
- The lead's first name, last name and email address.
- The lead's phone number, from the lead form field whose label mentions phone, mobile or WhatsApp. If no label matches, an answer that looks like a phone number is used.
- The total score as a percentage and in points, plus the score tier.
- The category the lead scored highest in.
- Where the lead stands in the quiz and when they finished it.
- The quiz questions and the lead's answers, which Quiz question conditions check.
Configuration
- Which events reach MessageMind is set in ScoreApp, separately for each scorecard, under Integrate > Webhooks. Turn on all four to use every ScoreApp trigger.
- In a campaign, the ScoreApp triggers are in the Score App group of the Choose a trigger window: Lead Signed Up, Quiz Started, Quiz Finished and Lead Details Updated.
- Each ScoreApp trigger has a Runs On Contact setting, Once or Multiple Times. You set it in the window that opens when you pick the trigger, and you can change it later with Edit on the trigger. Lead Signed Up starts as Once. The other three start as Multiple Times, so a lead who retakes the quiz goes through the campaign again.
- In message steps you can insert Total Score (%), Total Score (Actual), Total Score Tier, Highest Category, Quiz Status and Finished At. Finished At (long) gives the same date written out in full.
- To branch on an answer, add a Condition step, pick Quiz question as the variable and fill in Question, Question type, Operator and Expected answer under Quiz answer match.
Example workflows
Send each lead their result after the quiz
- In the Workspace, open Campaigns and click Create campaign.
- In the Choose a trigger window, pick Quiz Finished from the Score App group.
- In the window that opens, keep Runs On Contact on Multiple Times so people who retake the quiz get the message again, or set it to Once. Click Save.
- Add an Action step and choose Send WhatsApp Template.
- Choose your template and fill its variables with Total Score Tier and Total Score (%).
- Switch the toggle at the top right from Draft to Published and click Save.
- When a lead who gave a phone number finishes the quiz, they get the template on WhatsApp with their tier and score.
Follow up differently depending on one answer
- Create a campaign that starts with Quiz Finished.
- Add a Condition step and pick Quiz question as the variable.
- In Question, type the question exactly as it reads in ScoreApp. Capital letters do not matter.
- Set Question type to the type the question has in ScoreApp, for example Yes/No/Maybe.
- Set Operator to Equals and Expected answer to Yes.
- Put the message for leads who answered Yes on the Yes path, and a different one on the No path.
- Switch the campaign to Published and click Save.
Disconnect and reconnect
- Open Connections > Integrations and click Disconnect on the ScoreApp row. It disconnects straight away.
- Contacts already added from ScoreApp stay in Contacts.
- Remove the webhook from each scorecard in ScoreApp (Integrate > Webhooks) so ScoreApp stops sending to it.
- To reconnect, click Connect again, paste your API key and copy the Webhook URL and Secret key the window shows into every scorecard's webhook in ScoreApp.