Nero Reviews: verified job reviews for trades

Sets up a tradesperson's business once, with their name, colours, logo and optional Google review link. Returns a trade_key (save it; every other tool needs it, and it cannot be shown again), the public trade page link, and a nero_trade_ref that carries the history into Nero Work. No human sign-up form or password exists; this call is the sign-up. Call only once per business; use update_trade to change details.

Changes the business details shown on the review pages: name, trade, town, brand colours, logo link or Google review link. Only the fields given change. Returns the trade page link.

Call this after EVERY finished job, whether the customer seemed happy or not, for example when the trade says "job done for Mrs Patel". Returns a one-time review link, a ready-to-send neutral message (message_to_send), and WhatsApp and SMS share links. Nero sends nothing: you or the trade send the message to the customer the same day. The customer taps 1 to 5 stars and can add a sentence. Calling it twice for the same customer and job within 24 hours returns the same link. Rules enforced here: there is no option to ask only happy customers (that is review gating, banned by UK law), and a custom message_intro is refused if it asks for a particular rating, steers unhappy customers elsewhere, or offers any reward. Limit 30 jobs a day per business.

Answers "what's my score", "what's my level", "how many reviews have I got" or "any new reviews". Returns `spoken`, one short paragraph to read aloud as it is, plus the score (average stars to one decimal, same maths as Nero Work), number of reviews, verified jobs, level (New, Level 5 at 10 jobs, Level 10 at 25, Level 25 at 75), jobs to the next level, a star breakdown, customers who have not reviewed yet, and the three newest reviews.

Lists every review for the business, newest first (the only order offered; reviews are never sorted by stars), with stars, words, reviewer, job, date and any reply. Use limit and offset to page through.

Posts the trade's one public reply under a review (replies are final; the review itself never changes). Use it for every 1 to 3 star review: a calm, specific reply is what future customers read, and my_score lists the low reviews still waiting for one. The reply is checked and refused, with the reason and how to fix it, if it uses the customer's surname, any phone number, email or address, swearing, insults such as "liar" or "scammer", legal threats or talk of police, what the customer owes, capitals throughout, or asks the customer to change or remove the review or offers anything for it. Giving the trade's side as plain facts, saying sorry and offering to put the job right are all fine. On a refusal, rewrite and call again. Good shape: Thank them for the review, by the name they chose. Say sorry for how it felt, even if you see it differently. Give your side in one or two plain facts, with no blame (for example "A part was delayed and I should have rung you that day"). Say what you have done or will do about it, and invite them to get in touch through the business. Keep it short. Future customers read the reply more closely than the review.

The dispute desk. Call it when the trade says a review is unfair, untrue, from someone who was not their customer, blackmail ("refund me or I leave 1 star"), or contains private details, abuse or something legally wrong. It settles the dispute straight away from fixed rules (no person reads it, except legal notices) and returns verdict ("review_stays" or "sent_to_nero"), why, what_you_can_do and usually an example_reply to adapt and post with reply_to_review. A genuine customer's opinion is never removed, because hiding real negative reviews is banned by UK law (DMCC Act 2024); private details and swearing are already removed by machine before any review is published. Reasons: not_true, customer_was_to_blame (for example they were out, or changed the job), asked_for_money_or_threatened, not_my_customer, not_about_this_job, personal_data, abusive_language, legal_notice (a solicitor's letter or court order; put the details in note). The review stays visible and counting whatever the verdict. Read the verdict to the trade in plain words.

Returns the business's full record (every logged job, every rating, the totals in Nero Work's own field names, branding and nero_trade_ref) so the history can be loaded into Nero Work, the agent job exchange for trades, or kept as a backup.

Explains the review law rules Nero Reviews enforces (UK DMCC Act 2024 and CMA fake review guidance) in plain words, so you can explain to the trade why, for example, they cannot pick which customers to ask.

Takes no parameters.