With file sending, agents and visitors can add screenshots and other relevant files directly to a chat from the dashboard or widget. Later, a link to the file and its thumbnail appear in History for the chat.
This article includes the following topics:
About file sending
If file sending is enabled for your account, a clipboard icon appears in the bottom right of the chat panel:
By default, agents and visitors can send the following file types:
- PDF (.pdf)
- PNG (.png)
- JPEG (.jpeg)
- GIF (.gif)
- Text (.txt)
The size limit for files is 20 MB.
Administrators can also choose to allow other file types in additions to the ones listed above. For more information, see Managing file sharing.
Sharing a file as a visitor
Visitors to your site can follow these steps to share files with agents.
To share a file as a visitor
- Drag and drop a file into the chat widget box.
Alternatively, you can select Options > Send a File and select the file.
- Wait for the file to upload to the chat.
At this point, the file appears in the chat transcript and in the agent's dashboard.
Sharing a file as an agent
The following steps describe how an agent can share a file in a chat.
To share a file as an agent
- Drag and drop a file onto the chat panel.
Alternatively, you can click the paperclip icon in the lower right-hand corner of the chat panel and select the file.
- Wait for the file to upload to the chat.
The file appears in the visitor's widget.
Deleting a file attachment
You can delete any files attached to a chat.
To delete individual attachments from chats
- In the Chat dashboard, select History.
- Click the chat that contains the attachment you want to delete.
- Under the attachment title, click Delete.
The attachment will be permanently deleted and cannot be recovered.
Note: The link for the deleted attachment might be available for up to 24 hours after deletion.
22 Comments
Is there any way to send image attachment via REST chat api?
Hi Victory,
The Chat REST APIs are not designed to support ongoing chats, they focus on past chats. We have no immediate plans in the next 6 months to offer APIs to trigger actions during an ongoing chat.
Can you walk me through the use case you are trying to support?
Thanks,
Ramin
Hi Ramin,
Do you mean it's impossible for make a realtime-chat with Zendesk REST API and websocket right now.
I thought these APIs:
https://developer.zendesk.com/rest_api/docs/chat/chats
https://developer.zendesk.com/rest_api/docs/chat/apis#streaming-api
can support live-chat? Can it?
Also, I also notice other API clients here: https://developer.zendesk.com/rest_api/docs/api-clients/introduction. Can these API clients support live-chat ?
Hi Victor,
The streaming API is designed for reporting of real time data in aggregate, not to do certain actions in a specific chat.
Currently, there are no API clients that support the Chat REST APIs and the clients listed on that page are for the Support product only.
Thanks,
Ramin
Hi,
Is there a way to only enable File Sending from the agent point of view and not as a visitor?
Thank you.
Hi Ellen,
There is no way to support this with the native widget. You can look into building a custom widget that does not support file sending using the Web SDK: https://api.zopim.com/web-sdk/
Web SDK is only available to customers on the Enterprise plan and requires development work on your end.
Thanks,
Ramin
Hi Ramin,
How can we enable file sharing option in chat sample provided by zendesk for android platform?
This would be for visitors.
@Vivek it should be there in sample app automatically. If it doesn't work, try turning off and on file sending in your account as an admin and reload the app. If you are still having trouble, please email chat@zendesk.com and we can troubleshoot further.
I need the same than Ellen.
I am creating an APP to send files from an image bank.
But i can't find a way to do it through API.
For example, through API can send a text message using
There is a way to send a picture?
Thanks
Hi Diego,
The apps framework currently does not have an API endpoint to send files or images. For now, you might need to send the URL to the file from the image bank app instead of the file itself.
There are no plans in 2018 to add an attachment API to the Chat apps APIs.
Thanks,
Ramin
Hi
can we send file using conversation API ?
Hi Us,
Currently, there is no API to trigger a file sending event using the Conversations API.
-Ramin
Hi, so image sending is not possible at all in Conversation API ?
Correct. At this time, it isn't supported.
What is the syntax for sending messages to the visitors?
I'm following below syntax:
Hi Sowmya,
Can you email chat@zendesk.com so you can get assistance with the conversations APIs? Thanks.
-Ramin
Hi Zendesk product Managers,
I have requested few days back removing attachment ability from Zopim api. Below thread i had chat with Kyle Jones looking if this feature will be available in future
https://develop.zendesk.com/hc/en-us/requests/4839006
Hi Rinku,
Thanks for sharing your feedback. We don't have any immediate plans to offer a delete attachment API. If that changes, we will keep you updated here.
If you want to remove support for attachment sending in the widget, you can look at building a custom widget using the Web SDK: https://api.zopim.com/web-sdk
Thanks,
Ramin
Hi everyone, for how long a zopim attachment link is avaiable for download?
thanks
Hi Armando,
The attachments stay available in the chat history unless they're actively deleted, there isn't a time limit where they'll expire.
When will the clipboard start working in the chat? This is a basic functionality that is still not available in zendesk where it is most needed.
It should be operational; if it is not working for you and you are using supported file types, I would suggest initiating a chat with our support team to troubleshoot your implementation.
Please sign in to leave a comment.