Locate a video from your Telegram chat
When you cannot remember where a draft is, request the HeyGen video list in Telegram and ask Notis to surface the relevant entry.
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
List videos
Retrieves a list of videos associated with the user's account on the heygen platform. this endpoint is crucial for content management, allowing users to view and organize their video library efficiently. it provides an overview of all videos created or managed through the heygen service, including ai-generated videos with custom avatars. use this endpoint when you need to display a comprehensive list of videos, manage content, or track video creation progress. the response likely includes metadata for each video such as title, creation date, duration, and status. note that this endpoint does not provide the actual video content or detailed analytics; it's primarily for listing and basic information retrieval.
Why this helps
Finding a video among drafts and completed exports can take longer than the check you intended to make.
- Locate video entries using a chat request.
- Reduce time spent searching across workspaces.
- Bring video follow-up back into your current conversation.
Setup
Build it in a few focused steps.
- 1Connect Telegram and HeyGen to Notis once through the portal.
- 2Create the automation in the portal or ask Notis to retrieve HeyGen videos on request.
- 3Write one instruction explaining how Notis should use the request to narrow and summarize the returned video list.
- 4Choose Telegram New Message Received as the trigger and select a run-report channel.
- 5Test with a request for a known draft and confirm the returned entry.
Questions about this workflow
Does this return the video file itself?
No. The action lists video entries and metadata, not the actual video content.
Can it locate a specific draft?
The instruction can ask Notis to identify a relevant entry from the returned list based on details in your message.
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.