How to add an SFTP to your Organization

How to add an SFTP to your Organization

Overview

Webio enables SFTP implementation for your organization. SFTP (Secure File Transfer Protocol) is a file transfer protocol that uses SSH encryption to transfer files between systems securely.
Connecting via SFTP allows you to access API services or retrieve reports. You can use Webio SFTP hooks to combine the power of webhook realtime posts and SFTP file transfers to deliver webhook calls as JSON files to your organisation's Webio SFTP folder for retrieval.  

Once you have set up the SFTP this can be used to retrieve or post files to the site. SFTP hooks can only be used for post requests. Post Requests update your internal systems and are triggered when an event you are subscribed to, happens.

This can be a message being sent or received, a payment being made or a delivery report being received.
sftp.webio.com - this is where you save your API key file and retrieve your files from 
sftphook.webio.com - this is the URL you enter into your organisation screen webhook setup as the URL
To add an SFTP to your Organization you will need to configure first your (1) Webio SFTP and (2) generate your organisation's API key. 

1) SFTP configuration

Before starting your SFTP configuration process you will need the SSH key and your IP Address(es) you will be connecting from.  

When an SSH key is generated you will get a public and a private key. 

There are tools widely available for generating SSH keys, if you aren't sure how to generate one, best to ask your technical support staff, it will look something like this:

---- BEGIN SSH2 PUBLIC KEY ----

Comment: "rsa-key-20211129"

AAAAB3NzaC1yc2EAAAABJQAAAQEAjGT+5IXNb+b41bfIivv+h2HBWol7trm3oJaO7h1fkG3oMFGkovFQNrtgRt/9zpW8POGM6LrwJNwE1OWnr9e0w8+FkWaT7g86obZ0

u9v5XndZACNW6ul+5oc3CuvMeVl4XslapcYDqKXlTat/oqP2AjnqWwChraMHw4xPCxs2fq1LpHkUUUzXee8ZV7BF9u8pIdweCfrRDp3lDCYStMd1pvZGXSaqcE2N8ZZC

2Sbf9BQz6WhN/duF/7Jx2WacjmCCvvLnFDI2n0/i7wpftfvU74fy9DmfScvtVM6sxrjVGWE/npor3hcheemZcJyedmGQ/X4uu0mwGMX83WcSYxMSTQ==

---- END SSH2 PUBLIC KEY ----

To set up an SFTP connection for your Organization:

  1. From the integration panel scroll down to the SFTP section
  2. Click 'Update SFTP'.                                                                                                                                                                                                                                          
  3. Enter the SSH key and the IP Address you will be connecting from. You can add multiple IP Addresses by using the '+' button.
  4. Click 'Create SFTP'. 

You should be able to see your username under SFTP Settings now and be able to login into the application using your username and the private key you generated. 

You can now use an SFTP client to transfer and retrieve data from your Webio organization via SFTP. Once updated you will be able to transfer data to the SFTP for us to retrieve and log in and retrieve data from the SFTP.

Our SFTP address is sftp.webio.com and for Sandbox it's sandsftp.webio.com

2) Generate an Api key

Check Generating your API key (webio.com) to learn how to generate an API key.

3) Create a SFTP webhook

Once your SFTP configuration is done and you have generated the API key:
  1. Save your API key as a text file called apikey.txt and transfer this to your sftp.webio.com folder.  It may take c. 10 minutes for the key to be processed.  If you need to update your key, place a your new file there and that will replace the old key.
Your webhooks will now post to your folder, as a JSON file, at sftp.webio.com/ for you to retrieve.

    • Related Articles

    • Setup your Organization

      Overview To access the Organizations screen, from the navigation panel on the left-hand side, click on Settings, then Organizations; From here you can control your organization's settings and all your sub orgs. When you create a new organization or ...

    • SFTP Hooks

      You can now use Webio SFTP hooks to combine the power of webhook realtime posts and SFTP file transfers to deliver webhook calls as JSON files to your organisation's Webio SFTP folder for retrieval. You will need to configure your Webio SFTP and ...

    • How to configure a Webhook

      Overview Using the Webio webhook, you can configure endpoints within your Webio organization to post or retrieve data. Webhooks can be used to: 1) Receive notifications (Post Request) from your organization to your internal system, whenever an event ...

    • Generate an Api key for your organization

      Overview Webio blended conversations allow you to seamlessly communicate between your clients with human or automated agents. Connecting these conversations with your internal systems provides richer conversations and slicker processes. Using Webio ...

    • How to add custom fields names

      Overview When you build the Campaign File, it is sufficient to define custom field names (the column headers of your campaign file) and organize the custom values (Custom Value) of the contact in different columns but on the same row where the ...