Aan de slag met BluePing

Drie dingen, meer niet:

• Een Slack-werkruimte waarin je een app mag installeren.
• Een kanaal waar je je meldingen wilt ontvangen (bestaand of nieuw).
• Een geverifieerd Bol.com-verkoopaccount met toegang tot de Retailer API.

Reken op zo'n vijf minuten. Je kunt op elk moment stoppen en later verder.

Klik op Inloggen met Slack en kies de werkruimte waarin BluePing moet plaatsen. Slack vraagt je de installatie te bevestigen; de rechten blijven beperkt tot het plaatsen van berichten en het reageren op je commando's.

Kies daarna het kanaal waar je je bestellingen wilt ontvangen, bijvoorbeeld #bol-bestellingen. Een eigen kanaal werkt het prettigst: zo blijft je bestelstroom apart van de rest. Een openbaar kanaal werkt meteen.

Nog niet live: zolang BluePing in de laatste testfase zit, zie je hier "Binnenkort beschikbaar". Mail ons en je hoort als eerste wanneer je kunt installeren.

Voor een openbaar kanaal hoef je niets extra's te doen.

Wil je een privékanaal gebruiken? Dan kan BluePing daar pas plaatsen nadat je de bot hebt uitgenodigd. Typ in dat kanaal:

/invite @BluePing

Zonder die uitnodiging ziet BluePing het privékanaal niet. Dit is veruit de meest voorkomende reden dat er geen meldingen binnenkomen.

BluePing leest je bestellingen via de officiële Bol.com Retailer API. Daarvoor maak je in je verkoopaccount eenmalig een client id en secret aan. Dat doe je per winkel:

1. Log in op je Bol.com-verkoopaccount en open Instellingen.
2. Ga onder Diensten naar API Instellingen en scroll naar Client credentials voor de Retailer API.
3. Vul eenmalig je technisch contactpersoon in (jezelf is prima). Zonder contactgegevens werken de credentials niet.
4. Klik op Aanmaken, geef de credential een herkenbare naam, bijvoorbeeld BluePing, en bevestig met Ja, voeg toe.
5. De Client ID verschijnt direct. Klik op Toon secret om in een pop-up de Client secret te zien.

Kopieer beide waarden meteen en bewaar ze veilig. De secret is gevoelig en wordt niet zonder reden opnieuw getoond. Kwijt? Maak gewoon een nieuwe credential aan en verwijder de oude.

Goed om te weten: de Retailer API kent op dit moment geen losse rechten of scopes: één client id en secret geeft toegang tot je bestellingen, je hoeft niets extra's aan te zetten. De gegevens die je hier aanmaakt zijn je live (productie) gegevens; precies die voer je in BluePing in.

Meerdere winkels? Credentials gelden per verkoopaccount, dus maak per winkel een aparte set aan. Op Gratis koppel je 1 account, op Premium tot 5.

Plak je client id en secret bij het koppelen van je Bol.com-account in BluePing.

We controleren ze meteen live bij Bol.com, zodat je direct weet of de koppeling klopt. Daarna worden ze versleuteld opgeslagen en alleen gebruikt om je bestellingen op te halen.

Geen foutmelding? Dan is de koppeling actief. Koppel je meerdere winkels, herhaal stap 3 dan per winkel; elke melding toont straks bij welk account de bestelling hoort.

Zodra je gekoppeld bent, gaat BluePing aan de slag. De eerste sync is stil: bestaande, oude bestellingen tellen niet mee, zodat je kanaal niet volloopt. Je hoort alleen van nieuwe bestellingen.

Binnen enkele minuten staat elke nieuwe bestelling automatisch in je kanaal, je hoeft niets te typen. Elke melding toont:

• het bestelnummer en type (FBR = eigen verzending, FBB = Door Bol Verzonden);
• de accountnaam, zodat je weet om welke winkel het gaat;
• de artikelen met aantallen (en EAN of SKU);
• de uiterste verzenddatum.

Is een bestelling verzonden of geannuleerd? Dan reageert BluePing in de thread van het oorspronkelijke bericht, zodat alles bij elkaar blijft.

Naast losse meldingen stuurt BluePing tweemaal daags een verzendoverzicht: standaard om 08:00 en 15:00 (Europe/Amsterdam).

Dat overzicht toont de FBR-bestellingen die vandaag of te laat de deur uit moeten, urgentste eerst. FBB-bestellingen (Door Bol Verzonden) blijven hierbuiten, die regelt Bol zelf.

Zo mis je nooit een verzenddeadline.

Op Gratis komen alle meldingen samen in één kanaal. Voor veel verkopers is dat genoeg.

Wil je meer overzicht? Op Premium stuur je elk meldingstype naar een eigen kanaal: bijvoorbeeld bestellingen naar #bol-bestellingen, verzenddeadlines naar #verzenden en voorraadwaarschuwingen naar #voorraad.

Premium controleert ook sneller op nieuwe bestellingen (elke ~5 minuten in plaats van ~90), koppelt tot 5 winkels en stuurt onbeperkt meldingen. Nodig de bot wel met /invite @BluePing uit in elk privékanaal dat je gebruikt.

• Gratis (€0/maand): 1 Bol.com-winkel, 250 meldingen per maand, één kanaal voor alles.
• Premium (€4,99/maand, excl. btw): tot 5 winkels, onbeperkt meldingen, sneller ophalen en een apart kanaal per meldingstype.

Betalen verloopt via Lemon Squeezy, onze Merchant of Record. Opzegbaar wanneer je wilt; je houdt Premium tot het einde van de lopende periode.

Loop deze punten langs voordat je contact opneemt:

• Geen meldingen in een privékanaal? Typ /invite @BluePing in dat kanaal. Dit is veruit de meest voorkomende oorzaak.
• Koppeling mislukt of foutmelding bij het invoeren? Controleer of je client id en secret exact zijn overgenomen (zonder extra spaties) en bij het juiste verkoopaccount horen.
• Secret kwijt of vermoeden van een lek? Maak in Bol.com een nieuwe credential aan en verwijder de oude.
• Technisch contactpersoon ingevuld? Zonder die gegevens werken de Bol.com-credentials niet.
• Wel gekoppeld, maar nog niets te zien? De eerste sync is stil; je hoort alleen van bestellingen die ná het koppelen binnenkomen. Met /blueping sync forceer je een controle, en /blueping status toont je gekoppelde winkels, je meldingenstand en je plan.

Kom je er niet uit? Mail ons op info@blueping.app, we reageren doorgaans binnen 2 werkdagen.

Je client id en secret worden versleuteld opgeslagen (encryptie in rust) en uitsluitend gebruikt om je bestellingen op te halen, nooit voor iets anders. Het verkeer met Bol.com en Slack loopt versleuteld (TLS). Elke Slack-werkruimte staat op zichzelf en ziet nooit de gegevens van een ander.

Wil je stoppen of opschonen? Dat kan op elk moment:

• Een Bol.com-account ontkoppelen: verwijder de koppeling in je BluePing-instellingen. Wil je de toegang ook aan de Bol-kant intrekken, verwijder dan de bijbehorende credential in je Bol.com-verkoopaccount.
• BluePing volledig verwijderen: haal de bot uit je Slack-werkruimte. Daarmee stoppen alle meldingen.
• Je gegevens laten verwijderen: vraag dit aan via info@blueping.app.

Welke gegevens heb ik nodig om te koppelen?

De Retailer API client id en secret van je Bol.com-account. BluePing verifieert ze live en slaat ze versleuteld op.

Hoeveel Bol.com-accounts kan ik koppelen?

Eén op Gratis, tot vijf op Premium. Elke melding toont het account; bestellingen worden per account ontdubbeld.

Moet ik per bestelling een nieuwe koppeling maken?

Nee. Je maakt de credentials één keer aan per winkel. BluePing regelt de rest automatisch.

Krijg ik een stortvloed aan meldingen bij het koppelen?

Nee. De eerste sync is stil; je hoort alleen van nieuwe bestellingen.

Kan ik de tijden van het verzendoverzicht aanpassen?

Standaard staat het op 08:00 en 15:00 (Europe/Amsterdam) voor je openstaande FBR-bestellingen.

• Privacyverklaring: wat we verzamelen, hoe we het beveiligen en hoe je je gegevens laat verwijderen.
• Voorwaarden: de afspraken bij het gebruik van BluePing.
• Restitutiebeleid: hoe terugbetalingen via Lemon Squeezy verlopen.

BluePing is een onafhankelijk product van Hakkens Trading (KvK 67549640) en gebruikt de officiële Bol.com Retailer API. Niet aangesloten bij of goedgekeurd door Bol.com of Slack.