Attachment Error Card
When a Smartshare card or other attachment cannot be loaded or parsed in a ZenChat conversation, ZenChat displays an error placeholder card in place of the attachment. This article explains what the error card looks like, why it appears, and how to respond.
Audience: Employees using ZenChat on the Zenoti web platform or the MyZen app who encounter an attachment that fails to display.
Before you begin
- ZenChat must be enabled for your center. If the ZenChat tab is not visible, contact your administrator.
- You must have access to ZenChat through your security role. For details, see security role configuration.
- The attachment error card appears automatically — no action is required to trigger it. This article covers how to recognize and respond to it.
Steps
Recognize an attachment error card
When an attachment fails to load or cannot be parsed, ZenChat replaces the attachment with an error placeholder card directly in the conversation.
The error placeholder card displays:
- An error icon
- The label Unable to load [attachment type], where [attachment type] reflects the kind of attachment that failed — for example, Unable to load Guest Profile, Unable to load Appointment, or Unable to load Invoice
- A brief error message describing the problem
Note: An attachment error card appears only when a technical loading or parsing failure occurs. If you cannot view an attachment because your security role does not permit access to that record, you will see a different access-denied message — not this error card.
Identify the attachment type from the error card
The label on the error card tells you which type of attachment could not be loaded. ZenChat supports three Smartshare card types:
| Label shown on error card | Attachment type |
|---|---|
| Unable to load Guest Profile | Guest profile card |
| Unable to load Appointment | Appointment card |
| Unable to load Invoice | Invoice card |
File attachments (images and documents) may also display an error card if they cannot be retrieved.
Respond to an attachment error card
- Open the conversation in ZenChat where the error card appears.
- Note the attachment type shown in the error label so you can communicate clearly with the sender.
- Select Retry if a Retry button is displayed on the error card.
- If the error persists after retrying, ask the sender to re-share the attachment:
- For a Smartshare card — ask the sender to use Attach and re-select the record from Guest Profile, Appointment, or Invoice.
- For a file attachment — ask the sender to re-upload the file using Gallery (for images) or Documents (for files).
- If the error continues after the sender re-shares, contact your system administrator to investigate connectivity or data access issues on the center's account.
Worked example: A front desk employee shares an appointment card in a group chat. A colleague sees the error card: Unable to load Appointment with a brief message indicating the data could not be retrieved. The colleague selects Retry — the card still fails. The front desk employee re-shares the appointment by selecting Attach and choosing Appointment again. The card loads successfully for all participants.
Tips
- If attachment error cards appear frequently for a specific record type (such as all appointment cards), notify your administrator — this may indicate a center-level configuration issue rather than an isolated problem.
- Error cards are visible to all participants in the conversation who received the message, not the person who first notices the failure.
- If you are the sender, re-sharing the attachment from the original record is faster than asking recipients to retry — a fresh share generates a new attachment request.
- Attachment error cards do not affect other messages in the conversation. The rest of the message history remains visible and unaffected.
Troubleshooting
The error card shows "Unable to load Guest Profile" and Retry does not resolve it. Check whether the guest record still exists and is accessible in Zenoti. If the record was merged, deleted, or the guest's center access changed after the card was shared, the attachment may no longer be retrievable. Ask the sender to share the updated record, or navigate to the guest profile directly.
The error card appears for every attachment in a conversation, across multiple attachment types. This pattern suggests a connectivity or service issue rather than a problem with a single record. Ask your administrator to verify that ZenChat is functioning correctly for your center, and check whether other employees are experiencing the same problem.
A file attachment (image or document) shows an error card even though the file is under 10 MB and is a supported format. Confirm that the file is one of the supported formats: JPEG or PNG for images, or PDF, Word DOC, Excel XLSX, or TXT for documents. If the format and size are correct, ask the sender to retry uploading the file. Persistent failures should be escalated to your administrator.