The carriers' own questions before a firm price
carrier_questionsAfter the three steps, when to_final_quote.next_call names it: the questions of the estimate the customer picked, or of every carrier at once when get_quote carries firm_prices (then no chosen_quote_id). Then answer_carrier_questions.
Returns the questions the carrier asks in the customer's state — attestations and disclosures the carrier words itself; on the four-carrier path, every carrier's, once. Say preamble first, then ask one ask_together block per turn, each question exactly as it is worded; they are not Sigo's questions to reword. Send the answers with answer_carrier_questions.
can_answer_here is false where that carrier does not finish online, or the answers were already filed; a Sigo agent takes it, or get_quote has the prices. Either way the customer keeps the link: they can finish on the web at any point without losing what they have answered.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| locale | Yes | The language the customer is writing in. Set it from their own messages rather than leaving the default: the estimate's notice comes back in this language, and a notice the customer cannot read discloses nothing. Sigo serves these two languages only. | |
| quote_id | Yes | The handle start_quote returned. | |
| chosen_quote_id | No | The `quote_id` of the estimate the customer picked, from the list they were shown. Leave it out when get_quote answered with a `firm_prices` block: there the questions are the same for every carrier. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | How to put these, in the customer's language. | |
| preamble | Yes | Sigo's own words for the customer, to say as they are before the first question. Not one of the carrier's questions and not answered. Null when there is nothing to ask here. | |
| next_step | Yes | Where the customer finishes. Theirs at any point, not only at the end. | |
| questions | Yes | In the order the platform ranked them. | |
| ask_together | Yes | Codes that can be put to the customer in one turn, grouped the way the carrier groups them. Ask each block as one message and send its answers together. A question with `depends_on` is in no block: it gets its own turn, after the one it hangs off. Empty when there is nothing to ask here. | |
| still_needed | Yes | What the application still lacks, when that is why the questions are not here. An empty array means nothing is missing. Null means this is not about the application at all — either the questions came back, or the carrier does not finish online here. | |
| can_answer_here | Yes | False when there is nothing to ask here: the application is still missing details, the carrier does not finish online in this state, or the answers were already filed. Check `still_needed` and `note` to tell them apart. |