External storage for CRM

With CCAI Platform, you can use external storage to store and retrieve CCAI Platform session data such as call recordings, chat transcripts, media files uploaded by end-users, email transcripts, and session metadata. These files are stored outside of your CRM, and you can link them to your CRM records. Files are encrypted during transit. Setting up external storage is helpful if you have a CRM that does not have a standard integration with CCAI Platform.

File types and naming conventions

The following table shows the file types that can be stored in external storage, as well as the naming convention for the various file types:

File type Naming convention
Call recordings - call-{id}.mp3
- call-{id}.wav
Chat transcripts - chat-{id}.txt
Media files - call-{id}-photo-{photo-id}.jpg
- call-{id}-video-{video-id}.mp4
- chat-{id}-photo-{photo-id}.jpg
- chat-{id}-video-{video-id}.mp4
Email transcripts - email-{id}.pdf
Session metadata - metadata-{id}.json
- metadata-{id}.txt

Storage types

You can use the following storage types for external storage:

Before you begin

To set up external storage for your CRM, you need the following:

  • A CCAI Platform account with administrator and agent roles

  • Access to your CRM

  • A Cloud Storage bucket or a secure file transfer protocol (SFTP) server, depending on the type of external storage you are setting up

Set up external storage using Cloud Storage

To set up external storage using Cloud Storage, follow these steps:

  1. Sign in to the CCAI Platform portal using administrator credentials.

  2. Click Menu, and then click Settings > Developer Settings.

  3. Go to the External Storage pane, and then click the toggle to the on position.

  4. For Server Setup, click Google Cloud and then click Service Account (Bucket Owner).

  5. In the Bucket Name field, enter the path to your Cloud Storage bucket.

  6. In the Key (JSON File) field, click Upload key. Select a key file for a service account that has write permissions to the Cloud Storage bucket.

  7. If you want to save your session data to a specific folder in your Cloud Storage bucket, enter the path to the folder in the https://storage.googleapis.com/storage/v1/b/o/ field.

  8. Select the checkboxes next to the types of data that you want to store.

  9. Optional: For Email, clear the checkboxes for the types of email data that you don't want to store in external storage. Checkboxes are selected by default.

  10. Optional: For Email, edit the path for a type of email data. This changes the folder in your SFTP server where that type of email data is stored.

  11. Click Link & Save.

Set up external storage using an SFTP server

To set up external storage using an SFTP server, follow these steps:

  1. Sign in to the CCAI Platform portal using administrator credentials.

  2. Click Menu, and then click Settings > Developer Settings.

  3. Go to the External Storage pane, and then click the toggle to the on position.

  4. For Server Setup, click SFTP Server.

  5. In the Host field, enter the URL or IP address for your SFTP server.

  6. In the Port field, enter the port number for your SFTP server.

  7. In the Login User ID field, enter the user ID for signing into your SFTP server.

  8. In the Password field, enter the password for signing into your SFTP server, if one is required.

  9. If your SFTP server requires an SSH private key for authentication, select the SSH Private Key checkbox.

  10. In the Private Key field, enter the private key.

  11. In the Passphrase field, enter the passphrase.

  12. If you want to save your session data to a specific folder in your SFTP server, enter the path to the folder in the sftp://@:22/ field.

  13. Select the checkboxes next to the types of data that you want to store.

  14. Optional: For Email, clear the checkboxes for the types of email data that you don't want to store in external storage. Checkboxes are selected by default.

  15. Optional: For Email, edit the path for a type of email data. This changes the folder in your SFTP server where that type of email data is stored.

  16. Click Save Changes.

Accepted SSH key types

The following SSH key types that are accepted as private keys when setting up external storage using an SFTP server:

  • curve25519-sha256 (node v14.0.0+)

  • curve25519-sha256@libssh.org (node v14.0.0+)

  • ecdh-sha2-nistp256

  • ecdh-sha2-nistp384

  • ecdh-sha2-nistp521

  • diffie-hellman-group-exchange-sha256

  • diffie-hellman-group14-sha256

  • diffie-hellman-group15-sha512

  • diffie-hellman-group16-sha512

  • diffie-hellman-group17-sha512

  • diffie-hellman-group18-sha512

  • diffie-hellman-group-exchange-sha1

  • diffie-hellman-group14-sha1

Agent experience

During a call or chat session, photos and videos uploaded by the end-user using Smart Actions are displayed in the agent adapter. When the session is over, agents see a link in the CRM pointing to the session recording or transcript stored on the external server.

Locating chat transcripts

Once a chat has ended, the transcript is uploaded to your CRM, or a data server, based on your configuration. This transcript shows the participants, timeline of events, and conversation content.

Administrator configuration

Chat transcriptions are enabled or disabled globally across the CCAI Platform instance.

To enable chat transcriptions:

  1. In the CCAI Platform portal, go to at Settings > Chat > Chat Transcripts.

  2. Use the toggle to enable or disable chat transcripts.

  3. Select the preferred option for displaying the previous chat interaction:

    • To agent and consumer

    • To agent only

    • To consumer only

  4. Click Save Chat Transcript.

Location in CRM or server

Transcripts are uploaded to the CRM or server once the chat has been completed. Transcripts can be found where the chat ID and other chat information are stored:

  • Zendesk: added in plain text and attached as a file to a private comment in the ticket

  • Salesforce: added as a file attachment as a comment or to the CCAI Platform Session Object

  • Kustomer: added as both a file attachment and as a comment

  • MS Dynamics: added as an attachment under timeline for the ticket

Transcript details

The following sections outline the handling of session transcripts with CRM.

Timestamp formatting

The timestamps in the chat transcripts default to the timezone as set in Settings > Support Center Details.

The timestamps are formatted in HH:MM:SS format.

Participant identification

  • The participants' first name and last name initial show, if available in the system.

  • The chat support agent name includes Agent before the agent's first name.

  • The full name of the agent won't be displayed anywhere in the system generated sections.

  • The full name of the end-user won't be displayed anywhere in the system generated sections.

Transcript styling

Header:

  • The transcript header contains the following:

    • The chat ID of the specific chat with a prefix "ID:".

    • The start date of the chat in the format of YYYY-MM-DD and timezone.

  • The dotted line made of 50 hyphens (-) is placed in the line right below the header.

Body:

  • The individual messages sent by the participants and the system.

  • Messages are chronologically ordered following the order of message exchange and include the following:

    • The exact timestamp of the message in HH:MM:SS format.

    • The name of the participant who sent the message.

    • The message sent by the participant.

    • No text case, styling, or format changes are made to the actual chat message sent by the participant.

    • All back-to-back messages from a single participant or system are stacked together to represent a message block.

Structure

Transcript structure