September 15, 2020

Telegram campaigns

This article describes how to create a Telegram campaign using various advanced options.

Things to know before starting

  • Recipients must already be subscribed to the Telegram bot and be on the contact list to receive messages.
  • Target contact counts include only recipients who have explicitly given permission to receive notifications.
  • Clear and concise campaign names are recommended to simplify future searches.
  • The selection of available channels depends on the current tariff plan.
  • The default contact list is automatically pre-selected during campaign creation.
  • Selecting the same segment for both delivery and exclusion results in a "Failed" status, and the campaign will not be sent.
  • Campaigns with "Running" or "Done" statuses cannot be stopped or edited.
  • Copied campaigns are automatically saved with a "Draft" status.
  • Advanced settings contain sending details specific to the selected contact list.
  • Scheduled and recurring launches support delivery according to the recipient's time zone via the {{contactTimezone}} variable. If this data is missing, the account's time zone is used.
  • Scheduling campaigns at least 24 hours in advance is strongly advised to ensure delivery across all time zones.
  • A maximum of 3 tags can be added per campaign.

Step-by-step instructions

  • Navigate to the "Outbound" section.

  • Click the "Campaigns" button.

  • Click the "Create" button.

  • Specify campaign title and select target contact list.

  • Select the segment if necessary. Campaigns are sent only to contacts that match the segment rules.

  • Use "Add filter" to create one-time segments for a specific campaign. These conditions are not saved in the general segment list. Filtering rules can be modified via the "Edit" button or removed using the "Bin" icon.

  • Exclude specific segments to prevent delivery to certain contact groups. One-time exclusion filters can also be applied here.

  • Select the Telegram channel, then choose the preferred template and the specific Telegram Bot from the dropdown menus.

  • Use the preview on the right to see how the template will appear on the recipient's device.

  • Open "Advanced settings" to manage tags for better organization of analytics reports (optional).

  • Proceed to the "Next step" button, then select the campaign launch type.

  • Review detailed campaign information in the summary table before the final launch.

  • Click the “Launch campaign” button.

Advanced settings

This section describes advanced settings that can be modified for a specific campaign. These changes apply only to the specific campaign.

  • Advanced settings list
    Icon caret
    • Tags

Launch Type

Manual - campaigns are created with a "Ready" status and require manual activation from the management page to begin sending.

Now - the campaign is sent immediately upon clicking the “Launch Campaign” button. It is assigned a “Running” status as the delivery process starts instantly.

Scheduled - campaigns are delayed and created with a “Waiting” status, triggering at the predefined date and time. This launch type supports delivery based on the recipient’s local time zone.

Recurring - this launch type enables automated campaign repetition via advanced scheduling. Campaigns are created with a “Waiting” status, switching to “Running” during delivery and returning to “Waiting” for the next scheduled cycle until completion. Supports delivery based on the recipient’s local time zone.

  • Configuration parameters
    Icon caret
    • Start & Frequency: Сampaigns trigger at a specified date and time and repeat daily, weekly, or monthly (including options for the first/last day or specific dates).
    • Monthly Scheduling Note: If the selected dates (29th–31st) are missing in a particular month, delivery for that period is skipped.
    • Termination Rules: Сampaigns can be set to repeat indefinitely, stop on a specified date, or end after a fixed number of iterations.
  • Details
    Icon caret
    • Channel - type of the campaign channel.
    • Campaign name - campaign title.
    • Template - name of the template (click to redirect to editor).
    • Telegram bot - name of the selected bot used for delivery.
    • Tags - list of assigned campaign tags.
    • Contact list - name of the target contact list.
    • Segments (Send to/Exclude) - filters for targeting or excluding specific contact groups.
    • Target contacts count - total number of recipients (includes a "refresh" button for recalculation).
    • Time zone - account time zone or recipient’s local time if enabled in settings.
    • Launch time - summary of start date/time, launch type, repeat frequency, and end date.