accept_message_request
ChatGPTAccept a Messenger message request (chat_id from list_chats with requests: true). A personal Facebook account accepts it as is (the conversation moves to its inbox; reply with send_message). Confirm with the user first, and show them the exact text of any reply.
cancel_scheduled_post
ChatGPTCancel a post from linkedin_schedule_post or instagram_schedule_post that hasn't gone out yet. To change a post, cancel it and schedule the new version.
create_post
ChatGPTPublish a post on one connected account, right away or at publish_at (then it's scheduled: returns a scheduled_post_id for list_scheduled_posts and cancel_scheduled_post). LinkedIn: text ≤3000, one image (optional); link is appended to the text and previewed when there's no image; Instagram (logged in): one photo (required), caption ≤2200; Facebook: text ≤10000, one image (optional); as_page posts as one of the account's Pages, share_post_id shares a post (now only). Threads: text ≤500, up to 10 images or 1 video; TikTok: text ≤2200, up to 35 images or 1 video (required); YouTube: text ≤5000, 1 video (required), a title ≤100; Pinterest: text ≤800, 1 image or 1 video (required), optional title ≤100; Google Business Profile: text ≤1500, 1 image; WordPress: text ≤100000, 1 image, a title ≤200; Instagram Business: text ≤2200, up to 20 images or 1 video (required). TikTok needs privacy_level, allow_comment (and allow_duet, allow_stitch for a video) and user_confirmed: true, meaning the user saw the final caption and media and agreed to publish (TikTok's legal requirement). YouTube needs a video and a title. Pinterest pins to board_id, else the board picked at connect. WordPress: text is the article's HTML. Instagram Business: one image (a feed post), several (a carousel), one video (a Reel), or with story: true a Story. Call post_options first for an account you haven't posted to in this conversation. Media: media_ids from upload_media (files the user has, or one you made), or public https links (image_urls, video_url); for a scheduled post, links must keep working until publish_at, uploads are kept with the post. Public and irreversible: confirm the account, final text, media, audience and time (with the user's time zone) with the user first.
facebook_accept_message_request
ChatGPTAccept a message request (chat_id from facebook_list_message_requests): the conversation moves to the main Messenger inbox and the sender sees it was accepted.
facebook_create_post
ChatGPTPublish a post on the account's Facebook profile, or on one of its Pages with as_page: text, optionally one image as image_url (an https link) or media_id (from upload_image, for an image the user has on their device or attached in the chat). To share an existing post, give share_post_id (text optional, no image). Mention someone with @ followed by their Facebook id or vanity name. Public (or friends-only with visibility relations_only) and irreversible from here: confirm the final text, image, audience and identity (profile or which Page) with the user first.
facebook_follow
ChatGPTFollow a person or Page by Facebook id, to see their public posts without being friends. Counts toward the same daily limit as friend requests. Confirm with the user first.
facebook_get_messages
ChatGPTMessages in one Messenger conversation (personal or a Page's), most recent first. 'from' is 'me' (the account owner, or the Page in a Page's chat) or 'them'. message_id values work with facebook_react. Personal chats are end-to-end encrypted: older messages show only if the user unlocked their history when connecting.
facebook_get_profile
ChatGPTRead a Facebook user profile: name, username, phone when Facebook shares it, bio, followers and picture. Counts as a profile view.
facebook_list_chats
ChatGPTThe Facebook account's own Messenger conversations (1-to-1 and groups), most recent first. Use unread=true to triage. Returns chat_id values for facebook_get_messages / facebook_send_message, and person_id (the contact's Facebook id) for 1-to-1 chats. Not here: the inboxes of the Facebook Pages the account manages (facebook_list_page_chats) and message requests (facebook_list_message_requests). With several Facebook accounts, lists them all merged (each item has its account_id: pass it as account to the other facebook_* tools); account narrows to one.
facebook_list_friend_requests
ChatGPTPending friend requests the account received (default) or sent, with request_id for facebook_answer_friend_request.
facebook_list_friends
ChatGPTThe account's Facebook friends (Facebook shows no one else's), up to 50 a page, with their user_id for get_profile and start_chat. With requests: received or sent, the pending friend requests instead, with request_id for facebook_friend_request.
facebook_list_message_requests
ChatGPTMessenger message requests: conversations started by people the account isn't friends with, waiting to be accepted. chat_id values work with facebook_get_messages and facebook_accept_message_request.
facebook_list_page_chats
ChatGPTMessenger conversations of one of the account's Facebook Pages (people who wrote to the Page), most recent first. Use unread=true to triage. Returns chat_id values (PAGE_<page_id>_…) for facebook_get_messages / facebook_send_message, which then read and answer as the Page. A Page can only answer: it can't start a conversation.
facebook_list_pages
ChatGPTThe Facebook Pages this account manages and that were activated when it connected, with their page_id. Use page_id with facebook_list_page_chats (the Page's inbox), and as as_page on facebook_create_post, facebook_comment and facebook_react_post to act as the Page. A Page missing here was not activated: get a reconnect link (connect_account, provider facebook, mode reconnect); that login offers every Page again.
facebook_list_posts
ChatGPTPosts of a Facebook profile or Page, most recent first: the account's own by default, one of its Pages with its page_id, or anyone else's by Facebook id or vanity name. Facebook returns at most 3 posts a page: use next_cursor for more. Returns post_id for facebook_list_comments, facebook_comment and facebook_react_post.
facebook_mark_read
ChatGPTMarks a Messenger conversation (personal or a Page's) read (or unread).
facebook_react
ChatGPTAdd an emoji reaction to a message (message_id from facebook_get_messages). Any emoji works. For posts and comments use facebook_react_post.
facebook_schedule_post
ChatGPTPublish a post on the account's Facebook profile, or on one of its Pages with as_page, later at publish_at: text, optionally one image as image_url (an https link) or media_id (from upload_image, for an image the user has on their device or attached in the chat). An image_url is checked now and downloaded again at publish time, so the link must keep working until then; an uploaded image (media_id) is kept with the post. Public once it goes out: confirm the final text, image, audience, identity (profile or which Page) and time (with the user's time zone) first. Returns a scheduled_post_id.
facebook_send_friend_request
ChatGPTSend a friend request (Facebook friend requests carry no message). Facebook blocks accounts that send many, so it is limited per day and per week; check inbox_status first. Confirm the exact person with the user before calling this. To follow a person or Page without being friends, use facebook_follow.
facebook_send_message
ChatGPTReply in an existing Messenger conversation. A Page's chat (chat_id PAGE_<page_id>_…, from facebook_list_page_chats) is answered as the Page. Plain text. Show the user the exact text before calling this. One image can go with the text: image_url (an https link) or media_id (from upload_image, for an image the user has on their device or attached in the chat).
facebook_start_chat
ChatGPTSend a Messenger message to a person or Page you have no conversation with yet, by Facebook id (a chat's person_id, a friend's user_id, or from facebook_get_profile). Always as the personal account: a Page can't start conversations. Messages to people who aren't friends land in their message requests, and Facebook restricts accounts that message many strangers: only message people who expect it; at most 10 new conversations a day. Show the user the exact text before calling this. One image can go with the text: image_url (an https link) or media_id (from upload_image, for an image the user has on their device or attached in the chat).
fetch
ChatGPTRead a LinkedIn person:<id> returned by search, or a known chat:<chat_id> returned by linkedin_list_chats. Use search with query keywords to find up to 10 people.
get_attachment
ChatGPTShows you an image someone sent or received in a conversation (chat_id, message_id and attachments[].attachment_id from get_messages, where its type is image), so you can see and describe it. get_messages already shows you a page's most recent images (shown_below: true): use this for the others. Images only (JPEG, PNG, WebP, GIF), at most 3.75 MB; videos, voice notes and documents can't be opened. LinkedIn, WhatsApp, Telegram, Instagram and Facebook; Instagram Business and Facebook Pages messages give the image's link in get_messages instead.
get_insights
ChatGPTHow an account is doing, as its network reports it (Instagram Business, TikTok, YouTube, Pinterest, Google Business Profile, Threads). report: overview (default): the account's figures over the last days (views, reach, engagement, followers… as the network reports them, plus a comparable headline); without account, every analytics account side by side; followers: the follower (YouTube: subscriber) count day by day, with gained and lost; audience: followers by country, city, age and gender, as far as the network reports them; top_posts: the best posts of the last days by sort (engagement by default), with their figures; without account, across every analytics account; timing: when to post, from the account's own posts (best weekday × hour slots in UTC, posts per week vs engagement, how fast posts reach their final engagement; Instagram: when followers are online); inbox: messages received and sent, median time to first reply and the busiest hours; search_keywords: the Google searches that showed the Business Profile, by month; post: one post's figures (post_id from list_posts, top_posts or create_post); details=true adds its day-by-day curve and the network's extras (Facebook earnings, YouTube retention and daily views). Not every network has every report (followers: Instagram Business, TikTok, YouTube, Pinterest; audience: Instagram Business, TikTok, YouTube; inbox: Instagram Business; search_keywords: Google Business Profile). LinkedIn, WhatsApp, Telegram and the personal Instagram and Facebook logins have no insights here. Read-only.
get_messages
ChatGPTMessages in one conversation (chat_id from list_chats), most recent first. 'from' is 'me' (the account owner, or the Page in a Facebook Page's chat) or 'them'; message_id values work with react. The 3 most recent images on the page come with the result for you to see (their attachments say shown_below: true); open any other with get_attachment. Every attachment has a url the user can open or download for 24 hours. Instagram Business: without cursor, reply_window says whether a reply can go out (open, user_written_only or closed). Facebook personal chats are end-to-end encrypted: older messages show only if the user unlocked their history when connecting.
get_profile
ChatGPTRead someone's profile on a connected account's network. LinkedIn: the full profile (headline, experience, education, skills, contact info when shared) by person_id or public identifier (the part after linkedin.com/in/). WhatsApp: a contact's WhatsApp id (a chat's person_id) or phone number with country code; Telegram: user id; Instagram: user id or username; Facebook: id or vanity name of a person or Page, or me. Name, username, phone when the network shares it, bio, followers and picture. Counts as a profile view.
inbox_get_messages
ChatGPTMessages in one conversation, most recent first. 'from' is 'me' (the account owner) or 'them'.
inbox_list_accounts
ChatGPTThe LinkedIn, WhatsApp, Telegram and Instagram accounts this connection can use, with their account_id, provider, name and status. Pass account_id as account to the inbox_ and provider tools (linkedin_, whatsapp_, telegram_, instagram_*) when more than one is connected.
inbox_list_chats
ChatGPTConversations across every connected inbox (LinkedIn, WhatsApp, Telegram, Instagram), merged and sorted most recent first; account or provider narrows it. Use unread=true to triage. Each item has chat_id, its account_id and provider (pass account_id as account to inbox_get_messages / inbox_send_message when several accounts are connected), and person_id for 1-to-1 chats. Accounts that can't be read right now are listed in skipped, with what to do.
inbox_mark_read
ChatGPTMarks a conversation read (or unread), on any connected provider.
inbox_send_message
ChatGPTReply in an existing conversation, on any connected provider. Plain text. Show the user the exact text before calling this.
inbox_start_chat
ChatGPTMessage someone you have no conversation with yet. to: on LinkedIn the person_id (1st-degree connections; for InMail use linkedin_start_chat), on WhatsApp a phone number with country code, on Telegram the user id, on Instagram the user id. New conversations have a low daily limit, especially on WhatsApp, where cold messages get new accounts banned. Show the user the exact text before calling this.
inbox_status
ChatGPTStatus and limits of one connected account, any provider (LinkedIn, WhatsApp, Telegram, Instagram). Call before planning several actions. Says whether the account can act now (blocked_reason), how many actions are left today (messages → _send_message, new_conversations → _start_chat, profile_views → *_get_profile, posts → linkedin_create_post / instagram_create_post; on LinkedIn also searches and invitations), and ready_in_seconds for each. Reading has a high limit and is not listed. Unavailable accounts or access must be managed in Pluggzy.
instagram_create_post
ChatGPTPublish a photo on the account's Instagram feed: image_url is an https link to a JPEG, PNG or WebP (at most 8 MB), text is the caption. Public and irreversible from here: confirm the image and the caption with the user first.
instagram_get_messages
ChatGPTMessages in one Instagram conversation, most recent first. 'from' is 'me' (the account owner) or 'them'. message_id values work with instagram_react.
instagram_get_profile
ChatGPTRead a Instagram user profile: name, username, phone when Instagram shares it, bio, followers and picture. Counts as a profile view.
instagram_list_chats
ChatGPTInstagram direct messages, most recent first. Use unread=true to triage. Returns chat_id values for instagram_get_messages / instagram_send_message, and person_id (the contact's Instagram user id) for 1-to-1 chats. With several Instagram accounts, lists them all merged (each item has its account_id: pass it as account to the other instagram_* tools); account narrows to one.
instagram_list_posts
ChatGPTPosts of an Instagram user, most recent first: the account's own by default, or someone else's with user_id. Returns caption, link, date, likes and comments.
instagram_mark_read
ChatGPTMarks an Instagram conversation read (or unread).
instagram_react
ChatGPTAdd an emoji reaction to a message (message_id from instagram_get_messages). Instagram keeps one reaction per person: a new one replaces yours.
instagram_schedule_post
ChatGPTPublish a photo on the account's Instagram feed later, at publish_at: image_url is an https link to a JPEG, PNG or WebP (at most 8 MB), text is the caption. The image is checked now and downloaded again at publish time, so the link must keep working until then (not a link that expires). Public once it goes out: confirm the image, caption and time (with the user's time zone) first. Returns a scheduled_post_id.
instagram_send_message
ChatGPTReply in an existing Instagram direct conversation. Plain text. Show the user the exact text before calling this.
instagram_start_chat
ChatGPTSend a direct message to an Instagram user you have no conversation with yet, by user id (a chat's person_id, or from instagram_get_profile). Messages to people who don't follow the account land in their message requests, and Instagram restricts accounts that message many strangers: only message people who expect it; at most 10 new conversations a day. Show the user the exact text before calling this.
instagrambusiness_get_insights
ChatGPTHow the Instagram Business account is doing, as Instagram reports it (can lag up to 48 hours). report: overview (default): reach, views, accounts engaged, interactions, likes, comments, saves, shares, follows, profile views and link taps over the last days; followers: the follower count day by day, with followers gained and lost; audience: followers by age, city, country and gender (needs 100+ followers); post: one post's reach, views, likes, comments, shares and saves (post_id from instagrambusiness_list_posts).
instagrambusiness_get_messages
ChatGPTMessages in one Instagram Business conversation, most recent first. 'from' is 'me' (the account) or 'them'. message_id values work with instagrambusiness_react. Without cursor, reply_window says whether a reply can go out: open (24 hours after their last message), user_written_only (up to 7 days: only a reply the user wrote or approved word for word, with user_written: true) or closed. Reading doesn't mark the conversation read: use instagrambusiness_mark_read.
instagrambusiness_list_chats
ChatGPTDirect messages of an Instagram Business or Creator account, most recent first, with chat_id values for instagrambusiness_get_messages and instagrambusiness_send_message. follows_you and followers are known only for people who messaged the account. unread=true keeps the conversations with unread messages from each page, so a page can come back shorter: follow next_cursor for more. This account can only answer people who wrote to it, within Instagram's reply windows (instagrambusiness_get_messages says where a conversation stands); it can't start a conversation.
instagrambusiness_list_posts
ChatGPTThe Instagram Business account's own posts (feed posts, carousels, Reels), most recent first, read live from Instagram: caption, link, date, media type, likes and comments, including posts made outside Pluggzy. At most the 25 most recent. post_id works with instagrambusiness_list_comments, instagrambusiness_comment and instagrambusiness_get_insights (report post).
instagrambusiness_mark_read
ChatGPTMarks an Instagram Business conversation read; the person sees it as seen.
instagrambusiness_private_reply
ChatGPTSend a direct message to the author of a comment on one of the account's posts (the way to answer a commenter who never messaged the account). Instagram allows one per comment, within 7 days of the comment, and a failed try can use it up: show the user the exact text first and don't retry on your own. Their answers arrive in instagrambusiness_list_chats.
instagrambusiness_send_message
ChatGPTReply in an existing Instagram Business conversation (chat_id from instagrambusiness_list_chats). Plain text, optionally one JPEG or PNG image as image_url (an https link) or media_id (from upload_image, for an image the user has on their device or attached in the chat). Instagram allows replies within 24 hours of the person's last message; up to 7 days after it, only a reply the user wrote themselves or approved word for word, sent with user_written: true (never for text you wrote on your own). Show the user the exact text before calling this.
linkedin_create_post
ChatGPTPublish a text post on the account's feed. A link can be appended; LinkedIn builds the preview from the first URL in the text. Public and irreversible from here: confirm the final text with the user first.
linkedin_get_job
ChatGPTProgress and per-item results of a job from linkedin_schedule_outreach.
linkedin_get_messages
ChatGPTMessages in one conversation, most recent first. 'from' is 'me' (the account owner) or 'them'.
linkedin_get_profile
ChatGPTFull profile by person_id or public identifier (the part after linkedin.com/in/). Counts as a profile view on LinkedIn.
linkedin_list_chats
ChatGPTConversations in the LinkedIn inbox, most recent first. Use unread=true to triage. Returns chat_id values for linkedin_get_messages / linkedin_send_message and person_id for 1-to-1 chats. With several LinkedIn accounts, lists them all merged (each item has its account_id: pass it as account to the other linkedin_* tools); account narrows to one.
linkedin_list_invitations
ChatGPTPending invitations you sent or received.
linkedin_mark_read
ChatGPTMarks a conversation read (or unread).
linkedin_schedule_outreach
ChatGPTQueue up to 50 messages or invitations. They are sent one by one with random gaps of a minute or more, respecting daily limits. An invitation's text is its note (max 300 characters, 200 on free LinkedIn accounts). Returns a job_id; poll with linkedin_get_job. Jobs cannot be paused, resumed or canceled. Confirm every exact recipient and final text with the user first.
linkedin_schedule_post
ChatGPTPublish a text post on the account's feed later, at publish_at. A link can be appended; LinkedIn builds the preview from the first URL in the text. Public once it goes out: confirm the final text, audience and time (with the user's time zone) first. Returns a scheduled_post_id.
linkedin_search_people
ChatGPTSearch LinkedIn members by keywords, or paste a LinkedIn people-search URL copied from the browser (keeps all its filters). Each page costs one LinkedIn search. Returns person_id values for other tools.
linkedin_send_invitation
ChatGPTInvite someone to connect, optionally with a note (max 300 characters, 200 on free LinkedIn accounts, which can add a note to about 15 invitations a week). Limited per day and per week, and LinkedIn actions are spaced about a minute apart; check linkedin_status first. Confirm the exact recipient and final note with the user before calling this.
linkedin_send_message
ChatGPTReply in an existing conversation. Plain text. Show the user the exact text before calling this.
linkedin_start_chat
ChatGPTMessage someone you are connected with (1st degree). For others, set inmail=true (needs a LinkedIn premium plan with InMail credits). Get the person_id from linkedin_search_people or linkedin_get_profile. Confirm the exact recipient and final text with the user before calling this.
linkedin_status
ChatGPTCall before planning several LinkedIn actions. Says whether the account can act now (blocked_reason), how many actions are left today (profile_views → linkedin_get_profile, searches → linkedin_search_people, messages → linkedin_send_message, new_conversations → linkedin_start_chat, invitations → linkedin_send_invitation, posts → linkedin_create_post; invitations also have a weekly limit), and ready_in_seconds for each: the wait before that action can run. Reading the inbox has a high limit and is not listed. Unavailable accounts or access must be managed in Pluggzy. For WhatsApp, Telegram and Instagram accounts, use inbox_status.
list_accounts
ChatGPTThe accounts this connection can use (LinkedIn, WhatsApp, Telegram, Instagram, Instagram Business, Facebook Messenger, and publishing accounts), with their account_id, provider, name, status and what each can do (can). Pass account_id as account to any tool when more than one account could do what it does. Start here when you don't know what's connected. instagram is an account connected with its login (all its DMs, starting conversations, profiles); instagrambusiness a Business or Creator account on Instagram's official access (replies within Instagram's windows, comments, insights, posts).
list_chats
ChatGPTConversations across every connected inbox (LinkedIn, WhatsApp, Telegram, Instagram, Instagram Business, Facebook Messenger), merged and sorted most recent first; account or provider narrows it. Use unread=true to triage. Each item has chat_id, its account_id and provider (pass account_id as account to get_messages, send_message and the other conversation tools), and person_id for 1-to-1 chats. Facebook: page_id lists the inbox of one of a personal account's Pages (facebook_list_pages); requests=true the message requests. Accounts that can't be read right now are listed in skipped, with what to do.
list_group_members
ChatGPTMembers of a WhatsApp, Telegram or Facebook group chat (chat_id from list_chats, a group), with their user_id for get_profile and start_chat, and on WhatsApp their phone number.
list_posts
ChatGPTPosts of an account, most recent first, with post_id for list_comments, comment and instagrambusiness_get_insights: caption or text, link, date, likes and comments. Instagram (logged in): the account's own, or anyone's by user_id. Facebook: the account's own, one of its Pages (page_id) or anyone's (id or vanity name); at most 3 a page, follow next_cursor. Instagram Business: the account's own posts, at most the 25 most recent (made outside Pluggzy too).
list_scheduled_posts
ChatGPTPosts scheduled with linkedin_schedule_post or instagram_schedule_post on the accounts this connection can use: when, where, status, and once published the post's URL. Post text isn't kept by Pluggzy, only its length (chars).
mark_read
ChatGPTMarks a conversation read (or unread with read=false), on any network. Reading a conversation doesn't mark it read.
post_options
ChatGPTWhat create_post accepts on one connected account: the network's limits (characters, title, media) and fields, and the account's own choices: TikTok privacy levels and which interactions the creator allows, Pinterest boards and the default one, the WordPress site, YouTube visibilities, Google Business Profile buttons. Call it before composing a post for an account you haven't posted to in this conversation.
private_reply
ChatGPTSend a direct message from the Instagram Business account to the author of a comment on one of its posts (the way to answer a commenter who never messaged the account). One per comment, within 7 days of the comment, and a failed try can use it up: show the user the exact text first and don't retry on your own. Their answers arrive in list_chats.
search
ChatGPTSearch LinkedIn people by keywords. Returns ids usable with fetch.
send_feedback
ChatGPTSend feedback to the Pluggzy team: a bug, an idea, a question or praise. Use when the user asks, or (source assistant) when a Pluggzy tool misbehaves in a way the user can't fix. Say what was tried, what happened, what was expected; no private message content unless the user asks. The team reads it later: no reply comes in this chat.
send_message
ChatGPTReply in an existing conversation (chat_id from list_chats), on any network: 1-to-1, group, or a Facebook Page's chat (answered as the Page). Plain text. Show the user the exact text before calling this. One image can go with the text: image_url (an https link) or media_id (from upload_media, for an image the user has on their device or attached in the chat). Instagram Business allow replies within 24 hours of the person's last message (Instagram: at most 1000 characters, JPEG or PNG); up to 7 days after it, only a reply the user wrote or approved word for word, with user_written: true (never for text you wrote on your own).
social_create_post
ChatGPTPublish right away on one connected social account. Threads: text ≤500, up to 10 images or 1 video; TikTok: text ≤2200, up to 35 images or 1 video (required); YouTube: text ≤5000, 1 video (required), a title ≤100; Pinterest: text ≤800, 1 image or 1 video (required), optional title ≤100; Google Business Profile: text ≤1500, 1 image; WordPress: text ≤100000, 1 image, a title ≤200; Instagram Business: text ≤2200, up to 20 images or 1 video (required). TikTok needs privacy_level, allow_comment (and allow_duet, allow_stitch for a video) and user_confirmed: true, meaning the user saw the final caption and media and agreed to publish (TikTok's legal requirement). YouTube needs a video and a title. Pinterest pins to board_id, else the board picked at connect. WordPress: text is the article's HTML. Instagram Business: one image (a feed post), several (a carousel), one video (a Reel), or with story: true a Story. Call social_post_options first for an account's choices and fields. Media are public https links the network downloads, or media_ids from upload_image. Public and irreversible: confirm the final text and media with the user first.
social_post_options
ChatGPTWhat social_create_post and social_schedule_post accept on one connected social account: the network's limits (characters, title, media), the extra fields it takes, and the account's own choices: TikTok privacy levels and which interactions the creator allows, Pinterest boards and the default one, the WordPress site, YouTube visibilities, Google Business Profile buttons. Call it before composing a post for a network you haven't posted to in this conversation.
social_schedule_post
ChatGPTPublish a post on one connected social account later, at publish_at: Pluggzy's scheduler sends it then. Threads: text ≤500, up to 10 images or 1 video; TikTok: text ≤2200, up to 35 images or 1 video (required); YouTube: text ≤5000, 1 video (required), a title ≤100; Pinterest: text ≤800, 1 image or 1 video (required), optional title ≤100; Google Business Profile: text ≤1500, 1 image; WordPress: text ≤100000, 1 image, a title ≤200; Instagram Business: text ≤2200, up to 20 images or 1 video (required). Same text, title, media and fields as social_create_post (call social_post_options for an account's choices). TikTok needs user_confirmed: true here too: the user saw the final caption and media and agreed to publish. Links must keep working until publish_at; uploads (media_ids from upload_image) are kept with the post. Public once it goes out: confirm the final text, media and time (with the user's time zone) first. Returns a scheduled_post_id.
start_chat
ChatGPTMessage someone you have no conversation with yet. Pick the account (or, with one account per network, the provider). to: LinkedIn: the person_id (from linkedin_search_people or get_profile) of a 1st-degree connection, or anyone with inmail=true (needs Premium InMail credits); WhatsApp: a phone number with its country code, like +33 6 12 34 56 78; Telegram, Instagram and Facebook: the user id (a chat's person_id, a group member's or friend's user_id, or from get_profile). New conversations have low daily limits (WhatsApp 10, Telegram 10, Instagram 10, Facebook 10), and networks restrict accounts that message strangers: WhatsApp bans new accounts after 2–3 cold messages; on Instagram and Facebook, people who don't follow or aren't friends get it as a message request. Only message people who expect it. Confirm the exact recipient and final text with the user before calling this. One image can go with the text: image_url (an https link) or media_id (from upload_media, for an image the user has on their device or attached in the chat).
telegram_get_messages
ChatGPTMessages in one Telegram chat, most recent first. 'from' is 'me' (the account owner) or 'them'. message_id values work with telegram_react.
telegram_get_profile
ChatGPTRead a Telegram user profile: name, username, phone when Telegram shares it, bio, followers and picture. Counts as a profile view.
telegram_list_chats
ChatGPTTelegram chats (private chats and groups), most recent first. Use unread=true to triage. Returns chat_id values for telegram_get_messages / telegram_send_message, and person_id (the contact's Telegram user id) for private chats; for a group's members use telegram_list_group_members. With several Telegram accounts, lists them all merged (each item has its account_id: pass it as account to the other telegram_* tools); account narrows to one.
telegram_list_group_members
ChatGPTMembers of a Telegram group chat (chat_id from telegram_list_chats), with their user_id for telegram_get_profile. Group chats only.
telegram_mark_read
ChatGPTMarks a Telegram chat read (or unread).
telegram_react
ChatGPTAdd an emoji reaction to a message (message_id from telegram_get_messages). Telegram accepts only its standard reaction emojis (👍 ❤️ 🔥 🎉 😁 👏 …); others fail.
telegram_send_message
ChatGPTReply in an existing Telegram chat (private or group). Plain text. Show the user the exact text before calling this.
telegram_start_chat
ChatGPTMessage a Telegram user you have no chat with yet, by numeric user id (a chat's person_id, or a member from telegram_list_group_members). Telegram restricts accounts that message many strangers, so only message people who expect it; at most 10 new chats a day. Show the user the exact text before calling this.
upload_image
ChatGPTReturns a link where the user uploads an image or a video from their device, and the media_id to pass to a post tool (linkedin_create_post, linkedin_schedule_post, instagram_create_post, instagram_schedule_post, facebook_create_post, facebook_schedule_post, facebook_comment, social_create_post, social_schedule_post) or a message tool (_send_message, _start_chat). Use it when the user wants a photo or video in a post or message and it isn't already online: files attached in the chat can't reach Pluggzy, so ask them to upload it here. If you made the file yourself in a sandbox or terminal with internet access, upload it yourself with the upload_command it returns. Images: JPEG, PNG or WebP, at most 8 MB. Videos: MP4, MOV or WebM, at most 100 MB, for social_create_post and social_schedule_post only (the LinkedIn, Instagram, Facebook and message tools take images). Each link takes one file: for another one (each image of a carousel, say), call upload_image again. The file can be used for 24 hours, in as many posts as needed; a scheduled post keeps its own copy until it goes out.
upload_media
ChatGPTReturns a link where the user uploads an image or a video from their device, and the media_id to pass to create_post (media_ids), comment or a message (send_message, start_chat: media_id). Use it when the user wants a photo or video in a post or message and it isn't already online: files attached in the chat can't reach Pluggzy, so ask them to upload it here. If you made the file yourself in a sandbox or terminal with internet access, upload it yourself with the upload_command it returns. Images: JPEG, PNG or WebP, at most 8 MB. Videos: MP4, MOV or WebM, at most 5 GB on the page (upload_command sends at most 100 MB), for create_post on publishing accounts only (LinkedIn, Instagram, Facebook posts, comments and messages take images). Each link takes one file: for another one (each image of a carousel, say), call upload_media again. The file can be used for 24 hours, in as many posts as needed; a scheduled post keeps its own copy until it goes out.
whatsapp_get_messages
ChatGPTMessages in one WhatsApp chat, most recent first. 'from' is 'me' (the account owner) or 'them'. message_id values work with whatsapp_react.
whatsapp_get_profile
ChatGPTRead a WhatsApp user profile: name, username, phone when WhatsApp shares it, bio, followers and picture. Counts as a profile view.
whatsapp_list_chats
ChatGPTWhatsApp chats (1-to-1 and groups), most recent first. Use unread=true to triage. Returns chat_id values for whatsapp_get_messages / whatsapp_send_message, and person_id (the contact's WhatsApp id, <digits>@s.whatsapp.net) for 1-to-1 chats; for a group's members use whatsapp_list_group_members. With several WhatsApp accounts, lists them all merged (each item has its account_id: pass it as account to the other whatsapp_* tools); account narrows to one.
whatsapp_list_group_members
ChatGPTMembers of a WhatsApp group chat (chat_id from whatsapp_list_chats), with their user_id for whatsapp_get_profile and their phone number. Group chats only.
whatsapp_mark_read
ChatGPTMarks a WhatsApp chat read (or unread).
whatsapp_react
ChatGPTAdd an emoji reaction to a message (message_id from whatsapp_get_messages). Any emoji works; a new reaction replaces yours.
whatsapp_send_message
ChatGPTReply in an existing WhatsApp chat (1-to-1 or group). Plain text. WhatsApp actions are spaced 10–20 s apart. Show the user the exact text before calling this.
whatsapp_start_chat
ChatGPTMessage a phone number you have no WhatsApp chat with yet. phone: international format with its country code, like +33 6 12 34 56 78. WhatsApp bans accounts that send cold messages (new accounts after 2–3), so only message people who expect it; at most 10 new chats a day. Show the user the exact text before calling this.