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
- Log in op het OpenAI Platform en controleer of je de juiste organisatie gebruikt.
- Open Billing via de instellingen.
- 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
- Open de projectkeuze bovenaan het OpenAI Platform.
- Selecteer een bestaand project, bijvoorbeeld Default project, of kies Create project voor een apart project.
- Maak je een nieuw project? Geef het een herkenbare naam, bijvoorbeeld Belco - Mijn webshop, controleer de overige instellingen en klik op Create.

Voorbeeld met een algemene projectnaam.
3. Maak een project API key aan
- 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.
- Kies bij Owned by bij voorkeur Service account. Zo is de vaste koppeling niet afhankelijk van het persoonlijke account van een medewerker.
- Vul bij Service Key Name een herkenbare naam in, bijvoorbeeld Belco - Mijn webshop.
- Selecteer bij Project het project dat je voor Belco wilt gebruiken. Een project is verplicht.
- Kies de gewenste vervaldatum. Houd rekening met het sleutelbeleid van je organisatie.
- Klik op Create secret key.

Voorbeeld: een service account in Default project. De getoonde vervaldatum van 30 dagen is een voorbeeld.
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
- Open Belco of start de Belco-app.
- Ga via het tandwiel naar Instellingen → Integraties → AI → ChatGPT.
- Selecteer de shop die je wilt koppelen. De integratie wordt per shop ingesteld.
- Plak de volledige project API key in het veld API-sleutel, zonder extra spaties.
- Klik op Koppelen en controleer of Belco de koppeling bevestigt.
- 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.