Tools · Podcast and Videos

The Podcast and Videos modules through the assistant: creating shows and picking presenters, creating episodes by sending the audio or the video by link or file, publishing or scheduling knowing first how many people get the e-mail, transcribing, seeing the numbers and, for listeners, saving the point, reacting, commenting and organizing the queue.

Each tool carries a badge: Read-only changes nothing, Changes creates or changes something right away, and Asks to confirm only acts after your yes to a summary. See Money and confirmation.

#In short

The space is created with create_space and module: "podcast" or "videos", with mode single (one show) or multi (several). A presenter is the member or moderator picked for a show: the episode tools show up for every role, and Memberfy refuses whoever isn't the owner, an admin or a presenter of that show. Team, for the numbers, means owner, admin, moderator and finance.

Files. The audio (MP3, M4A or AAC, up to 500 MB; WAV is refused) and the video (MP4, WebM or MOV, up to 4 GB) go by public link (audio_file_url, video_file_url), which Memberfy downloads and keeps in a private area, or in base64 up to about 7 MB (audio_file_base64 with audio_file_type, video_file_base64). Covers go by cover_image_url or cover_image_base64. An episode has audio or video, never both. A WAV is refused with an error pointing at the mimeType field. The confirmation summaries of delete_episode, unpublish_episode and remove_show_presenter carry the show's name in show_title, so you can check it before saying yes.

#list_shows

Read-only

The shows in a space, with cover, presenters and how many episodes each one has. Minimum role: anyone who sees the space.

Ask like this: "What shows are in the Audio space?"

#get_show

Read-only

One show, with description, category, language, author, presenters and whether it transcribes every episode. Minimum role: anyone who sees the space.

#create_show

Changes

Create a show. Minimum role: admin.

Ask like this: "In the Audio space, create the show Community Talk, in English, Business category, with Maria as presenter."

#update_show

Changes

Edit the show. The same fields as create_show (except space and presenter_ids), plus remove_cover. Only what you send changes. Minimum role: admin.

#delete_show

Asks to confirm

Delete the show, with its episodes, comments and numbers. The summary says how many episodes go. Minimum role: admin.

#add_show_presenter

Changes

Make someone a presenter. They start creating, editing, publishing and transcribing this show's episodes, and only this show's, and seeing the numbers. Minimum role: admin.

#remove_show_presenter

Asks to confirm

Remove someone from the presenters. What they published stays. Parameters: show_id and member_id. Minimum role: admin.

#get_show_stats

Read-only

The show's numbers, in total and per episode: plays (from 30 seconds), unique people, how many reached 90% and the average completion. Minimum role: the show's presenter or team.

Ask like this: "Which Community Talk episode was listened to the most?"

#list_episodes

Read-only

A show's episodes. Whoever doesn't manage the show only sees the live ones. Minimum role: anyone who sees the space.

#get_episode

Read-only

One episode, with description, chapters, the point where you stopped, the reactions and, for whoever manages, the transcript's state. Accepts the id or the app link (including the one in the notice e-mail). Minimum role: whoever can listen to it.

#create_episode

Changes

Create an episode, as a draft. Minimum role: the show's presenter or admin.

Then, publish_episode.

Ask like this: "Create episode 4 of season 1 of Community Talk with the audio from this link and these chapters."

#update_episode

Changes

Edit the episode. The fields of create_episode, plus remove_media (removes the audio or the video; a live episode needs one) and remove_cover. chapters: null goes back to reading the chapters from the description. Replacing the file hides the old transcript. Minimum role: the show's presenter or admin.

#delete_episode

Asks to confirm

Delete the episode, with its file, comments and numbers. Minimum role: the show's presenter or admin.

#publish_episode

Changes

Publish or schedule. The episode needs audio or video. When it goes live, whoever can listen to it and left the Podcasts and videos category on gets an e-mail. The assistant first calls it with dry_run and tells you how many people will get it. Minimum role: the show's presenter or admin.

Ask like this: "Schedule episode 4 for Monday at 7 a.m. and tell me first how many people get the e-mail."

#unpublish_episode

Asks to confirm

Unpublish. The episode goes back to draft and disappears for members; comments, reactions and numbers are kept. Minimum role: the show's presenter or admin.

#transcribe_episode

Changes

Ask for the transcript. Uses the plan's AI transcription minutes (the same as Drops). Refused without a file, over 4 hours, with a transcript already in progress or with the month's quota used up. Minimum role: the show's presenter or admin.

#get_episode_transcript

Read-only

The finished transcript. Minimum role: whoever can listen to it.

Ask like this: "Summarize episode 4 from the transcript and list the parts about pricing."

#get_episode_stats

Read-only

An episode's numbers: plays (from 30 seconds), unique people, how many started, how many reached 90%, the average completion and the retention across 20 parts. Minimum role: the show's presenter or team.

#save_episode_progress

Changes

Save where you stopped (position_seconds), to continue on any device. Reaching 90% marks the episode as finished. Minimum role: whoever can listen to it.

#react_to_episode

Changes

React with 🎉 ❤️ 👍 🔥 🙌 😊 or 👏 (one reaction per person; another one replaces the previous), or remove yours with remove: true. Minimum role: whoever can listen to it.

#list_episode_comments

Read-only

The comments, with their replies. Parameters: episode, sort (newest or oldest), page, limit. Minimum role: whoever can listen to it.

#create_episode_comment

Changes

Comment (up to 5,000 characters), or reply to a comment (parent_id, one level), optionally with a video Drop (video_file_url or video_file_base64, up to 500 MB) when the community accepts Drops in comments. Commenting gives the engagement points once per episode. Minimum role: whoever can listen to it.

#update_episode_comment

Changes

Edit your comment. Parameters: episode, comment_id, comment. Only the author.

#delete_episode_comment

Asks to confirm

Delete a comment and its replies. The author, or the owner, the admin and the moderator.

#react_to_episode_comment

Changes

React to a comment, with the same reactions as the episode, or remove yours. Minimum role: whoever can listen to the episode.

#get_my_media_queue

Read-only

Your queue, in order, with the episodes from this community's Podcast and Videos spaces. Any role.

#queue_episode

Changes

Put an episode at the end of the queue. Minimum role: whoever can listen to it.

#unqueue_episode

Changes

Remove an episode from the queue. The episode doesn't change. Any role.

#reorder_my_media_queue

Changes

Reorder the whole queue (episode_ids, up to 200, in the desired order). An episode left out of the list leaves the queue. Any role.

Ask like this: "Put the last three Behind the Scenes episodes at the start of my queue."

#Related

• Podcast
• Videos
• All tools
• Money and confirmation