Documentation · Platforms

Connecting Centra

Give Supportify read access to your Centra store so the chatbot can look up orders, track deliveries and start returns.

Centra connects differently from Shopify. There is no app to install and no OAuth screen — you create an Integration API token in Centra yourself and paste it into Supportify. It takes about five minutes, and the only fiddly part is ticking the right permissions, so this page lists them exactly.

Step 1: Create an Integration API token in Centra

In Centra, go to System → Api Tokens and click Create integration API token.

Fill in the top of the form:

  • Description — anything that will make sense to a colleague later, e.g. "Supportify AI".
  • Organization name — "Supportify".
  • Email — your own, so Centra can reach someone about the token.
  • Integration name — pick Supportify if it is in the list. If not, choose [ New ] and type `Supportify`.

Step 2: Limit the token to your consumer store

Under Restrictions, tick:

  • Store types → Direct to consumer
  • Stores → the store your webshop sells from (often named "Retail")

Supportify only ever answers questions about direct-to-consumer orders, so there is no reason to hand it your wholesale data. Most Centra accounts have exactly one DTC store even when the list looks long.

Step 3: Tick these permissions

Centra scopes tokens field by field, and a permission you miss does not fail at connect time — it fails weeks later, in the middle of a customer conversation. So it is worth being precise here.

Note that the two columns are named differently: read permissions read like `Order details`, while update permissions read like `Order:write`.

Read permissions

Orders and delivery:

  • `Order details`
  • `Order.shippingAddress`
  • `Order.billingAddress`
  • `Shipment details`
  • `Return details`

Customers:

  • `Customer details`
  • `Customer.billingAddress`
  • `Customer.totalOrders`

Products:

  • `Product details`
  • `ProductVariant details`
  • `ProductSize details`

Update permissions

  • `Order:write` — cancelling an order
  • `Payment.cancel:write` — also required to cancel an order
  • `OrderHistory:write` — writing a note on the order
  • `Return:write` — starting a return
  • `Customer:write` — correcting a customer address or phone number

Step 4: Copy the token now

Centra shows the token once. Copy it before you leave the page — if you lose it, the only way forward is to revoke it and create another.

Step 5: Find your Centra API URL

On the same Api Tokens page, Centra shows an Endpoint near the top. That is your API URL.

It is worth looking rather than guessing, because it is usually not the address bar you are currently on: the Centra admin often lives under a path, while the API sits at the plain domain.

Step 6: Paste both into Supportify

In Supportify, open Settings → Store connection, paste the API URL and the token, and save.

We test the token against Centra before storing it, so a wrong or under-permissioned token is rejected on the spot with the specific problem named — rather than being accepted and quietly failing later.


What your chatbot can do on Centra

Supportify offers only the tools your platform genuinely supports, so the chatbot never promises a customer something it cannot deliver. On Centra that means:

Available

  • Look up an order by number or email
  • Look up a customer and their order history
  • Track a delivery, including tracking numbers
  • Search products and answer questions about sizes and SKUs
  • Start a return — Centra has proper returns, and the chatbot can create one against the right shipment
  • Cancel an order
  • Correct a customer address or phone number
  • Everything that does not need your store at all: knowledge-base answers, support tickets, ratings

Not available

  • Discount codes. Centra stores a voucher's value in a free-form field with no fixed structure, and we would rather say nothing than quote a customer the wrong amount.
  • Refunds as a separate action. In Centra a refund happens through a return, which the chatbot can already create.
  • Editing or creating orders, and gift cards. These do not have a Centra equivalent that works the same way.

Putting the widget on your storefront

Centra is headless — your storefront is your own site rather than something Centra renders — so there is no theme editor to switch the widget on in. You add a small script to your site instead.

Open Embed code in Supportify, copy the snippet, and paste it into your site so it loads on every page. In most Next.js, Nuxt or Remix storefronts that means your root layout. It carries your own widget key, so nothing else needs configuring.

See Deploying the Chat Widget for what the widget looks like and how to style it.


When the token expires

If your token has an expiry date, we email you 14 days and 3 days before it arrives, and again on the day it lapses. Settings → Store connection shows the date and how long is left at any time.

To replace one: create a new token in Centra exactly as above, then use Reconnect on that same page. Nothing else about your setup changes — your knowledge base, conversation history and settings all stay put.