Skip to main content

How to: Create and use Scripts

  • January 21, 2025
  • 0 replies
  • 21 views

Happie Pingol
Forum|alt.badge.img

 

Whether you’re launching a canvass or running a virtual phonebank, you will need a script. Your script is a roadmap for canvassers to follow during conversations on doors or on the phone. Use specific messaging and questions to suit the goals of your campaign.
 

Preparing to use scripts

Before you create your script:

  • Choose your Activist Codes - Activist Codes are labels you apply to contact records to track individuals according to their interests and their relationship to your organization.

  • Create Survey Questions - Survey Questions help you gather information, like gauging support for a candidate or initiative.


Choosing your script type

You have the choice of two script types you can use with MiniVAN or your phone banks.
 

Linear Scripts are designed for simple responses and/or straightforward asks from contacts.

  • Supported by MiniVAN, Virtual Phone Bank (VPB), and OpenVPB

  • Easy for your canvassers to follow when using paper canvassing packets or call sheets


Branched Scripts are designed for flexibility, so you can provide canvassers with instructions on how to further engage contacts or when to end a conversation.

  • Supported by MiniVAN and OpenVPB

  • Point canvassers to the next question and to talking points based on the responses they receive

Using the Scripts tool in Virtual Phone Bank, you can create a script to fit your segment or target audience.

When using Open Virtual Phone Bank, you can set a default script and up to 4 alternate scripts. Scripts can be directed to certain people by selecting a script using the targeted subgroup option. Callers are able to toggle between scripts in the Open Virtual Phone Bank.

Getting started

Search for Scripts in the Sidebar.

close up of the search area in the sidebar that says Scripts
 

From the top of the Scripts list page, select Add New Script and add the requested details.

Setup box for new script asking for details
If you use a multi-committee setup, you can only edit a script in the committee where it was created, the Owner Committee, but you can share it with other committees to use in their outreach efforts. If you have access to multiple databases (My Voters, My Campaign, My Workers), you will also see a Database option where you can pair your script with another database.   


You can update these Script details at any time by going back to the Scripts dashboard and selecting the script you want to edit.

 

Creating linear scripts

Linear scripts are generally used when you have a straightforward ask or simple response you need from your supporters. These can be useful in fast-paced outreach efforts where you are trying to reach the largest number of supporters to make them aware of your campaign or issue.

selection radio buttons with linear script selected

Script elements are conversation components. Provide language for introductions, messaging, questions, and goodbyes. Elements can only be added one at a time, but you can add multiples of each element type.
preview area of script builder that shows several elements already added

Use Text to provide suggested language for opening and closing conversations. You can also use this script element for messaging and transitions from one topic to the next.
example of script.

When adding Survey Questions and Activist Codes, you will only be able to choose from those you have already created. Once a survey question or activist code has been added, it will no longer appear in the dropdown menu.
example of Activist Code dropdown
 


Elements you add to the script appear under Script Preview. You can rearrange their order by hovering your cursor over the lines to the left of each element and dragging them to a new place. You can also Delete an element or Edit text. Save the order when you are satisfied with the script.

Preview of script being built

 

Creating branched scripts

Branched scripts allow canvassers or phone bank volunteers to conditionally select the next question on a Script based on the response they receive from the person answering the door or phone. Using script branching ensures that volunteers and canvassers have the right talking points for the right person and offers alternatives depending on the kind of response (committed, undecided, etc.).

radio buttons showing branched script selected
 

Once you select Branched, you can begin to add elements the same way you would with Linear scripts.

It helps to add all of your branched script elements before you begin connecting them. You can change their position later.

Beginning with your first element, think about what question or text should follow. The branch icon to the right of the element has a dropdown menu with numbers. Select the number corresponding to the element you want your canvassers to read next.

shows branched dropdown with numbers below it


For Survey Questions and Activist Codes, branch icons appear beside each possible response. This is how the conversation branches, sending canvassers to different text or further questions depending on responses. Select the number corresponding to the element you want your canvassers to read next.
survey question branching example

At the conclusion of a conversation select End. All script elements must branch or end before you can save your script.
end is selected for last element

 

When your canvassers see the script in MiniVAN, it will naturally lead them through the various branches.

example of script screen in minivan

 

In OpenVPB, your phone bank volunteers will be able to choose which response they received in the script area and will then be prompted with the next message or question.
 

What branched script looks like in OpenVPB


 

Adding more canvass result options​

For both script types, you can add more response types and keep records of conversations canvassers were unable to have by selecting more Canvass Result Options from the checkboxes in the right column.
Canvass Results section
list of possible phone results responses

Use caution when selecting terminal result types like Moved, Wrong Number, Deceased, and Do Not Email. These choices mark contact information as bad and can affect searches for other users with access to your database. Discuss best practices for using contact results with your canvassers.
 

Sharing scripts

In multi-committee setups, scripts can only be edited in the Owner Committee. To share your script with other committees for use in their canvasses or phonebanks, use the Committee Access selector at the bottom of the page.

committee selector in the scripts window 

If you have access to other databases (My Voters, My Campaign), you will see a section for Other Database Access, which allows you to share your script with them.

database selector in the scripts builder


 

Adding Spanish scripts

You can create a Spanish language version of your script that displays when your canvasser's browser is set to Spanish. We provide a Spanish translation of the forms and instructions in MiniVAN and OpenVPB, so you only need to translate the elements you add to the script. Provide Spanish translation of your Activist Codes and Survey Questions when you create them.

 

Retiring Scripts

If you need to retire a script, change its Status to Inactive or Archived. Do this at the end of a campaign or canvass to avoid confusing older messaging for newer messaging.
 

Open the script you want to retire and find Status on the Script Details page. Select the new status and save.

changing the status