Jump to a Section

Overview

The first time you add a Whispir card to a Flow, you need to set up a configuration for that Connector. Setting up a configuration will allow you to connect to your Whispir account, save the information, and reuse that configuration next time you build a Flow with the connector. That way, you don’t have to sign in every time you want to build a Flow with this Connector. After you’ve set up one configuration, you can choose to use that configuration again, or set up a new one.

You can set up and save multiple configurations and share them with your teammates. Here’s how to set up a new configuration in Whispir:

  1. Add the Whispir card you would like to use to your Flow. If you already have configurations set up, you will have to select Add Account to create a new configuration. If you don’t have any configurations set up, you will automatically be taken to the next step.
  2. Choose a nickname for your configuration. Choose something unique, since you may need to be able to tell multiple configurations apart in the future.
  3. Enter the API key, email, and password of your Whispir account.
  4. Click Next.

    Actions

    • Add Contact To Distribution List

      Adds an existing contact to a distribution list in Whispir.

      Options

      • Workspace ID(drop down menu): Generates a list of the existing Workspaces on Whispir.
      • Distribution List (drop down menu): Generates a list of the Distribution Lists in the selected Workspace. The Distribution List you wish to add the contact to.

      Inputs

      Outputs

      • There are no output fields for this card.
    • Create Contact

      Creates a contact in Whispir.

      Options

      • Workspace ID

      Input Fields

      • Contact
        • First Name* (text): The first name of the contact.
        • Last Name*(text): The last name of the contact.
        • Status(text): Specifies the validity status of the contact. Status can be Active or Disabled.
        • Company Name(text): The compnay the contact belongs to.
        • Job Title(text): Their job title.
        • Division(text): Company division.
        • Business Unit(text): Business Unit.
        • Department(text): Department.
        • Team Name 1(text): What team they belong to
        • Team Name 2(text)
        • Role 1(text): Their Role.
        • Role 2(text)
        • Timezone*(text): Timezone
      • Work Information
        • Email 1*(text): Contact’s email.
        • Email 2(text)
        • Mobile Phone 1*(text): Mobile Phone
        • Mobile Phone 2(text)
        • Phone Area Code 1(text): Area Code for first phone number
        • Phone 1(text): Phone Number.
        • Phone Area Code 2(text): Area code for second phone number.
        • Phone 2(text): Phone number two.
        • Fax Area Code 1(text): Fax area code.
        • Fax 1(text): Fax number.
        • Satellite Phone(text)
        • Other Phone(text)
      • Work Address
        • Address Line 1(text): Street Address for work.
        • Address Line 2(text): Unit number
        • Suburb(text): City
        • State(text): State
        • Post Code(text): Postal code/ Zip code
        • Country* (text): Country.
        • Postal Address Line 1(text): Postal street address.
        • Postal Address Line 2(text): Postal unit number.
        • Postal Suburb(text): City
        • Postal State(text): State
        • Postal Post Code(text): Postal code/ Zip code
        • Postal Country(text): Country
      • Personal Information
        • Email 1(text): personal email
        • Email 2(text)
        • Phone 1(text) personal phone
        • Phone Area Code 2(text)
        • Phone 2(text)
        • Fax Area Code 1(text)
        • Fax 1(text)
        • Other Phone Area Code(text)
        • Other Phone 1(text)
        • Other Mobile(text)
      • Personal Address
        • Address Line 1(text): Home street address
        • Address Line 2(text): Unit number
        • Suburb(text): City
        • State(text): State
        • Country(text): Country
        • Post Code(text): Postal code/ Zip code
      • Alias
        • Other First Name(text) Alias first name.
        • Other Last Name(text) Alias last name.
        • Other Title(text) Alternate title.
      • Other Fields
        • Username(text): Contact username
        • Password(text): Contact password
        • Secret Question(text): Sign-in secret question
        • Secret Answer(text): Answer to question above.

      *required fields

      Output Fields

      • Contact
        • Contact MRI(text): MRI (Message Resource Identifier) is the unique Whispir address for the Contact, User or Distribution List.
        • Contact ID(text): The ID for the contact. Also found in the URL of the contact.
    • Create Distribution List

      Creates a distribution list in Whispir.

      Options

      • Workspace ID(drop down menu): The Workspaces you have in Whispir. Choose the Workspace you wish to create the distribution list in.

      Input Fields

      • List
        • Name* (text): Name of the distribution list.
        • Description* (text): Description of the distribution list.
        • Access* (text): options: Open, ByApproval, Restricted
        • Visibility* (text):options: Public, Private
        • Contact IDs (text): The IDs of the contacts you want on the distribution list. Contact IDs can be found in the URL of the contact or by using ‘Search Contacts’. If multiple contact ids, it must be a comma-separated list.
        • User IDs (text): Comma-separated list of user IDs who have access to the distribution list.
        • Nested List IDs (text): Comma-separated list of Distribution List IDs which can be nested distribution list to this D.

      Outputs

      • List ID(text): The ID for the list.
      • List MRI(text): MRI (Message Resource Identifier) is the unique Whispir address for the Contact, User or Distribution List.
    • Delete Contact

      Deletes a contact in Whispir.

      Options

      • Workspace ID(drop down menu): The Workspaces you have in Whispir. Choose the Workspace you wish to delete the contact from.

      Input Fields

      • Contact
        • Contact ID (text): The IDs of the contact you wish to delete. Contact IDs can be found in the URL of the contact or by using ‘Search Contacts’.

      Outputs

      • There are no output fields for this card.
    • Read Contact

      Gets information for an existing contact in Whispir.

      Options

      • Workspace ID

      Input Fields

      • Read By
        • Contact ID (text): The ID of the contact you are reading. Can be found in the URL of the contact or by using ‘Search Contacts’.

      Output Fields

      • Contact
        • First Name* (text): The first name of the contact.
        • Last Name*(text): The last name of the contact.
        • Status(text): Specifies the validity status of the contact. Status can be Active or Disabled.
        • Company Name(text): The compnay the contact belongs to.
        • Job Title(text): Their job title.
        • Division(text): Company division.
        • Business Unit(text): Business Unit.
        • Department(text): Department.
        • Team Name 1(text): What team they belong to
        • Team Name 2(text)
        • Role 1(text): Their Role.
        • Role 2(text)
        • Timezone*(text): Timezone
      • Work Information
        • Email 1*(text): Contact’s email.
        • Email 2(text)
        • Mobile Phone 1*(text): Mobile Phone
        • Mobile Phone 2(text)
        • Phone Area Code 1(text): Area Code for first phone number
        • Phone 1(text): Phone Number.
        • Phone Area Code 2(text): Area code for second phone number.
        • Phone 2(text): Phone number two.
        • Fax Area Code 1(text): Fax area code.
        • Fax 1(text): Fax number.
        • Satellite Phone(text)
        • Other Phone(text)
      • Work Address
        • Address Line 1(text): Street Address for work.
        • Address Line 2(text): Unit number
        • Suburb(text): City
        • State(text): State
        • Post Code(text): Postal code/ Zip code
        • Country* (text): Country.
        • Postal Address Line 1(text): Postal street address.
        • Postal Address Line 2(text): Postal unit number.
        • Postal Suburb(text): City
        • Postal State(text): State
        • Postal Post Code(text): Postal code/ Zip code
        • Postal Country(text): Country
      • Personal Information
        • Email 1(text): personal email
        • Email 2(text)
        • Phone 1_(text) _personal phone
        • Phone Area Code 2(text)
        • Phone 2(text)
        • Fax Area Code 1(text)
        • Fax 1(text)
        • Other Phone Area Code(text)
        • Other Phone 1(text)
        • Other Mobile(text)
      • Personal Address
        • Address Line 1(text): Home street address
        • Address Line 2(text): Unit number
        • Suburb(text): City
        • State(text): State
        • Country(text): Country
        • Post Code(text): Postal code/ Zip code
      • Alias
        • Other First Name_(text) _Alias first name.
        • Other Last Name_(text) _Alias last name.
        • Other Title_(text) _Alternate title.
      • Other Fields
        • Username(text): Contact username
        • Password(text): Contact password
        • Secret Question(text): Sign-in secret question
        • Secret Answer(text): Answer to question above.
    • Remove Contact from Distribution List

      Removes a contact from a specified distribution list in Whispir.

      Options

      • Workspace ID (drop down menu): Choose which existing workplace the distribution list is in.
      • Distribution List (drop down menu): Choose from the distribution lists in the selected Workplace.

      Input Fields

      • Contact 
        • **Contact ID ** (text): The contact ID for the contact you wish to remove. Contact IDs are found in the URL of the contact, or you can find it by using ‘Search Contacts’.

      Outputs

      • There are no output fields for this card.
    • Search Contacts

      Searches for a contact in Whispir, returns the Contact ID.

      Options

      • Workspace ID (drop down menu): The workspace the contact is in.

      Input Fields

      Every field you enter will be used in the search, but no specific field is required.

      • Contact
        • MRI (text): MRI (Message Resource Identifier) is the unique Whispir address for the Contact, User or Distribution List.
        • First Name (text): The first name of the contact.
        • Last Name(text): The last name of the contact.
        • Status(text): Specifies the validity status of the contact. Status can be Active or Disabled.
        • Company Name(text): The compnay the contact belongs to.
        • Job Title(text): Their job title.
        • Division(text): Company division.
        • Business Unit(text): Business Unit.
        • Department(text): Department.
        • Team Name 1(text): What team they belong to
        • Team Name 2(text)
        • Role 1(text): Their Role.
        • Role 2(text)
        • Timezone(text): Timezone
      • Work Information
        • Email 1(text): Contact’s email.
        • Email 2(text)
        • Mobile Phone 1 (text): Mobile Phone
        • Mobile Phone 2(text)
        • Phone Area Code 1(text): Area Code for first phone number
        • Phone 1(text): Phone Number.
        • Phone Area Code 2(text): Area code for second phone number.
        • Phone 2(text): Phone number two.
        • Fax Area Code 1(text): Fax area code.
        • Fax 1(text): Fax number.
        • Satellite Phone(text)
        • Other Phone(text)
      • Work Address
        • Address Line 1(text): Street Address for work.
        • Address Line 2(text): Unit number
        • Suburb(text): City
        • State(text): State
        • Post Code(text): Postal code/ Zip code
        • Country (text): Country.
        • Postal Address Line 1(text): Postal street address.
        • Postal Address Line 2(text): Postal unit number.
        • Postal Suburb(text): City
        • Postal State(text): State
        • Postal Post Code(text): Postal code/ Zip code
        • Postal Country(text): Country
      • Personal Information
        • Email 1(text): personal email
        • Email 2(text)
        • Phone 1_(text) _personal phone
        • Phone Area Code 2(text)
        • Phone 2(text)
        • Fax Area Code 1(text)
        • Fax 1(text)
        • Other Phone Area Code(text)
        • Other Phone 1(text)
        • Other Mobile(text)
      • Personal Address
        • Address Line 1(text): Home street address
        • Address Line 2(text): Unit number
        • Suburb(text): City
        • State(text): State
        • Country(text): Country
        • Post Code(text): Postal code/ Zip code
      • Alias
        • Other First Name_(text) _Alias first name.
        • Other Last Name_(text) _Alias last name.
        • Other Title_(text) _Alternate title.
      • Other Fields
        • Username(text): Contact username
        • Password(text): Contact password
        • Secret Question(text): Sign-in secret question
        • Secret Answer(text): Answer to question above.

       

      Output Fields

      • Contact
        • Contact ID(text): The ID for the contact. Also found in the URL of the contact.
    • Search Distribution Lists

      Uses the distribution list name to search and return the List ID and MRI.

      Options

      • Workspace ID (drop down menu): Automatically generated list of the existing Workspaces. Select the workspace containing the distribution list you are searching for.

      Input Field

      • List
        • Name (text): The name of the distribution list.

      Output Fields

      • Result
        • List ID(text): The ID for the list.
        • List MRI(text): MRI (Message Resource Identifier) is the unique Whispir address for the Contact, User or Distribution List.
    • Send Email Message

      Sends an email from Whispir.

      Options

      • Email Type (drop down menu): HTML or Plain Text. The type of text content the email will have.
      • Workspace ID (drop down menu): The Workspace you wish to use.

      Input Fields

      • Message
        • To (text): The email of the recipient.
        • Subject(text): The subject of the email.
      • Email
        • Body(text): The text/ body of the email.
        • Footer(text): A footer; a signature.

      Output Fields

      • There are no output fields for this card. 
    • Send SMS Message

      Sends an SMS from Whispir.

      Options

      • Workspace ID (drop down menu): The Workspace you wish to use.

      Input Fields

      • Message
        • To (text): The number of the recipient (ie 2065551234).
        • Subject(text): The subject of the message.
        • Body(text): The text/ body of the message. Note: maximum of 1600 characters.

      Output Fields

      • There are no output fields for this card. 
    • Send Templated Message

      Sends a message in Whispir using a template.

      Options

      • Workspace ID (drop down menu): The Workspace you wish to use.
      • Template(drop down menu): A list of existing templates.

      Input Fields

      • Message
        • To (text): to an individual using a phone number, email or MRI; or to a distribution list using the MRI.

      Output Fields

      • There are no output fields for this card. 
    • Send Voice Message

      Sends a voice message in Whispir.

      Options

      • Workspace ID (drop down menu): The Workspace you wish to use.

      Input Fields

      • Message
        • To (text): The recipient; phone number (ie 2065551234), MRI, or email.
        • Subject(text): The subject of the message.
      • Voice
        • Introduction (text): The header of the voice content. The text to speech content of the introduction message for the voice call.
        • Body(text): The text to speech content of the body message for the voice call.

      Output Fields

      • There are no output fields for this card. 
    • Update Contact

      Update Contact

      Updates contact information in Whispir based on Contact ID.

      Options

      • Workspace ID (dropdown list): Select the workspace the contact is in from a dropdown list.

      Input Fields

      The Contact ID is required to determine which contact you’re updating info for. The only information that you need to input after that is whatever info you’re trying to update for the current contact.

      • Update By
        • Contact MRI (text): the unique Whispir address for the Contact
        • Contact ID (text) REQUIRED: the unique identifier in Eloqua of the record that was created
      • Contact
        • First Name (text): the first name of the contact
        • Last Name (text): the last name of the contact
        • Status _(text_): status of the contact, either Active or Disabled (IMPORTANT: use “A” or “D”)
        • Company Name (text): the company name of the contact
        • Job Title (text): the job title of the contact
        • Division (text): the division of the contact
        • Business Unit (text): the business unit of the contact
        • Department (text): the department of the contact
        • Team Name 1 (text): the team name of the contact
        • Team Name 2 (text): the second team name of the contact
        • Role 1 (text): the role of the contact
        • Role 2 (text): the second role of the contact
        • Timezone (text): the timezone the contact resides in
      • Work Information
        • Email 1 (text): the work email of the contact
        • Email 2 (text): the secondary work email of the contact
        • Mobile Phone 1 (text): the work mobile phone number of the contact
        • Mobile Phone 2 (text): the secondary work mobile phone number of the contact
        • Phone Area Code 1 (text): the phone area code of the contact
        • Phone 1 (text): the phone number of the contact
        • Phone Area Code 2 (text): the secondary phone area code of the contact
        • Phone 2 (text): the secondary phone number of the contact
        • Fax Area Code 1 (text): the fax area code of the contact
        • Fax 1 (text): the fax number of the contact
        • Satellite Phone (text): the satellite phone of the contact
        • Other Phone (text): another phone number of the contact
      • Work Address
        • Address Line 1 (text): the first line of the work address of the contact
        • Address Line 2 (text): the second line of the work address of the contact
        • Suburb (text): the suburb of the work address of the contact
        • State (text): the state of the work address of the contact
        • Post Code (text): the post code of the work address of the contact
        • Country (text): the country of the work address of the contact
        • Postal Address Line 1 (text): the first line of the postal address of the contact
        • Postal Address Line 2 (text): the second line of the postal address of the contact
        • Postal Suburb (text): the the suburb of the postal address of the contact
        • Postal State (text): the state of the postal address of the contact
        • Postal Post Code (text): the post code of the postal address of the contact
        • Postal Country (text): the country of the postal address of the contact
      • Personal Information
        • Email 1 (text): the personal email of the contact
        • Email 2 (text): the secondary personal email of the contact
        • Mobile Phone 1 (text): the personal mobile phone number of the contact
        • Mobile Phone 2 (text): the secondary personal mobile phone number of the contact
        • Phone 1 (text): the personal phone number of the contact
        • Phone Area Code 2 (text): the secondary personal phone area code of the contact
        • Phone 2 (text): the secondary personal phone number of the contact
        • Fax Area Code 1 (text): the personal fax area code of the contact
        • Fax 1 (text): the personal fax number of the contact
        • Other Phone Area Code 1 (text): another personal phone number’s area code of the contact
        • Other Phone (text): another phone number of the contact
        • Other Mobile (text): another personal mobile number of the contact
      • Personal Address
        • Address Line 1 (text): the first line of the personal address of the contact
        • Address Line 2 (text): the second line of the personal address of the contact
        • Suburb (text): the suburb of the personal address of the contact
        • State (text): the state of the personal address of the contact
        • Country (text): the country of the personal address of the contact
        • Post Code (text): the post code of the personal address of the contact
      • Alias
        • Other First Name (text): alternative first name of the contact
        • Other Last Name (text): alternative last name of the contact
        • Other Title (text): alternative title of the contact
      • Other Fields
        • Username (text): username of the contact
        • Password (text): password of the contact
        • Secret Question (text): contact’s secret question
        • Secret Answer (text): contact’s secret answer
      • Custom Fields
        • Dynamically Generated Fields: Any custom fields in your Whispir workspace will be available to update