fanaura.audience_activity
ChatGPTUse this when the user asks about the whole audience over a date range, including accounts with thousands of contacts. Returns new contacts per day, events by type, and breakdowns by journey, source, city, and device. Pass field to add a breakdown of one registry field. Reads up to 5,000 rows of each kind and sets truncated when the range holds more. Read only.
fanaura.audience_overview
ChatGPTUse this when the user asks how many contacts they have or wants audience totals. Returns the total, new contacts this week, and how many contacts have an email address or a phone number. Read only, and it sends nothing.
fanaura.check_link
ChatGPTUse this when the user wants to know whether a destination URL works before it goes live. Reads the public page and returns its domain, title, share image, and kind, such as video, music, or podcast. An invalid URL returns an error. Read only, and the journey does not change.
fanaura.contact_timeline
ChatGPTUse this when the user wants one contact history in pages, or narrowed by date or event type. Returns up to 50 timeline events per page with occurred_at_local times, oldest first unless order is newest, plus next_cursor for the next page. Filters by after, before, and types. Read only.
fanaura.create_journey
ChatGPTUse this when the user gives a destination URL, usually with a keyword, and wants a journey built for it. Creates the journey and publishes it in the same call unless publish is false. Fanaura fills in anything the user did not give: the name, the keyword, up to ten public comment replies, automatic contact capture, and every connected Instagram, text, and email trigger. Returns live, a recap of those settings, and public_url when the journey is live. The journey is saved as a draft instead, with the reason in blockers, when Instagram is not connected, the keyword is live on another journey, the public name is not claimed, or membership is inactive. An invalid URL creates nothing. Once live, Fanaura sends the link to people who use the keyword and posts a public reply under Instagram comments. Repeating a call with the same idempotency_key returns the first result and creates nothing new.
fanaura.describe_contact_fields
ChatGPTUse this when the user asks what they can know about their fans, or what is missing across the audience. Returns the contact field registry and the event registry for the account. Each field includes contacts_with_value, the number of contacts that have it stored. Read only.
fanaura.get_contact
ChatGPTUse this when the user asks about one fan. Finds the contact by one of contact_id, handle, phone, or email. Returns a summary paragraph, every stored field grouped by category with its source, the full timeline with occurred_at_local times, and a missing list split into asked_unanswered and not_asked. Fields with no stored value are left out. Read only.
fanaura.get_journey
ChatGPTUse this when the user asks about one journey by id. Returns its draft settings, revision, live state, and public link. Read only.
fanaura.instagram_connect_link
ChatGPTUse this when Instagram is not connected to Fanaura, or its login expired, and the user wants to connect it. Returns a secure Instagram authorization link that expires in 15 minutes. Nothing changes until the user opens the link and approves access.
fanaura.list_journeys
ChatGPTUse this when the user asks what is live, what keyword a journey uses, or where a journey sends people. Returns the account journeys, each with its id, draft settings including keyword and destination, and live state. Read only.
fanaura.publish_journey
ChatGPTUse this when the user asks for a draft to go live, or asks for a change to a live journey, since edits reach fans only after the draft is published. Reserves the public link from the journey name and publishes the current draft. Returns public_url, share_url, and a recap of the live settings. When the live version already matches the draft, it changes nothing and says so. It fails with the field to fix when the checklist is incomplete, the public name is not claimed, or the draft changed after expected_revision. Once live, Fanaura sends the link to people who use the keyword.
fanaura.search_contacts
ChatGPTUse this when the user asks who came in, who tapped a journey link, or which contacts match a name, field, source, or date range. Returns one page of contact cards, each with a contact_id, a summary, identity fields, and the three latest timeline events, plus next_cursor for the next page. With rank_by_visits true, it ignores the other filters and returns contacts ranked by journey link visits. Read only, and it sends nothing.
fanaura.set_capture
ChatGPTUse this when the user wants the journey link to collect an email address or a phone number before the visit continues. Adds that field to the journey draft. It does not export, share, or sell contacts.
fanaura.set_destination_url
ChatGPTUse this when the user gives the page people should land on, such as a song, episode, booking page, rate card, book, portfolio, or lead magnet. Saves the URL on the journey draft. Requires a full public website URL and returns an error for anything else. A live journey keeps its current destination until the draft is published again.
fanaura.set_followers_only
ChatGPTUse this when the user wants the link sent only to people who follow them on Instagram, or wants that limit removed. Sets followers only on the Instagram comment and DM triggers of the journey draft. Text and email triggers are not affected.
fanaura.set_instagram_keyword
ChatGPTUse this when the user names the word people comment, DM, text, or email to get the link, such as MUSIC, BOOK, GUIDE, or LINK. Saves one keyword on the journey draft and turns keyword replies on. The journey responds only to that keyword and never to every comment. A live journey keeps its current keyword until the draft is published again.
fanaura.set_public_replies
ChatGPTUse this when the user wants to write the public replies posted under Instagram comments that use the keyword. Replaces the reply list on the journey draft with up to ten versions, and each comment gets one of them. It sends no private messages and no blasts. A live journey keeps its current replies until the draft is published again.
fanaura.setup_status
ChatGPTUse this when the user asks whether Instagram, email, or texting is connected. Returns the connection state of each channel, the Instagram username, whether Instagram needs a reconnect, journey counts, and audience totals. Read only.
fanaura.start_journey
ChatGPTUse this when the user wants to build a journey one setting at a time. A journey sends a link after an Instagram comment keyword, an Instagram DM keyword, a text keyword, or an email keyword. With a destination URL, this saves an unpublished draft with a suggested name and returns its journey_id and suggested keywords. Without a URL, it saves nothing and returns a question asking for the link. It does not publish, send messages, or buy a texting number.
fanaura.validate_publish
ChatGPTUse this when the user wants to know whether a journey is ready to go live. Returns the list of unfinished checklist items, which is empty when the journey can be published. Read only, and it does not publish.
fanaura.audience_activity
Claudefanaura.audience_overview
Claudefanaura.check_link
Claudefanaura.contact_timeline
Claudefanaura.create_journey
Claudefanaura.describe_contact_fields
Claudefanaura.get_contact
Claudefanaura.get_journey
Claudefanaura.instagram_connect_link
Claudefanaura.list_journeys
Claudefanaura.publish_journey
Claudefanaura.search_contacts
Claudefanaura.set_capture
Claudefanaura.set_destination_url
Claudefanaura.set_followers_only
Claudefanaura.set_instagram_keyword
Claudefanaura.set_public_replies
Claudefanaura.setup_status
Claudefanaura.start_journey
Claudefanaura.validate_publish
Claude