https://support.tethr.com/hc/en-us/categories/360001781174-Connect-apps-services Connect apps & services
https://support.tethr.com/hc/en-us/sections/360011021794-SFTP SFTP
  1. Support
  2. Connect apps & services
  3. SFTP

Connect your SFTP with Tethr

Follow

New feature: content organization, collaboration and filtering

This article describes a new feature that may not be available to all users. If you don't see this feature and want to learn more, please contact your Tethr admin.
Section only

Connect your SFTP server with Tethr to export customer interaction audio, chats, cases and their associated metadata from Tethr. 

This article covers configuring an SFTP App Integration in Tethr. 

What we'll cover:

  1. Create a new SFTP integration and authenticate your SFTP credentials in Tethr 

  2. Define the filter criteria to trigger what insights Tethr sends to your SFTP server

  3. Enable your new SFTP integration in Tethr

Before you begin:

  • You must be a Tethr Admin to connect the SFTP server integration with Tethr.
  • SFTP must be enabled for your organization to add the integration. If it's not, first submit a support ticket to get SFTP enabled.
  • You’ll need the following SFTP information:
    • SFTP credentials to connect to your server.
    • The server hostname.
    • Optional: Path for sending customer interactions to a specific SFTP folder.
    • Optional: PGP public key if files should be encrypted.
    • Optional: Fingerprints for verification.
Getting started: If you're already a Tethr customer Admin, log into Tethr using your administrative privileges. You'll want both applications open at the same time during step one, as you'll be directly copying sensitive client credentials between the two that you won't want to leave open access to. 


Step 1: Create a new SFTP integration and authenticate your SFTP credentials in Tethr 

In this section, you'll create a new SFTP integration by securely entering your SFTP client credentials into Tethr to authenticate the connection. 

    1. Under the Admin section of your Tethr account menu, select Integrations. 
    2. Choose the Add integration menu and select SFTP.

      Select_SFTP_from_the_dropdown_list_of_Tethr_integrations___Tethr_customer_support.png
    3. You'll be asked to authenticate your Tethr credentials by confirming them. If your credentials are correct, select Authorize to proceed.

      Authorization_required_for_this_admininstrative_Tethr_action.png
    4. Within the new Untitled SFTP integration, make sure to name it something that helps you recognize it later. Rename the integration by clicking the name "Untitled SFTP integration," which is editable inline. Type your new integration name into the field that appears. Any edits to the name will need to be saved.
    5. Next, enter your SFTP server hostname into the Hostname field.

      Note: Optionally, you can enter additional credentials for the following fields:
      1. Path for sending customer interactions to a specific SFTP folder.
      2. PGP public key if files should be encrypted.
      3. Fingerprints for verification.
    6. Under the Authentication section, select the Add authentication link, then enter your SFTP server credentials:

      a) Username: copy and paste the SFTP server username here.
      b) Password: copy and paste the SFTP server password here.
      c) Save your credentials to securely authorize the connection between your SFTP server and Tethr.
      d) You'll be asked to re-authenticate your Tethr credentials. If your credentials are correct, select Authorize to proceed.

      Authenticate_your_SFTP_server_credentials_in_Tethr_using_the_Authentication_link___Tethr_customer_support.png

Step 2: Define the filter criteria to trigger which customer interactions Tethr sends to your SFTP server

In this section, you'll choose the criteria that will trigger Tethr to send specific customer interactions to your SFTP server.

Required: interactions cannot be sent to an SFTP server without triggers.
  1. Within your new SFTP integration in Tethr, under the section Triggers with this integration, select the Add trigger button to specify filter criteria that will trigger Tethr to send the interaction data you define to your SFTP server.

    Triggers are the same filter criteria you'll see in Tethr's Filter panel on Search & browse. Triggers allow you to refine your interaction data further by date and time constraints, country, language, categories, custom groups (teams), talk time, agents, customers, number dialed and more. 
  2. Make sure to Name your trigger something memorable that reflects the type of criteria you choose and insights you're passing through. For example, "U.S. Sales closer or provider." You can easily name or rename your trigger by clicking the Name of the trigger and typing into the field that appears. Any edits to the name will need to be saved.
  3. You may be prompted to Save your trigger at this point or any previous changes you've made may be lost.
  4. Triggers you configure can be enabled or disabled separately from the integration within the Triggers page.

Step 3: Enable your new SFTP integration in Tethr

Once you've authenticated the connection between your SFTP server and Tethr and enabled the criteria that will trigger which interactions to send, then saved your settings, enable the integration.

Enabling the integration will prompt interactions to begin flowing through from Tethr to your SFTP server.

Required: a new SFTP integration cannot be enabled until you've completed sections 1-2 above.
Important note: some of the following actions could invalidate your SFTP connection and disable it including deleting your SFTP client credentials from the Tethr integration or changing your SFTP client credentials and not updating them in the Tethr integration.
  1. At the top of your new SFTP integration in Tethr, just under its name, are two options to enable or disable the integration. 
  2. Make sure to Name your integration something memorable that reflects the type of connection and insights you're passing through, or the type of project. For example, "U.S. customer chats." You can easily name or rename your integration by clicking the Name of the integration and typing into the field that appears. Any edits to the name will need to be saved.
  3. You may be prompted to Save your integration at this point or any previous changes you've made may be lost.
  4. Once you've enabled and named your SFTP integration, customer interactions (call audio, chats or cases) that match the trigger criteria you've set will begin flowing from Tethr to your SFTP server.

 

Articles in this section