Use HumanMeter inside Gorgias

Connect with one click

We add the integration, the sidebar card and a reply macro to your Gorgias account for you. You need to be logged in to HumanMeter in this browser.

Prefer to set it up yourself? Follow the steps below instead. They do the same thing.

Before you start

1. A HumanMeter Claims account. No account yet? Start a free trial. It takes a minute and needs no card.
2. Your HumanMeter API key. You saw it when you signed up. Lost it? Get a new one on your dashboard under API key.
3. Admin access to your Gorgias account. Only the account owner and admins can add an HTTP integration.

If you paste it here, we fill it into the steps below so you can copy everything as is. It stays on this page and is never sent anywhere.

1. In Gorgias, click the Settings icon in the bottom left corner.
2. Under Account, click HTTP integration. If you can't find it, type "HTTP" in the settings search.
3. Open the Manage tab and click Add HTTP integration.
4. Fill in the form. Use the copy buttons so nothing gets mistyped.
   Integration name

   HumanMeter photo check

   Copy
   URL

   https://human-meter-server.onrender.com/v1/gorgias/ticket

   Copy
   HTTP method

   POST
   Request content type

   application/json
   Header key

   Authorization

   Copy
   Header value

   Bearer YOUR_API_KEY

   Copy

   Replace YOUR_API_KEY with your HumanMeter API key. Keep the word Bearer and the space after it.

   Request body

   { "ticket_id": "{{ticket.id}}", "order_ref": "{{ticket.customer.integrations.shopify.orders[0].name}}" }

   Copy

   The order line pulls the customer's latest Shopify order number. Not on Shopify? Leave it in anyway. The order number just stays blank.

5. Under triggers, tick Ticket created, Ticket updated and Ticket message created.

   Don't tick "Ticket assignment updated" or "Ticket status updated". Gorgias turns the other triggers off when you pick either of those.

6. Click Add integration.
7. Look at your browser's address bar. It ends in a number, like .../http/48213. That's your integration number. Type it here, and we'll put it into step 3 for you:
   Integration number

1. Open any ticket. Gorgias only calls HumanMeter when a ticket changes, so add any tag to the ticket (for example "damage"), then refresh the page.
2. In the right sidebar, click the gear icon to edit the sidebar.
3. Click Custom integrations, find HumanMeter photo check, and drag it into the sidebar.
4. Remove the fields you don't need and rename the rest. We suggest keeping these:

   Field	Rename to	What it shows
   risk_label	Risk	Low risk, Needs review, High risk, or No photos yet
   reasons	Why	The reasons behind the risk level, in plain words
   link_status	Photo link	Whether the customer has opened the link and sent photos
   photos_taken	Photos	How many photos the customer took (up to 3)
   ticket_id	Ticket	Which ticket this result belongs to
   open_in_humanmeter	Open in HumanMeter	Opens this claim and its photos on your dashboard
   account_notice	Account	Only filled in if your trial or plan needs attention

5. Click Save, then leave edit mode.

1. In Gorgias, go to Settings, then Macros, and click Create macro.
2. Name it:
   Send HumanMeter photo link

   Copy
3. Paste this as the response text. Edit the wording if you like, but keep the line with the link exactly as it is.
   Copy

   Replace INTEGRATION_NUMBER with the number from step 1.

4. Click Create macro.

1. Email your support address from your own email, saying something like "my mug arrived broken".
2. Open that ticket in Gorgias. The HumanMeter card should say No photos yet and Not opened yet.
3. Apply the Send HumanMeter photo link macro. Check that a link starting with https://humanmeter.app/c/ appears in the reply, then send it.
4. Open the link on your phone and take a photo. Reply to the email, and the card updates to show the risk level.

Link missing from the reply? The ticket probably hasn't loaded the HumanMeter data yet. Add a tag, refresh the page and apply the macro again. If it's still blank, check the integration number in the macro, and check the Account field in the sidebar in case your trial or plan needs attention.

What the risk levels mean

The customer never sees the risk level. They only see your store name, the order number and the camera.