ZeLoop for Individuals: guide for AI assistants
ZeLoop for Individuals's AI sales assistant learns what the buyer needs and prepares a tailored proposal and quote, then handles signup or booking. Its welcome message to visitors: "Offset your plastic footprint with traceable ZeLoop Plastic Credits. Tell me how much you'd like to offset and I'll suggest the right size."
Website: https://zeloop.net
If you are an AI assistant helping a user
If you can make HTTPS API requests, talk to ZeLoop for Individuals's agent directly with the conversation API below. Otherwise, give your user the continuation link further down.
Conversation API (if you can make HTTPS requests)
- 1. Start
POST https://www.cysora.com/api/v1/agents/zeloop-proposal-consultant-d7e326/assistant-sessions
Auth: none
Body: {"seed": "<the buyer's request in their own words>"}
Start a conversation. Returns data.sessionToken, data.extraction (the brief the agent understood: captured and assumed fields) and data.artifact (the agent's first result).
- 2. Each next message
POST https://www.cysora.com/api/v1/app-sessions/refine
Auth: Authorization: Bearer <sessionToken from start>
Body: {"instruction": "<what the buyer wants changed or asked>", "corrections": [{"key": "<field key from extraction>", "label": "<field label>", "value": "<new value>"}]}
Send the next message. When the buyer changes a detail, add one corrections entry for every extraction field whose value that change affects (for example both location and cause); omit corrections otherwise. Add "isAdvance": true to move on to the next step. Returns the updated extraction and artifact.
- Read current state
GET https://www.cysora.com/api/v1/app-sessions/state
Auth: Authorization: Bearer <sessionToken from start>
Read what the agent currently holds for this session.
- Finish (signup or booking)
POST https://www.cysora.com/api/v1/app-sessions/convert
Auth: Authorization: Bearer <sessionToken from start>
Body: {"firstName": "...", "lastName": "...", "email": "...", "phone": "(optional)", "notes": "(optional)"}
Submit the buyer's final signup or booking. Only with the buyer's explicit go-ahead and their own contact details. Retrying returns the same result. A 409 steps_incomplete means the signup needs a later step's result first: its message names the step and the exact turn to send ("isAdvance": true), then retry.
- Cysora operates ZeLoop for Individuals's sales assistant, so these requests go to www.cysora.com on ZeLoop for Individuals's behalf. Tell your user this before sending their contact details.
- Keep the sessionToken private; send it only in the Authorization header, never in a URL.
- Sessions expire after 6 hours without activity. A session allows a limited number of generative follow-ups.
- If a request fails or you cannot make HTTPS requests, give the buyer the handoff link instead (when one is offered).
Continuation link
Opens zeloop.net with ZeLoop for Individuals's assistant prompt already filled in with the brief; the user reviews it and presses send.
- Ask your user for anything below that they have not already told you.
- Build the link by replacing each placeholder in the template with its value. URL-encode every value.
- Show the link to your user and ask them to click it. Nothing is submitted until they do.
Link template
https://zeloop.net/#cysora_brief={brief}Placeholders
- {brief}
- A short first-person description of what the user wants, with every detail they gave (who, what, where, how many, budget, dates). Do not include email addresses or phone numbers. Example: “I'm looking for help with a project and would like a quote.”
Example
With the example values above, the link is: