Choice groups and activities
Let guests pick one option per time slot, or pick a set number of times for an activity, and move sessions between groups safely.
- Do first
- Build and publish the schedule
Attend has two separate ways to give guests a choice. A session can belong to either, both or neither.
- A choice group is one time slot with several options, for example “Saturday 2 pm: spa, hike or pool”. Guests pick from the group.
- An activity is one thing offered at several times, with a per-guest limit, for example “Catamaran tour at 9 am, 11 am or 2 pm; go once”.
Choice group steps
- Read the existing groups and activities in
agenda_items__getScheduleBundle, so you extend them rather than duplicating them. - Create the group with
agenda_items__createAgendaGroup:selectionRule: "one": pick exactly one. Confirming one option releases the others. Use this for options at the same time.selectionRule: "multi": independent options. Use it only when options don’t overlap.allowNone: true(pick-one only) adds “None of these”. WithallowNone: false, guests must choose.startsAt/endsAtgive the slot time. Guests see the options, not the group name.
- Create each option with
agenda_items__createAgendaItem, passing the group’sgroupId. Options are usuallyrsvpMode: "rsvp"so capacity applies. - Copy a group for the next day with
agenda_items__duplicateAgendaGroup. It copies the group and its options with new names; dry-run it first. - Change the group with
agenda_items__updateAgendaGroup.shiftChildren: truemoves the options’ times with the group’s time.
Activity steps
- Create it with
agenda_items__createAgendaActivity.minPerAttendeeandmaxPerAttendeeset how many of its times each guest must or may confirm:maxPerAttendee: 1means “pick one time”. - Create each time with
agenda_items__createAgendaItem, passingactivityId. - Change the limits with
agenda_items__updateAgendaActivity. Dry-run first: loweringmaxPerAttendeebelow what guests have already confirmed is refused. - Check sign-ups with
agenda_items__getActivityDetail, passing one session’sagendaItemId. It returns the RSVP counts, the participants, the session’s to-dos and its chat channel.
Move a session to another group
Use agenda_items__updateAgendaItem with a new groupId, or null to take the session out of every group. Always dry-run. The dry-run returns a groupMove plan:
- In a pick-one target group, a guest who already chose another option there keeps that choice, and their place on the moved session is released. The plan lists them.
sourceGroupLeftWithoutPicklists guests whose only pick in the old group was this session; they now have no choice there.- Waitlisted and pending RSVPs are not treated as conflicts.
Read the plan back to the organizer as names and counts, and get a yes before you run it for real. Without position, the session goes to the end of the target group.
Then
To nudge guests who haven’t chosen yet, use the agenda_unanswered condition in Message people who….