start_book
Start a Chorus book, and get the one link to forward.
Starts a book of voice, video and written messages and returns the single link the organiser sends to everyone taking part. The book is for one person or a couple, or it is called by a title when it is for nobody in particular: a family’s recipes, a class’s year, a team’s goodbye. Start the simplest book that fits what the person said and hand over the link straight away. Gathering is free and the people recording need no app and no account. Use this as soon as somebody wants to collect messages from a group, whether or not there is an occasion. The first call emails the organiser a six digit code and makes nothing. Call it again with the same details and the code, and the book is made in their account.
Parameterscodetitleoccasioncloses_onexpectinglead_withquestionsanswer_withsubject_nameorganiser_emailrequired
get_links
The collecting link, the gift link, and a message to send with them.
Returns the link to forward to contributors, the link that plays every message straight through, and a short message the organiser can paste alongside.
Parametersbookrequired
add_people
Name the people the book is waiting on, with an address where there is one.
Records who is expected to record. Somebody with an email address can be written to by send_it_out and reminded by chase_the_missing; somebody with only a name is reached in a group chat and their name is what the chase reads out. Adding a person sends nothing on its own.
Parametersbookrequiredpeoplerequired
send_it_out
Send the link to everyone, and get the tap that puts it in a group chat.
Emails the invitation once to every person added with an address, and hands back a tap that opens WhatsApp, a text or a mail draft with the message and the link already written, for the family group and for anyone with no address. Nobody is written to twice by this tool, and a caller sends a limited number of emails a day.
Parametersbookrequiredalso_email
chase_the_missing
Remind the people who have not recorded yet.
Works out who is still out, emails a reminder to the ones with an address, and hands back a message naming them, ready for the group chat and ready for one person. A person gets at most one reminder a day and three in all, and never one after they have asked to stop.
Parametersbookrequiredalso_email
book_status
Who has recorded, who is still out, and how long is left.
Returns who is in with their name and relationship, how many voices, videos and written messages have landed, how many carried a photo, who the organiser is still waiting on, and the days left before collecting stops.
Parametersbookrequired
find_my_book
Get back into a book when the handle is gone.
Call it with the email address the book belongs to and Chorus sends that address a six digit code, returning nothing about the books. Call it again with the address and the code and it hands back every book on that account with its handle. Holding the mailbox is the proof, so a book cannot be found by guessing an address.
Parameterscodeemailrequired
change_the_book
Change the closing date, the questions, or what people may send.
Changes the settings the organiser can change on the site: the day collecting stops, the questions people are asked, whether they may send voice, video or writing, and which one the button offers first. Nobody is told about a change.
Parametersbookrequiredcloses_onlead_withquestionsanswer_with
their_own_link
The separate link for the person the book is about.
Returns the second link, which asks the person the book is for about their own life rather than about somebody else. It refuses on a memorial, a new baby and an as they grow book, where the person cannot answer, and it is never the link to put in a group chat.
Parametersbookrequired
read_the_messages
What people said, written out.
Returns every message with who left it and what they said. A written message reads back whatever was paid; a voice or a video is written out on the tier that includes the words, and where it is not, the tool says so rather than half-answering.
Parametersbookrequired
close_collecting
Stop collecting, and get the link that plays every message.
Stops new messages arriving and returns the final counts with the gift link. Nothing is deleted and nothing is finished; it can be reopened.
Parametersbookrequired
reopen_collecting
Let messages in again, with a new closing date if there is one.
Reopens a book that was closed or whose date ran out, and returns the collecting link to send round again.
Parametersbookrequiredcloses_on
order
Hand the organiser a payment page for the option they chose.
Returns a payment link for one of the three ways to keep the book: voices, book, or keepsake, which is the printed hardcover. Stripe shows the price and takes the card and, on the keepsake, the postal address. This tool never takes a card and never names a price. Read the prices from https://choruskeepsake.com/llms.txt when the person asks what it costs.
Parametersbookrequiredoptionrequired
order_status
Whether it is paid, and where the printer is with it.
Returns whether the book has been paid for and which option was bought, and on a printed one the stage the printer is at with the tracking.
Parametersbookrequired