OpenAI (ChatGPT) koppelen aan Belco met een project API key

Met de OpenAI-integratie gebruik je BelcoAI binnen jouw Belco-shop. Je koppelt OpenAI met een project API key: een geheime sleutel die bij een OpenAI-project hoort.

Gebruik de stappen hieronder voor een project API key. De oude route via een persoonlijke API key is hiervoor niet meer nodig. In Belco vind je de integratie onder de naam ChatGPT.

Wat heb je nodig?

  • Een account op het OpenAI Platform met toegang tot de juiste organisatie en een project.
  • Een actieve API-betaalinstelling of beschikbaar API-tegoed bij OpenAI.
  • Toegang tot de integratie-instellingen van jouw Belco-shop.

Maak voor iedere Belco-shop een aparte API key aan. Meerdere keys kunnen bij hetzelfde OpenAI-project horen. Met een apart project voor Belco houd je de toegang en het verbruik overzichtelijk.

1. Controleer je API-tegoed

  1. Log in op het OpenAI Platform en controleer of je de juiste organisatie gebruikt.
  2. Open Billing via de instellingen.
  3. Stel zo nodig je betaalgegevens in en zorg voor voldoende API-tegoed voordat je de koppeling in Belco maakt.

Een ChatGPT-abonnement activeert de API-koppeling niet automatisch. Heb je recht op inbegrepen API-credits? Activeer deze dan eerst voor de juiste API-organisatie en controleer of ze beschikbaar zijn.

2. Kies of maak een OpenAI-project

  1. Open de projectkeuze bovenaan het OpenAI Platform.
  2. Selecteer een bestaand project, bijvoorbeeld Default project, of kies Create project voor een apart project.
  3. Maak je een nieuw project? Geef het een herkenbare naam, bijvoorbeeld Belco - Mijn webshop, controleer de overige instellingen en klik op Create.
OpenAI: een nieuw project aanmaken met de algemene voorbeeldnaam Belco - Mijn webshop

Voorbeeld met een algemene projectnaam.

3. Maak een project API key aan

  1. Open API keys en kies Create new secret key (Nieuwe geheime sleutel maken). In een smaller venster staat deze optie onder het actiemenu naast de paginatitel.
  2. Kies bij Owned by bij voorkeur Service account. Zo is de vaste koppeling niet afhankelijk van het persoonlijke account van een medewerker.
  3. Vul bij Service Key Name een herkenbare naam in, bijvoorbeeld Belco - Mijn webshop.
  4. Selecteer bij Project het project dat je voor Belco wilt gebruiken. Een project is verplicht.
  5. Kies de gewenste vervaldatum. Houd rekening met het sleutelbeleid van je organisatie.
  6. Klik op Create secret key.
OpenAI: project API key instellen met Service account, een algemene naam, projectkeuze en vervaldatum

Voorbeeld: een service account in Default project. De getoonde vervaldatum van 30 dagen is een voorbeeld.

Let op: kies je een vervaldatum van 30 dagen, dan verloopt je key na 30 dagen. Maak vóór die tijd een nieuwe key aan en vervang de key in Belco, zodat de koppeling blijft werken. Kies je Nooit, dan verloopt de key niet en hoef je hem niet vanwege een vervaldatum te wisselen. We raden Nooit niet aan.

Kopieer de volledige geheime sleutel direct. Je kunt deze later niet opnieuw bekijken. Bewaar de sleutel veilig, bijvoorbeeld in een wachtwoordmanager, en deel hem niet via e-mail, chat of screenshots. Gebruik in Belco de geheime API key, niet de project-ID.

Kun je geen project of service account aanmaken? Vraag dan je OpenAI-beheerder om de benodigde toegang of om een project key voor de koppeling.

4. Koppel de key aan jouw Belco-shop

  1. Open Belco of start de Belco-app.
  2. Ga via het tandwiel naar Instellingen → Integraties → AI → ChatGPT.
  3. Selecteer de shop die je wilt koppelen. De integratie wordt per shop ingesteld.
  4. Plak de volledige project API key in het veld API-sleutel, zonder extra spaties.
  5. Klik op Koppelen en controleer of Belco de koppeling bevestigt.
  6. Controleer daarna met een AI-functie in Belco of de koppeling werkt.

Verbruik bekijken en je key vervangen

Bekijk je API-verbruik bij Usage in OpenAI. Selecteer het juiste project om het verbruik terug te vinden. Je betaalinstellingen en beschikbare tegoed vind je bij Billing.

Vervang de key vóór de vervaldatum. Maak een nieuwe key in hetzelfde project, werk de koppeling in Belco bij en controleer of deze werkt. Trek de oude key pas daarna in bij OpenAI.

Lukt het koppelen niet? Controleer de geselecteerde shop, de volledige key, het juiste OpenAI-project, de geldigheid en rechten van de key en je beschikbare API-tegoed. Neem gerust contact met ons op als je hulp nodig hebt. Stuur je geheime API key niet mee.

Meer informatie: OpenAI-documentatie over API keys en service accounts en API-credits bij een ChatGPT-abonnement.


Hoe hebben we het gedaan?


Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)