Photo sharing user guide

With photo sharing, consumers can send a photo to an agent to help the consumer and agent communicate more clearly and effectively.
  • Messaging

Photo sharing makes messaging a more visual experience, increasing communication efficiency and reducing time to resolution.

Photo sharing empowers consumers to share images with agents to explain complex issues or requests quicker and more accurately. Photo Sharing is currently in beta version

To see what messaging channels support photo sharing, please see the messaging channels capabilities comparison chart.

Image

Configuration

  1. To enable the feature for any channel, please contact your LivePerson representative.
  2. To configure mobile-app (as part of the SDK): Android iOS
  3. For messaging connectors: no additional configuration is required
  4. Web:
    • In the window studio, click on the “+” sign inside the window to show the list of menu items.
    • Enable the “Send Image” option.
  5. Click save
  6. Publish the campaign
Image

Consumer side: sending a photo

Consumers can share photos from two sources:

  1. Take a photo using the device’s camera and share it
  2. Share a photo from their device’s Photo Library

Consumers can then add more information to the image by adding a caption. They can also see photos that they have shared in the messaging history on other devices.

Once a photo was uploaded, it will be flattened to remove any potential malware from it.

Agent side: receiving a photo

The agent has the following capabilities:

  1. View a shared photo in the conversation as a thumbnail or full page.
  2. View a shared photo in the Conversation History and also for closed conversations.

Photo sharing flows (mobile-app)

Initiation

From the conversation window, the consumer clicks on the camera icon to open the Photo Sharing capability.

Two sharing options are presented to the consumer:

  1. Take a photo using the device’s camera and share it
  2. Share a photo from the Photo Library

Device permissions

  • When choosing to share a photo from the device’s camera, the SDK will ask for access permissions to the device’s camera.
  • When choosing to share a photo from the Photo Library, the SDK will ask for access permissions to the device’s photos.

Take photo

  • Choosing “take a photo” will open the device’s camera. The consumer can then take a photo and share it or retake it if needed.
  • The consumer can add a caption to the photo before sharing it.
  • When ready to share, the consumer can press on “send”.

Photo library

Sharing a photo from the device storage will open the device’s Photo Library from which the consumer can choose a single photo and share it with the agent. The consumer can then send a picture with a caption as per the instructions above.

Error and retry

In case sharing failed, an error indication in the conversation will call their attention to the failure. When clicking on the message, a retry option is set available for the consumer to press to resend the photo to the agent.

Web experience screenshots

Initiation

From the conversation window, the consumer clicks on the ״+״ icon to open the actions menu:

Image

On the menu, choose “Send image”, to open the options for sending an image.

Desktop

On desktops, after clicking on “Send image”, the user will be presented with the file system window, to select the image to send. The file system will only allow the user to select supported file types.

On Mac:

Image

On Windows:

Image

After choosing the image, it will be shown as a thumbnail in the transcript, and clicking on the image, will open the image on full screen.

Mobile (web)

On mobile, after clicking on “Send image”, the user will be presented with the options to either take a photo with the device camera or choose from the photo library on the device. After choosing the image, it will be shown as a thumbnail in the transcript:

Image

Clicking on the image will open the image on full screen.

Error and retry

In case sharing failed, an error indication in the conversation will call their attention to the failure.

Agent flow

When the agent receives the shared photo, it appears as a thumbnail in the conversation window.

Image

The Agent can preview the image by pressing the image thumbnail.

Messaging connectors - screenshots

Initiation

Apple Messages for Business

Image

Facebook Messenger

Image

Twilio SMS

Image

WhatsApp Business

Image

Agent flow for messaging connectors

When the agent receives the shared photo, it appears as a thumbnail in the conversation window. The agent can preview the image by pressing the image thumbnail.

Image

Limitations

  • Only assigned agents can view shared images in a conversation, for both open and closed conversations.
  • Storage: In-App storage is up to 20 images (configurable).
  • Users cannot remove a single image that they have shared (clear history will clear local device image only).
  • Send button from photo preview is always enabled.
  • No actions on photo (copy/ delete etc.).
  • Supported image formats: png, jpg, jpeg, and gif (non-animated).
  • Photo size limitations for connectors for Consumer to Agent flow:
      • LINE, Apple: 10MB
      • Viber, WhatsApp, Twitter: 25MB

Behavior

Photo size reduction:

  • Thumbnail: 30KB
  • Preview: 3MB
  • The photo preview screen is basic.
  • Square thumbnail for both landscape and portrait modes.

Missing Something?

Check out our Developer Center for more in-depth documentation. Please share your documentation feedback with us using the feedback button. We'd be happy to hear from you.