Move opted-in Telegram prospects into video projects
When someone requests a personalized video, capture their details in chat and add them to the right existing HeyGen project.
Trigger
New Message Received
Triggered when your bot receives a new message in a private chat, group, or supergroup. To receive every message in a group, Privacy Mode must be disabled for the bot in BotFather.
Action
Add contact to personalized video project
This endpoint allows you to add one or more contacts to a specific personalized video project in the heygen platform. it is used when you need to associate individual contact information with a project, likely for the purpose of creating tailored video content for each contact. the endpoint accepts a project identifier and a list of contacts, each with a first name and email address. this tool is essential for populating your project with recipient data, enabling the creation of personalized videos at scale. note that this endpoint only adds contacts to a project; it does not initiate video creation or sending. ensure that your project id is valid and that all contact information is accurate to avoid errors in video personalization or delivery.
Why this helps
Promising follow-up can stall when contact details need to be copied into a separate video project.
- Keep opt-in requests connected to the follow-up process.
- Reduce repeated copying of contact information.
- Make personalized outreach easier to start.
Setup
Build it in a few focused steps.
- 1Connect Telegram and HeyGen to Notis once through the portal.
- 2Create an automation in the portal or tell Notis how to handle explicit video requests.
- 3Write one instruction that describes how to identify the person's consent, contact details, and intended existing HeyGen project.
- 4Choose Telegram New Message Received as the trigger and select a channel for run reports.
- 5Test with a consenting contact and confirm they appear in the intended HeyGen project.
Questions about this workflow
Does adding a contact create or send a video?
No. This action adds contact information to an existing personalized video project; it does not generate or send a video.
Should I add people without asking?
Describe the workflow for people who have explicitly requested or agreed to receive a personalized video.
When this happens · Trigger
Do this · Action
Supported Triggers and Actions
Notis builds workflows that link Telegram to Heygen. A trigger fires from one place; an action lands in another.
Telegram triggers
Heygen actions
Recurring trigger
Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.
Add new asset
Creates a new asset in the heygen platform. this endpoint allows users to add various types of assets that can be used in video generation, such as avatars, backgrounds, or other content elements. the asset is created by sending plain text data, which likely includes necessary metadata or configuration information. this tool should be used when integrating new assets into the heygen ecosystem for use in content creation workflows. it's important to note that this endpoint may not support direct file uploads; instead, it might expect references to pre-uploaded files or configuration data for asset creation.
Webhook trigger
Notis starts this workflow when an external tool or custom backend sends an HTTP request.
Add contact to personalized video project
This endpoint allows you to add one or more contacts to a specific personalized video project in the heygen platform. it is used when you need to associate individual contact information with a project, likely for the purpose of creating tailored video content for each contact. the endpoint accepts a project identifier and a list of contacts, each with a first name and email address. this tool is essential for populating your project with recipient data, enabling the creation of personalized videos at scale. note that this endpoint only adds contacts to a project; it does not initiate video creation or sending. ensure that your project id is valid and that all contact information is accurate to avoid errors in video personalization or delivery.
New Message Received
Triggered when your bot receives a new message in a private chat, group, or supergroup. To receive every message in a group, Privacy Mode must be disabled for the bot in BotFather.
Retrieve audience video details
Retrieves detailed information about the audience for personalized videos. this endpoint provides insights into the target audience characteristics, preferences, and engagement metrics for heygen's ai-generated personalized video content. it can be used to gain a deeper understanding of the audience demographics, behavior patterns, and content preferences to optimize video creation and targeting strategies. the tool is particularly useful for content creators, marketers, and businesses looking to tailor their video content to specific audience segments using heygen's ai capabilities.
New Channel Post
Triggered when a new post is published to a channel where your bot is an administrator.
Fetch personalized video project detail
Retrieves detailed information about a specific personalized video project in the heygen platform. this endpoint allows you to fetch comprehensive data about a project, including its current status, configuration settings, and any other relevant metadata. use this when you need to get an up-to-date overview of a particular video project, such as checking its progress, reviewing its settings, or gathering information for reporting purposes. the endpoint is read-only and does not modify any project data. note that it may not include the actual video content itself, but rather focuses on the project's attributes and status.
Callback Query Received
Triggered when a user taps an inline keyboard button attached to one of your bot's messages.
Post talking photo binary image
Creates a talking photo by processing an uploaded image file. this endpoint enables users to transform static images into interactive, speaking visual content using heygen's advanced ai technology. it accepts jpeg or png image files and likely combines them with audio narration (though audio input is not specified in this schema). use this endpoint when you want to generate engaging, personalized content from still images, such as creating speaking avatars or animated photographs. the endpoint is particularly useful for marketing materials, educational content, or personalized messages. note that while image upload is specified, the method for providing or generating the associated audio is not detailed in this schema.
Message Edited
Triggered when a message in a chat your bot can see is edited by its sender.
List streaming avatars
Retrieves a list of available avatars for streaming purposes in the heygen platform. this endpoint allows developers to access the collection of realistic avatars that can be used for creating professional-looking videos with ai-generated content. it's designed to support applications requiring dynamic or live video content, enabling real-time access to the avatar library. the endpoint should be used when you need to fetch the current set of available avatars for integration into streaming or video generation workflows. it may not provide detailed information about each avatar's capabilities or customization options, focusing instead on delivering a quick, up-to-date list for immediate use in streaming contexts.
New Chat Member
Triggered when a new member joins a group or supergroup the bot belongs to, including when the bot itself is added.
Create streaming token with expiry
Creates a new streaming token for use with heygen's real-time avatar and voice chat services. this endpoint generates a unique, time-limited token that authenticates and authorizes access to heygen's streaming capabilities. use this endpoint when initiating a new streaming session or when the previous token has expired. the generated token is typically for one-time use and should be obtained shortly before starting a streaming interaction. note that this endpoint does not initiate the streaming itself; it only provides the necessary credentials for subsequent streaming api calls.
Post streaming ice candidates
This endpoint is used to submit ice (interactive connectivity establishment) candidate information for a specific streaming session in the heygen platform. it plays a crucial role in establishing and managing peer-to-peer connections for real-time communication and streaming of avatar content. the endpoint should be called when new ice candidates are discovered during the connection setup process, typically as part of the webrtc negotiation. it's essential for ensuring optimal connectivity between clients, especially in scenarios involving nat traversal or complex network environments. this endpoint does not return the status of the connection or initiate the streaming itself; it only submits candidate information to be used in the connection process.
Connect any two apps with Notis in the middle.
Telegram and Heygen, or any other combination from 1,000+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7-day trial of any paid plan, with 20$ of usage included.
No card. Works with personal or business Heygen.