Objective Collections
An objective collection is a reusable group of objectives and the wiring between them. Link the collection to several flows when each flow needs the same questions, data lookups, computed values, or human-agent steps.
Unlike a single objective imported from the Objective Library, a collection keeps its internal parent conditions and transitions together. It is also live-linked: when you edit the library collection, every flow that still links to it uses the updated definition without requiring you to edit each flow.
Use a collection for a repeatable block such as:
- alternate phone number, landmark, and delivery instructions;
- return reason, product photos, and condition checks;
- identity details followed by a manual verification child ticket;
- a reusable qualification questionnaire with its own branches.
Use ordinary task objectives for one-off behavior. Use Detach when you want to start from a collection but customize one flow independently.
What a collection keeps together
A collection can contain:
- one or more objectives;
- parent conditions whose source and target objectives are both in the collection;
- computed-objective dependencies that stay inside the collection;
- WhatsApp Flow prefill mappings that use another member of the collection;
- transitions based on collection objectives, including early completion or an additional reply.
The collection must be self-contained. It cannot refer directly to objectives in a particular flow, contain another linked collection, or transition to another flow. This keeps one library definition safe to reuse in different contexts.
Objective params are not renamed or prefixed when a collection is linked. For example, a member named alternate_phone remains alternate_phone in every linked flow. A flow cannot link the same collection twice, and no two linked or flow-owned objectives may use the same param.
Collections containing a WhatsApp Flow form
A collection can keep a Flow form objective together with the objectives that supply its prefilled fields. For example, a reusable customer-details collection can contain customerPhone, customerEmail, and form, with mappings from the first two objectives into fields on form.
Every sourceObjectiveParam used by a Flow prefill mapping must name a member of the same collection. Keep source objectives before the form objective so their values are available when WhatsApp renders the form. The linked collection is expanded into ordinary objectives at runtime, so prefill resolution behaves exactly as it does for flow-owned objectives.
If a source value is missing, inactive, null, or blank, only that form field remains empty; the form can still be sent. The Flow itself must have prefill-ready fields and must be republished after enabling prefill support. See Prefilling form fields for the full setup and runtime behavior.
Flow form channel rules are retained inside the collection. They currently run only for WhatsApp customer interactions and are skipped during manual ticket creation and unsupported channels. The remaining eligible collection or host-flow objectives continue normally.
Create a collection
Objective collections are managed in the Copilot's Library tab.
- Create or update a draft flow containing the reusable objectives and their internal branching.
- Open Copilot → Library and choose Create collection.
- Enter a name and description, then select the draft flow.
- Select the objectives that belong in the collection.
- Review the objectives and included wiring, then choose Create collection.
When you create a collection from a draft, a parent condition is included only when all objectives it references are selected. Cross-flow transitions are excluded. If a selected objective depends on an unselected objective, include the dependency too or simplify the draft before creating the collection.
You can later edit the collection's name, description, member params, types, and descriptions from the same Library tab. Removing a member also removes wiring that depends on that member so the collection remains valid.
Sample prompts for preparing the source flow
Copilot can prepare the flow that you use as the collection source. Creating and linking the collection itself is currently completed with the Library and flow-editor controls described on this page.
"In the delivery reschedule flow, add a reusable contact-details block that collects
alternate_phone,delivery_landmark, anddelivery_instructions. Ask the questions one at a time and require all three."
"Update the returns flow with
return_reason,item_opened, anddamage_photos. Only requestdamage_photoswhenreturn_reasonisdamaged."
"Create a verification flow with
verification_type,verification_document, and a human-agent objective namedmanual_verification. Only create the child ticket after the document has a valid value, and route it to the verification team."
"Review the objectives and conditions in the address-change flow. Tell me which objectives form a self-contained block that could be reused without referring to another flow. Do not change anything."
For a Flow form with supporting contact objectives:
"In the
<SOURCE FLOW>flow, preparecustomerPhone,customerEmail, andformas a self-contained reusable block. Preserve their exact params, order, ask instructions, required and parent conditions, internal transitions, published Flow ID, Flow prefill mappings, enabled channels, and legacy-message setting. Ensure every prefill source used byformis included and appears beforeform. Do not rename params or change unrelated objectives, completion, handoff, assignment, or ticket behavior. Report any dependency that cannot be included instead of silently removing it."
After reviewing the Copilot's changes, select the relevant objectives in Library → Create collection.
When creating the collection from that draft, select all three objectives. Then link the collection to the source and destination flows and remove the old task-local copies only after confirming the expanded flow has no duplicate params. Collection creation and linking are currently completed with the Library and flow-editor controls rather than a single Copilot migration prompt.
Link a collection to a flow
- Open Workflows → Flows and edit the destination flow.
- In Objectives, choose Link Collection.
- Select an available collection.
- Optionally enable Gate collection entry on a task objective and configure the entry condition.
- Confirm the link and save the flow.
Linked objectives appear as a read-only group in the flow editor. Their internal conditions and transitions come from the library, so edit the collection when the change should apply everywhere.
Gate a collection with an entry condition
An entry condition is the one supported connection from the host flow into a collection. It applies the same condition to every root objective in the collection.
For example, a flow can collect needs_delivery_help itself, then enter the Delivery details collection only when that value equals yes.
The source must be an objective owned by the host flow, not a member of this or another linked collection. Operators include equals, notEquals, contains, notContains, regex, gt, lt, in, exists, hasValidValue, and apiFailed. For in, enter comma-separated values such as damaged, incomplete, wrong_item.
If you rename or delete the host objective, the flow editor updates or removes its collection entry-condition reference. Review the collection gate before saving when you make either change.
How linked objective values are collected
A linked objective runs like an ordinary flow objective. It can ask the customer, infer a value, read a data point, execute an action, calculate a value, or create a human-agent child ticket. Each result is stored on the ticket under the member's objective param, so linked values appear in the ticket's objective form alongside flow-owned values.
For example, if a collection contains alternate_phone and delivery_landmark, those are the keys used to collect and retrieve their values. The collection link does not produce a separate combined value.
Flowcall also keeps the library collection and stable member identity as provenance for linked values. This allows collection objectives to remain virtual—rather than being copied into every flow—while their ticket values are still stored and shown normally.
Treat member params as a data contract. Renaming a param updates every currently linked flow, so also review any integration input mapping, computed dependency, report, or external process that refers to the old param. Historical values remain attached to their original tickets.
Human-agent members preserve the normal child-ticket lifecycle: the child is the actionable ticket while its parent waits, and submitting the child objective continues the parent flow.
Adding a child ticket from a collection
Agents can add a child ticket from a collection that has a human-agent objective, not only from a single library objective. In the ticket's Add Child Ticket form, these collections appear next to library objectives, marked (collection). For example, a Product replacement collection can ask for the order and the issue type before it creates a replacement_request child ticket.
When an agent picks a collection, the form shows the collection's objectives that come before its human-agent objectives:
- objectives that ask the customer, including ones that also read a data point, such as the order;
- objectives that are not data points.
Data points and calculated values aren't shown: Flowcall works them out. Values the ticket already has are filled in, required fields are marked, and the collection's conditions decide which fields appear.
The child ticket is created only once the answers reach the collection's human-agent objectives. When several human-agent objectives follow one another, Flowcall creates one child ticket that holds all of them. An order the agent enters must exist in your order system, or be ECOMMERCE or OFFLINE, and it becomes the ticket's order. The other answers are saved on the parent ticket and listed on the child under Entered at creation.
The child ticket shows the collection's name. The Child ticket objective filter and Insights list it under its first human-agent objective.
Ask Copilot to build a child-ticket collection
Copilot can create or update a collection for adding child tickets. It can copy an existing child ticket objective from the library unchanged and add the inputs that come before it. It can also delete the standalone objective once the collection replaces it. Review the collection on the card and choose Save Library Changes; a deletion is confirmed on its own card.
"Create an objective collection named
Order Related - Order ModificationswithselectedOrderNamefirst, asking the customer which order to modify, followed by an exact copy of the library objectiveorder_related_order_modifications. After the collection is saved, delete the standaloneorder_related_order_modificationsobjective."
A collection name must differ from every other library item, so name it after the case rather than reusing the objective's name. Agents can pick the collection in Add Child Ticket as soon as it is saved.
To change an objective that lives inside a collection, such as its team, ask Copilot by the objective's name. Copilot updates it inside its collection and keeps its other settings and conditions.
Route a collection's child ticket to a team by order data
One collection can send its child ticket to a different team depending on the order, for example by warehouse. Copilot adds an objective that reads the data point, then one human-agent objective per value, each with its own team and a condition on that value. When an agent adds the child ticket, only the matching objective is reached, so the ticket goes to the right team without the agent choosing one.
"In
Order Related - NSZ Address Updated, assign the child ticket by the order'swarehouse: emiza → Emiza Team, holisol → Holisol Team, new_emiza → New Emiza Team."
If the order's value matches none of the conditions, the agent sees that the collection doesn't create a child ticket for these values. Cover every value the data point can produce; Copilot lists any values it left without a team.
Live link, detach, and unlink
| Action | Result |
|---|---|
| Edit | Change the library collection. All flows that remain linked use the new version automatically. |
| Detach | Remove the live reference but keep the collection's current objectives and wiring as editable copies in this flow. Future edits do not propagate. |
| Unlink | Remove the reference and all objectives, conditions, and transitions supplied by that collection from this flow. The library item remains. |
Save the flow after detaching or unlinking.
Safeguards and troubleshooting
- Param conflict: rename the conflicting flow objective or collection member before linking. Params must be unique across the whole expanded flow.
- Incomplete selection: include every objective referenced by a selected condition, computed dependency, or Flow prefill mapping.
- Collection cannot be deleted: unlink it from every flow first. A collection that has already collected historical ticket values is retained for data integrity and cannot be deleted.
- Need one customized version: detach the collection in that flow, then edit the copied objectives.
- Need different entry rules in different flows: keep the collection internal logic shared and configure a different entry condition on each link.
Related
- Flows — objectives, conditions, transitions, completion, and human handoff.
- Workflows — flows and the Data Library.
- Build & Change Flows — more Copilot prompts for preparing flow logic.
- Child & Interaction Tickets — lifecycle behavior for human-agent objectives.
- Testing — verify linked collection paths before publishing them.