Question 1

Getting Started with REST API

Accepted Answer

👋 Welcome to Cloutly's REST API

REST API allows you to access your Cloutly data. Request methods are used in accordance with HTTP:

GET is used to read one or more entities;
POST is used to create or update entities;
DELETE is used to delete entities;
Responses use standard HTTP codes.

Before you start using the API, read through the following five basics 👇

1️⃣ Base API Domain

Cloutly's API is provided on the following HTTPS-only domain:

https://app.cloutly.com/api/v1

2️⃣ Authentication

You should authenticate all your HTTP requests to Cloutly's API with the help of your API key.

To get your API key, go to Developers → Public API and copy your API Key from there.

[Screenshot coming soon]

In order to authenticate your HTTP requests, you should add an x-api-key header to your requests and specify your API key there.

x-api-key: YOUR_JWT_HERE

You don't need to do any extra manipulations with your API key. It is permanent and never expires until rotated from the console.

Make sure you pass the entire key without any spaces or extra symbols.

3️⃣ Rate limiting

In order to protect Cloutly from API traffic spikes that could put our database at risk we utilise rate-limiting. When you get rate-limited, you will start receiving 429 Too Many Requests HTTP errors in response to your requests.

The default overall requests limit is 200 per minute

4️⃣ Errors

Depending on the exact method, you can

Question 2

Guidelines for Connecting Direct Review Site URLs

Accepted Answer

Review Site Guidelines

When connecting new review sites other than Google or Facebook, you'll want to use the following URL guidelines to ensure we can fetch your reviews.

${frame}How to format your review site links

Question 3

How to set up and install Review Widgets on your website

Accepted Answer

How to install review widgets on your site

This quick guide will show you how to install your Proof and/or Carousel Slider widget code on your website.

Key Contents

Installing widgets on Wordpress
Installing widgets on Shopify
Installing widgets with Google Tag Manager

Creating a New Widget

1. Click on the "Widgets" link (underneath Power Ups) on the dashboard menu

2. Select your Business, the widget style (Proof or Slider) and the review sites you'd like your widget to display.

3. Then, click "Create and Get Code" to reveal the code you'll need to copy and paste into your website HTML.

Inserting Widget Code on your Website

Installing your widget code is easy, but might be slightly different from this guide depending on your website's CMS.

When you've created a new slider style widget, you'll just need to insert one snippet of code onto your website (in the location you want the slider to appear - usually between the tags).

When you've created a new badge or 'proof' widget, you'll see two small snippets which you need to copy and place into your website's HTML.

The first snippet needs to be placed in between your and tags:

<meta name="widgetCloutly" content="XXXXXXXXXXXXXXXXXXXX"/>

(use your code, not this example)

and the second snippet (b

Question 4

Connecting Review Sites

Accepted Answer

How to connect review sites to Cloutly

First, go to Connected Sites from the side menu.

Connect Google and Facebook

Click 'Connect This Site' and sign-in when prompted for each site.
Choose your Google location or Facebook page from the dropdown menu.

Note: if you do not see a pop-up window from Facebook/Google when you click this button, ensure any ad blockers you have enabled are turned off.

How to connect other review sites

Click 'Connect New Review Sites'
Select the review site you'd like to import from the dropdown menu.
Paste your Direct Review Site URL. This is the link to your existing customer-facing reviews page on that particular site, eg: https://www.reviewsite.com/review/amberelectric

Connect a review site we don't support (Custom Links)

If you want to get reviews on a site we haven't listed, you can!

Click 'Add a Custom Link'
Name your review site and add a direct link to the review page.
Click 'Add this Custom Site' - done!

You will now be able to select this site when Sending Review Invites and direct your customers here from review invites.

Question 5

Understanding the Dashboard

Accepted Answer

Overview of your Dashboard

Cloutly's dashboard was designed to be as intuitive as possible, keeping the most important and relevant information front-and-centre for you to see. Let's break it down, from the top.

The Key Indicators

You'll notice four, key blocks at the top of your dashboard:

Average Rating
Positive Reviews
Negative Reviews Stopped
Negative Feedback Collected

Let's break down what these each mean.

Average Rating

This is your average 'review score' between all your review sources. If you'd prefer to only see your rating from one particular source (or exclude Cloutly's internal feedback - more on this below), you can use the Review Sources filter to achieve this.

All Sources: this includes ratings from all your review sites, plus all ratings 'clicked' on by recipients of your review invites.

Positive Reviews

This identifies how many people rated you 4-5 stars within the selected time period.

Negative Feedback Collected

Shows you how many people left you written feedback to accompany their poor rating. If you're

Question 6

Respond to Reviews from Apple's App Store Connect with 2FA

Accepted Answer

Overview

If you are on the Power plan, this integration with App Store Connect allows you to reply to positive and negative reviews using Cloutly.

Note that you will need to follow these instructions before Cloutly can respond to reviews on your behalf.

After you set up the App Store Connect connection, Cloutly will be able to access your reviews feed and respond to reviews on your behalf. This access is regulated by App Store Connect roles and can be modified by you at any time.

| If you have an Android app, set up a Google Play Console integration to reply to your reviews on Android as well.

How to set up the App Store Connect integration

If your App Store Connect account has multifactor authorisation via an authenticator app or an SMS code, please follow these steps to set up the integration.

Sign in to App Store Connect and navigate to the Users and Access section.
Click the “+” button at the top of the user list. Users can be invited by anyone with Account Holder, Admin, or App Manager permissions in App Store Connect.

Enter the following details:

First name: Cloutly
Last name: Connect
Email: app-reviews@cloutly.com

Check the "Customer Support" box underneath Roles to ensur

Frequently Read Articles

Browse All Categories