auth_status
ChatGPTWhether this session is signed in to Vamos. When it is not, returns the sign-in link to give the user.
Overview
Vamos is your AI social media strategist. Ask what's working in your niche and Vamos searches Instagram, TikTok and YouTube, watches the videos and reads the comments, and finds what's trending: the formats, hooks and topics behind the videos doing best. It studies your competitors the same way. Then it writes your version, in your brand's voice. Ask Vamos for the formats working in your niche right now, the hooks from this month's best videos, what your competitors post and why it works, why a video worked from its link, or the Meta ads that have run the longest and their hooks. It writes hooks, scripts, captions and content plans from what it finds. Vamos keeps your brand, your voice and the creators you follow between chats, so every answer starts from your workspace. Research takes a few minutes, and ChatGPT checks back until the answer is ready. Vamos reads public posts and the Meta Ad Library; your private analytics, DMs and dashboards stay outside it.
Tools
chat_completion_cancel
ChatGPTStop a chat_completion_start run, e.g. when the user changes their mind or sent the wrong message. Credits cover only the work done so far. Safe to repeat.
chat_completion_poll
ChatGPTWait for a chat_completion_start run. The server holds each call up to 50s and returns as soon as the status changes.
working: call again at once, with no sleep and nothing written to the user in between. done: result is the answer; give it to the user with its links and details intact, since the links are its sources. incomplete: the same, but cut off before it finished; say so. failed: error says why. cancelled: stopped by chat_completion_cancel.chat_completion_start
ChatGPTAsk Vamos to research or write social media content: what is working on TikTok, Instagram or YouTube (trending formats, hooks and topics in a niche, a creator's or competitor's best posts, similar creators), a post's hook, comments or video, Meta ads, and posts, hooks, scripts or captions in the workspace's brand voice; or to keep what the user asks it to (a brand fact, a voice rule, creators to track, a routine). Returns a runId in under 2s while Vamos works: seconds for a rewrite, 2-8 minutes for research. Call chat_completion_poll with the runId until it is done; the answer is its
result. Send the next message in a chat after that: one sent while a run works starts a second run. Credits bill when the run completes, even if you stop polling; chat_completion_cancel stops it.create_chat
ChatGPTStart a new Vamos chat for new work and get its chatId. Every later message in the chat builds on the ones before it.
get_credit_usage
ChatGPTThe workspace's plan and remaining Vamos credits. Free to call.
get_messages
ChatGPTA chat's messages, newest first; each answer is the text its completion returned. Free: use it to show or reuse an earlier answer, or after an error to see whether a turn landed before sending it again. A non-null cursor means more pages.
list_chats
ChatGPTThe workspace's Vamos chats, most recent first, with titles. Continue the chat that matches the user's work; create_chat is for new work. Scheduled routine runs appear here too. A non-null cursor means more pages.
set_up_workspace
ChatGPTSet up the workspace this connection signed in to, as the app's onboarding does: from their social accounts, website and what they do, Vamos fills in their Brain (profile, pillars and voice) and follows creators in their niche. Ask them for these first. Returns a runId; poll it with chat_completion_poll.
Capabilities
Writes
Example Prompts
Click any prompt to copy it.
