Artifacts
Letters, dashboards, charts, tables and explainers the Assistant writes for you, and how to share them with your team or a patient
An artifact is a finished piece of work the Assistant writes for you: a referral letter, a dashboard of your patients, a chart of your visits, a table, a checklist, or an animated explainer for a patient. It opens next to the chat, ready to read, print or share.
Artifacts are for doctors only, the same people who can use the Assistant.
Asking for one
Ask the Assistant in plain words, in Arabic or English. For example:
- "Write a referral letter for Rania to an orthopaedic surgeon"
- "Make a dashboard of all my patients"
- "Chart my visits over the last month"
- "Make an explainer about knee injections for the patient"
The Assistant looks up what it needs in Docistra first (your patients, visits, schedule), then writes the artifact. Names, dates and numbers come from the record, not from memory.
When it's done, the chat shows a line such as Created Referral for Rania +28 and a card with the artifact's title. Later changes show as Edited with the lines added and removed.
| On the card | What it does |
|---|---|
| The card itself, or Open | Opens the artifact beside the chat |
| Hide | Shown instead of Open while the artifact is open; closes it |
| Share icon | Opens the artifact with its share options |
| The line under the title | Who can open it: Only you, Clinic team, You and 2 people or Shared with patient |
An artifact is read-only. To change it, ask the Assistant ("make the chart a line chart", "add the patient's allergies"). Every change is kept as a version.
The artifact panel
The artifact opens on the side of the chat (full screen on a phone).
- Resize: drag the handle between the chat and the artifact. Click the handle to close the panel. Dragging it all the way gives the artifact the full width.
- The title menu (tap the title): Print or save as PDF, Copy link, Rename, Duplicate, Refresh, and Delete artifact.
- Versions: open an older version to see it, and tap Restore to bring it back.
The Artifacts button at the top of a conversation lists every artifact made in that conversation, with a live preview of each.
Sharing
Tap Share at the top of the artifact. The share window has two tabs, Share and Export.
Who can open it
Under General access, choose:
| Option | Who can open it |
|---|---|
| Only you | You alone (the default) |
| Your clinic team (view only) | Everyone in your clinic. They see it under Shared with me, and can't change it. |
Inviting specific people
Type a name in Invite people from your team and pick the teammate. They can view the artifact (never change it), and get a notification with a link to it. They appear under People with access; tap Remove to take their access away.
Sending it to the patient
Link the patient to the artifact first, then tap Send to the patient. The patient receives a WhatsApp message from the clinic's number with a link to the artifact at docistra.com/artifacts/....
- While it is shared with the patient, anyone with the link can open it.
- Tap Stop sharing to close the link again.
WhatsApp only allows a normal message within 24 hours of the patient's last message to the clinic. Outside that window, Docistra copies the link so you can send it yourself.
Copying the link
Copy link copies the artifact's link. It opens only for the people who have access (see the line at the bottom of the share window).
The Artifacts page
Every artifact you make, and every one shared with you, is in one place:
- Artifacts in the doctor view's sidebar (
/doctor/artifacts). - Artifacts above the chat list on the Assistant page. This opens the same list in a window over the chat, so you don't leave your conversation.
The page has two tabs, Mine and Shared with me, and a search box (Search by title or patient). Switch between cards and a list with the button beside the search box.
Tap an artifact to open it. The ⋮ menu on each one offers Chat with assistant, Share, Print or save as PDF, Copy link, Rename, Duplicate and Delete artifact. Artifacts shared with you are view only.
In the Assistant's chat list, a conversation that made an artifact shows the artifact icon at the end of its row.
Talking about an artifact
To ask about an artifact or change it, link it to your message:
- On the Assistant page, tap Link an artifact (beside the paperclip) and pick one.
- Or choose Chat with assistant from an artifact's ⋮ menu.
The Assistant then knows which artifact you mean. It can change your own artifacts; one a teammate shared with you, it can only read.