Viable API Ingest Documentation


Getting your API key


POSTing data to the ingress endpoint

Below are instructions for how to import custom data into Viable.


Getting your API key

  1. In Viable, click on "Admin" -> "Integrations"
  2. Scroll down the page
  3. Copy your API key


POSTing data to the ingress endpoint

The https://app.askviable.com/api//ingress endpoint allows you to POST custom data into Viable. It accepts a JSON body with these attributes:

  • text (required) The text you'd like us to ingest, e.g "The Viable API documentation could be improved by..."
  • text_created_at (required) The timestamp for the date and time the text was created, e.g. "2021-04-20T16:20:00+00:00"
  • email (required) The email (or other unique identifier) of the author of the text, e.g. "test@example.com"
  • source (optional) The source of the text, e.g. "feedback-form"
  • prompt (optional) The question or request that prompted this text, e.g. "Do you have any feedback for us?"
  • traits (optional) an object containing traits for the user, e.g. {"Subscription": "Enterprise", "User Type": "Driver"}
  • metadata (optional) an object containing metadata for the feedback, e.g. {"App Version": "2.3.0", "Product": "iOS App"}
{
 "text": "Some text to ingest",
 "text_created_at": "2021-04-20T16:20:00+00:00",
 "email": "test@example.com",
 "metadata": {
 "Label One": "Value",
 "Label Two": "Next Value"
 },
 "traits": {
 "Trait Label One": "Trait Value",
 "Trait Label Two": "Next Trait Value"
 }
}
Viable Team

Viable Team

Staff

Last Updated: 11/06/21

Related walkthroughs

Appbot Zap for Viable

You can instantly analyze user reviews posted via Appbot by sending those reviews to Viable through Zapier. Choose Appbot as the trigger >> app event Then choose New Review as the trigger event Click Continue and then click to sign in to your Appbot account Under Set up trigger , select the …

Viable Team

Viable Team

Staff

How we handle customer feedback data

At Viable, we save you time and effort by automating the manual and time-consuming tasks of tagging and structuring qualitative customer feedback for analysis. We do this by connecting to popular data sources such as helpdesk platforms, survey tools, product review apps, and spreadsheets. Synching …

Viable Team

Viable Team

Staff

Formatting CSV files to speed up ingestion into Viable

A lot of customer text data you want to analyze comes in CSV format. Free form responses in NPS, CSAT, and in-app surveys, as well as product reviews are some examples. CSV documents, however, don’t all come formatted in the same way. To speed up CSV data ingestion so you can start asking questions …

Viable Team

Viable Team

Staff