Check video progress in the chat you already use
When you are waiting on a render, ask in Telegram and have Notis fetch the current HeyGen status for the identified video.
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
Retrieve video status
Retrieves the current status of a video in the heygen platform. this endpoint is used to check the progress of video processing, particularly useful for avatar videos that may require time to generate. it provides real-time information on whether the video is still being processed or has been completed. use this endpoint to monitor the state of your video creation requests and determine when a video is ready for further actions or viewing. the status returned can help in managing user expectations and workflow sequencing in applications integrating heygen's video generation capabilities.
Why this helps
Repeated dashboard checks interrupt other work and make it harder to return to the task at hand.
- Check status without switching to a separate dashboard.
- Make waiting tasks easier to revisit.
- Get a current processing state when you ask.
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 to check video status when requested.
- 3Describe in one instruction how to identify the HeyGen video from a message and report its current status.
- 4Choose Telegram New Message Received as the trigger and select where run reports should go.
- 5Test with a known video ID and compare the returned status with HeyGen.
Questions about this workflow
Does this create a video?
No. It retrieves the status of a known video.
What should I include in the request?
Include enough information for Notis to identify the specific HeyGen video, such as its ID.
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.