add_groups_to_list
ChatGPTAdds Facebook groups to an existing saved list, by their links (from search_facebook_groups or links the person gave). Groups already in the list are left as they are. Scheduled posts that go to this list get the new groups too.
add_media_from_url
ChatGPTDownloads a photo or video from a public https link into MultiGroupPoster; returns its media id.
confirm_post
ChatGPTFor a post whose status is needs_confirmation: sends it again with the person's OK to the pre-flight warnings. Only after the person said yes to those warnings.
control_campaign
ChatGPTPauses the post that is going out now (it stops after the current group), resumes a paused one, or stops it for good.
create_post
ChatGPTCreates a MultiGroupPoster post to a saved group list. mode "draft" puts it in MultiGroupPoster for the person to review and press Publish (default, safest). mode "publish_now" sends it right away (the person confirms in this chat first). Runs in the person's Chrome. If Chrome is closed, it waits until Chrome opens.
delete_group_list
ChatGPTDeletes a saved group list (the groups stay on Facebook and in other lists). Ask the person first; call with confirmed: true only after a yes.
delete_scheduled_post
ChatGPTDeletes a scheduled post so it never goes out again. Ask the person first; call with confirmed: true only after a yes.
get_post_status
ChatGPTStatus of a post created with create_post: queued, picked up, draft ready, posting or done, with the result per group and links.
get_started
ChatGPTShows the setup: whether MultiGroupPoster is connected and Chrome is open, the plan, the group lists, recent posts and the suggested next step. Useful at the start of a conversation.
get_upload_link
ChatGPTReturns a one-time web link where the person uploads photos/videos for a post. After uploading, call list_uploaded_media and pass the media ids to create_post.
list_group_lists
ChatGPTThe group lists saved in MultiGroupPoster (name, number of groups). Use a list name when creating a post.
list_pages
ChatGPTThe Facebook profile and Pages MultiGroupPoster can post as, and which one is active now.
list_pending_approvals
ChatGPTRead only. The groups where a post went out in the last 7 days and is waiting for the group admin's approval (posts made in MultiGroupPoster too): the group's name and link, when, and the start of the post. Use it when the person asks which groups are waiting or holding their posts.
list_recent_posts
ChatGPTThe last posts created through the assistant, with their status. Check this before creating a post again after an unclear error, so nothing is posted twice.
list_scheduled_posts
ChatGPTThe scheduled posts saved in MultiGroupPoster: when they go out next (in the person's time zone), how often, the list and the start of the text.
list_templates
ChatGPTThe posts saved as templates in MultiGroupPoster: the name, the start of the text, and what goes with it (photos, versions, comments). Read only.
list_uploaded_media
ChatGPTPhotos and videos uploaded for this account (newest first), with their media ids.
open_post_composer
ChatGPTShows a small MultiGroupPoster card in the chat to add photos/videos, edit the text and pick the group list. Use it when the person wants to attach photos.
remove_failed_groups
ChatGPTThe groups of the last finished post that failed through their own fault (the group refused the post, is paused, gone, or not open to this profile): first call without confirm to see which; after the person says yes, call again with confirm: true and preview_job_id = the first call's job_id. Only the groups shown then are removed. They leave every list and every scheduled post. A post where nothing went through at all removes nothing (that was the account, not the groups).
remove_groups_from_list
ChatGPTRemoves groups from ONE saved list, by name or link. First call without confirm: MultiGroupPoster looks them up in the list and nothing changes; show the person which groups it found (and ask which one when a name matches several). After a yes, call again with confirm: true and preview_job_id = the first call's job_id: exactly the groups shown leave the list. Scheduled posts that go to this list follow it. The groups stay in their other lists.
rename_group_list
ChatGPTGives a saved group list a new name. Its groups and the scheduled posts that use it stay as they are.
save_preferences
ChatGPTRemembers the person's choices so they are not asked again: method (safe/fast), first comment habit, how many groups a day they are used to, background. Saved in this connection; shown pre-selected in every summary.
search_facebook_groups
ChatGPTThe groups read with sync_facebook_groups (name and link), 300 at a time. Optional query keeps names containing any of its words. You decide which groups fit a topic by their names; page through all of them with offset.
show_dashboard
ChatGPTRead only. What went out in the last 7 days (live, waiting for approval, failed), the last post, a post going out now, the next scheduled posts and the saved templates. Show it only when the person asks to see it ("show my dashboard", "how are my posts doing").
sync_facebook_groups
ChatGPTAsks MultiGroupPoster in Chrome to read the list of Facebook groups the person is a member of (the same as its "Sync with Facebook" button). Returns a job_id: follow it with get_post_status, then use search_facebook_groups.
update_schedule
ChatGPTChanges a scheduled post: its time and repeat (schedule), its text (a post with photos keeps its photos; that needs features.schedule_text_with_photos, otherwise it is changed in MultiGroupPoster), or turns an auto-paused schedule back on (enabled: true). A post with versions is changed in MultiGroupPoster. To stop a schedule, delete it (delete_scheduled_post).