Exporting consultation notes
Send notes, approved recaps and action items to the tools your practice already uses
Last reviewed
Being introduced
Exports are being introduced. Until they are switched on for your account, the options described here are shown as unavailable.
What is sent
You choose what each send contains, from the kinds of item the destination is allowed to receive:
- Consultation notes: the note you keep for a consultation.
- Recap: the summary of a recorded consultation, only once you have approved it. A recap that is still awaiting your approval cannot be sent.
- Action items: the follow-up tasks from the consultation.
Transcripts, audio and video are never exported. A recording whose client has withdrawn their consent to it cannot be exported.
Who can send
- Your own destinations: you can set up destinations for yourself and send your own items to them. Only you can change or remove them.
- Your firm’s destinations: an owner or administrator of your firm can set up destinations that every member of the firm may send to. Only an owner or administrator can change or remove them.
Destinations are set up on the web, in your practice integrations settings.
Recorded consent for each destination
Nothing is sent to a destination until you have given your recorded consent for it. The consent names the kinds of item that destination may receive, and you can only send those kinds to it.
- We record the wording you accepted and its version, when you accepted it and who accepted it.
- Every export is recorded in an audit log.
- You, or your firm, decide what is exported and are responsible for how the receiving system handles it, including your duties of confidentiality to your clients.
Signed webhooks
A webhook destination is an HTTPS address in your own systems, or in an automation tool you use. Each export is posted to it with the content in the body, and signed so your system can check it came from us.
- Only HTTPS addresses are accepted, and redirects are never followed.
- When you add the destination we show you its signing secret once. Store it somewhere safe: it is not shown again.
- Each request carries the standard webhooks headers:
webhook-id,webhook-timestampandwebhook-signature. Check the signature with your signing secret, and reject requests whose timestamp is too old. - The
webhook-idstays the same when we retry an export, so your system can ignore a repeat it has already processed. - Reply with any 2xx status to confirm you received the export.
Slack
- Connect: connect your own Slack workspace from your practice integrations settings and allow TheWILL.ai to post messages and see your channel names.
- Choose a channel: pick the channel each destination posts to. A private channel only appears once you have added the TheWILL.ai app to it.
- Each export arrives as one message, with longer content continued in replies in the thread. If the channel is archived or removed, the send is marked Failed and names the channel. If Slack asks you to reconnect, sends stop until you do.
- Recall: we delete the message from the channel. Anything someone has already copied, forwarded or saved from it stays with them.
Microsoft Teams
- Connect: sign in with your Microsoft 365 work account from your practice integrations settings. This is a separate connection from Outlook mail filing, so connecting Teams never gives us access to your mailbox.
- Choose a channel: pick a team you belong to and then one of its channels.
- Administrator approval: many organisations only let an administrator approve new apps. If you see “Your Microsoft 365 administrator needs to approve TheWILL.ai for Teams”, ask your administrator to approve it, then try again.
- Recall: we delete the message from the channel. Microsoft may keep a deleted message for a time under your organisation’s retention settings.
Clio
- Reconnect to allow exports: a Clio connection made for importing contacts and matters cannot write to Clio. Reconnect Clio from your practice integrations settings and accept the export wording to allow exporting. Importing keeps working whether or not you do.
- Matter link: an export goes to the Clio matter linked to the matter you are sending from, as a note, with one task for each action item. Clients and matters in Clio are not changed. If the matter is not linked to Clio, the send fails and asks you to import or link it first; we never guess a matter or create one.
- Recall: we delete the note and tasks we created. If any of them cannot be deleted, we tell you that a copy may remain in Clio.
Retries and failed sends
If your system cannot be reached, times out, or replies with 408, 429 or a 5xx status, we retry automatically for about eight and a half hours. If you reply with a Retry-After header we wait that long before trying again, up to an hour. Any other 4xx reply is treated as final and is not retried.
If a send still has not been delivered, it is marked Failed and we tell you in the app, by push notification and by email, naming the destination and the reason. For a firm destination, the firm’s owners and administrators are told too. Nothing is passed to a person to sort out: you can retry the send yourself once the problem is fixed.
Withdrawing consent and recall
- Withdraw consent: stops every further send to that destination, including sends that are waiting to be retried.
- Recall: for an item already delivered, we delete it where the destination supports that, and send a webhook destination a
consultation_export.recalledevent. We cannot guarantee that a copy the receiver already holds is deleted.
Plan limits
The number of exports you can send each calendar month depends on your plan, and free plans include none. For members of a firm, the firm’s sends count together. Retries, recalls and cancelled sends do not count. When you reach your limit, you are offered an upgrade.
Frequently asked questions
Where can I send an export?
To a signed webhook in your own systems, a Slack or Microsoft Teams channel, or a Clio matter. You connect your own workspace, tenant or account, and the provider holds what you send under its own terms with you.
Can I export a transcript or a recording?
No. Transcripts, audio and video are never exported. You can send consultation notes, approved recaps and action items only.
Does a retry count towards my monthly limit?
No. Only the original send counts. Retries, recalls and sends that were cancelled do not.
Is a webhook export the same as a developer webhook?
No. Developer webhooks tell your systems that something happened and carry IDs only. An export sends the content itself, and only to a destination you have given recorded consent for.
Related topics
Can’t find what you’re looking for?
Our support team is here to help. Contact us and we’ll get back to you as soon as possible.
Contact us
