Suara

Use this when the signed-in owner gives you a photo of their business (their food, products, place or team) for Suara to use in their posts. Pass the photo uploaded in the chat, or a public https link to the image file. It goes into their photo library, where the Suara team picks photos for their posts; nothing is posted. The same photo twice is kept once.

Use this when the signed-in owner gives a lasting correction for all their future posts, like 'less pink', 'more premium' or 'never use emojis'. It's saved with their brand and applies to every post from now on (Suara keeps the 8 most recent notes). For a change to one post, use request_post_change.

Use this only when a content or UGC creator, an educator or coach, an owner-creator or a social media manager wants to apply to Suara's partner program (https://trysuara.com/partners). It is commission-only: partners refer small businesses to Suara and earn a share of what each referred business pays: the first 20 partners get 30% every month for as long as that business keeps paying (no 12-month cap), and partners after the first 20 get 25% for 12 months per business. Social media managers can refer their current clients and businesses they can't take on; each business signs up through the partner's link. Not for a business that wants Suara for itself, and nobody can refer their own business or a business they run. Partner rules: say you earn a commission (#ad, #affiliate or the platform's paid partnership label, and in words); only say what's true about Suara, no promised results; no spam or link-drops in other businesses' comments; no paid ads on the Suara name; no coupon or deal sites; don't pretend to be Suara staff. Before calling: ask for each detail (don't guess any), then show the person everything you will send plus the rules, and call only after they explicitly confirm. Set confirmed to true only then. It sends the application to the Suara team; nothing else happens and no account is created.

Use this only when the signed-in owner has clearly said to approve or post one specific post, after they've seen it. It schedules that post to be published on the owner's connected social accounts on its day (or right away if they say now). Publishing can't be undone from here. One post per call; it fails if the post isn't finished or no account is connected.

Use this when someone asks when to post on Instagram, Facebook or TikTok in Kuala Lumpur, Penang, Johor Bahru, Singapore, Jakarta, Manila, Bangkok, New York, Los Angeles, Toronto, Vancouver, London, Sydney, Melbourne or Dubai (or one of those countries). Returns windows in that city's local time where two large 2026 studies (Sprout Social and Buffer) agree, shows where they disagree instead of picking one, and adds what we measured ourselves (restaurants and cafes in the Suara Restaurant Index, and Suara clients when there are enough posts). Do not use it for other cities, for a specific account's own best time, or to promise results.

Use this when the signed-in owner wants a scheduled post not to go out. First call it without confirm: it says what would be cancelled and changes nothing. Show that to the owner, and call again with confirm true only after they say yes. The post stays approved, so it can be booked again with reschedule_post. A post that's already posted can't be taken down from here.

Use this when the signed-in owner wants to connect their Instagram, Facebook Page or TikTok so approved posts can be published. Returns a secure link (valid for an hour) to the platform's own login page; Suara never sees their password. Instagram must be a Business or Creator account. Nothing is posted by connecting.

Use this when someone wants to plan posts around festivals and holidays in Malaysia, Canada or Brunei: when to start posting for each one, who it matters most to and what to post, for example 'when should my bakery start posting for Chinese New Year?'. Returns the dates from Suara's free posting calendars on trysuara.com (the same files people add to Google, Apple or Outlook), marking dates that can still change. For official public holiday lists in other countries use holiday_calendar. Do not invent dates it doesn't return.

Use this when the signed-in owner asks what Suara knows about their business or how their posts will sound. Returns their brand as Suara has it locked: name, voice, audience, colours, what they sell, and the notes they've given ("less pink", "never say cheap"). Read only. Changes nothing.

Use this when the signed-in owner wants to see this week's posts, what's coming up, or what a post looks like. Returns each post's caption, hashtags, day and status (being made, ready to review, waiting for approval, scheduled, posted), shown in the Suara viewer with every slide. Give postId to see one post. Read only. Nothing is posted.

Use this when the signed-in owner asks what's planned or booked this week: each post's day, time, platforms and where it stands (waiting for approval, approved, scheduled, posted, failed, cancelled), in their own timezone, plus any Story or extra platform it's booked on. A quick list without pictures; to see the posts themselves use get_my_posts. Read only.

Use this when the signed-in owner asks if there's news from the Suara team, or after send_to_suara. Returns the team's replies and updates from the last few days (7 by default, up to 30): answers to their requests, posts ready to review, what was posted. Read only.

Use this when someone planning posts, promotions or opening hours needs the public holidays, state holidays or big shopping/observance days for Malaysia, Singapore, Indonesia, Philippines, Thailand, United States, Canada, United Kingdom, Australia or the UAE, for example 'when is Hari Raya this year' or 'holidays in Malaysia next month'. Returns dates verified against the official government list and a second independent calendar, which regions/states each one applies to, and lunar holidays that are expected but not yet confirmed (clearly marked). Do not use it for other countries, for school terms, or to invent dates it doesn't return.

Use this when someone who owns or works for a small business wants to see what Suara would post for them. Give the business name plus its own website and/or up to 3 photos from the chat (not Instagram or delivery-app pages). Returns 3 designed posts with captions, full size, ready to use, made from the business's own photos and words; about a minute, so if it says they're still being made, call it again with the same business. Nothing is posted anywhere and no account is needed. One sample per person per day. Only for a business the user owns or works for.

Use this when the signed-in owner asks when THEIR posts should go out or what time works best for their own account. Returns the time Suara posts for them and what it rests on: their own Instagram results when there's enough history, otherwise the time they chose or a study for their kind of business, said plainly. Read only. For a city's general best times use best_time_to_post.

Use this when the signed-in owner asks what to post, when to post, or how their Instagram is doing. Returns what's working on their own public Instagram: when they post, which posts do better, recurring themes. Read only.

Use this when the signed-in owner asks about their Suara plan or billing: whether they're paying, since when, and what their plan includes each week with what's left this week. Only states what Suara has on record. Read only. Billing changes aren't made here.

Use this when the signed-in owner asks which social accounts Suara can post to. Returns each connected platform and its username. Read only.

Use this when the signed-in owner asks how their posts did: reach, likes, comments, saves and shares for each post Suara published for them in the last days (7 by default, up to 30), plus follower change on Instagram when available. Only the platforms' real numbers: a number not shared yet is left out, and posts under a day old are still counting. Read only.

Use this when the signed-in owner wants something changed on ONE specific post they've seen: different words, another photo, a colour, a price or date to fix. Give its postId and the change in the owner's own words, complete. It goes to their Suara assistant or designer, who makes the change and sends the post back to review; nothing changes or posts right away. For anything not about one post, use send_to_suara.

Use this when the signed-in owner wants an approved post to go out at a different time, or to book an approved post that isn't booked yet. Give the time in the business's own timezone. First call it without confirm: it says exactly what would change and changes nothing. Show that to the owner, and call again with confirm true only after they say yes. Only posts the owner already approved; a post that's already posted can't be moved. Each post publishes once per platform.

Use this when someone asks how restaurants and cafes use Instagram in Kuala Lumpur, Singapore, Jakarta, Bangkok, Sydney, Melbourne, Vancouver, Toronto, London, Dubai: how often they post, likes per 1,000 followers, how much is video or carousels, caption length, hashtags and the busiest posting hours. Returns the Suara Restaurant Index (October 2026, real public accounts, with 90% intervals), for one city compared with all 10 cities, or every city's headline numbers. It measures likes only and shows correlation, not cause: say so, and do not use it to promise results.

Use this when a business owner wants help replying to a customer review on Google, Instagram, TripAdvisor or a delivery app, good or bad, for example 'how do I reply to a 1-star review about slow service?'. Returns Suara's free reply templates for that situation (with [brackets] to fill in), the rules for a good reply and what never to do. Fill the brackets only with details the owner gives you; never promise refunds, freebies or discounts in a public reply.

Use this when the signed-in owner has a request, idea or feedback for the Suara team who make their posts: what to post about, a promotion or event coming up, a change to a post (say which postId), a new look, more or fewer posts. Write the request clearly and completely in the owner's words. It sends a message to the team (nothing is posted or changed right away); the team replies later, so check with get_suara_replies.

Use this when the signed-in owner asks where their requests to the Suara design team stand: what was asked, its status in plain words and when it was asked. Open requests by default; set include_finished to also see the last 14 days of finished ones. Read only.

Use this when someone wants popular or trending songs to put on a Reel, TikTok or Story for a business in Malaysia, Singapore, Indonesia, Philippines, Thailand, United States, Canada, United Kingdom, Australia or the UAE, for example 'what songs are trending in Malaysia for Reels?'. Returns this week's songs charting on both Apple Music and Spotify in that country, with the trend (new, up, down) and whether a business account can use them. It is a music-chart signal, not a count of Reels or TikTok uses. Every song is marked business use 'unknown' with the platform's official rule: say so, and never tell a business a song is cleared. Not for picking royalty-free music or for countries outside the list.