How to Include Variables in a Mass Campaign

1. Include Variables in the Flow

  1. Create a new flow or access an existing flow where you want to include the variables.
  2. Go to the specific step where you want to include the variables and write it using the following syntax: {{.start.<<variable_name>>.value}}.
  3. Replace <<variable_name>> with the actual name of the variable you wish to send. For example:
    • {{.start.name.value}} if you want to send the recipient’s name.
    • {{.start.link.value}} if you are sending a link .
    • {{.start.user_id.value}} if you are sending a user ID.
    • Any other variable that you need for your campaign.
  4. Once the variable is included, it will automatically replace with @start.«variable_name».value as shown in the gif.
  5. Save and publish the flow.
    add_var_in_flow

2. Create a New Campaign

  1. If there is no outbound message, create one by following the Outbound Message guide.
  2. In the campaign section, create a new campaign.
  3. Choose the outbound and the campaign flow.
    create_new_campaign

3. Download the Campaign Guide Excel and Add Flow Variables

  1. Download the campaign guide Excel file. By default, the file will include only two standard columns: Country code and Phone number.

    campaign_excel_file

  2. Add columns for any new variables that were included in the flow. Make sure to name these columns exactly as they appear in the flow.

    • For example: For the variable {{.start.link.value}}, the corresponding column in the Excel file should be named link.
      add_columns
  3. Fill in the default fields and the variables values:

    • Country code (default): The international dialing code for the recipient’s country.
    • Phone number (default): The recipient’s phone number.
    • Populate the columns for any additional variables you’ve added to the flow.
      fill_fields

4. Associate Variables, and Send the Campaign

  1. Ensure that the Excel file is fully completed with all required fields and values. Then, upload the Excel file to the platform.

  2. Manually associate the new variable (e.g., link) by following these steps:

    • Click on “select field”.
    • Click on “add variable”.
    • Name the variable the same as it was named in the flow, e.g., link for {{.start.link.value}}.
    • Associate the newly created variable.
  3. Once the setup is complete, send the campaign.

    send_campaign

  4. The recipient will receive the message with the variable (e.g., the link) as part of the flow.

    received_message