Aan de slag met BluePing

Drie dingen, meer niet:

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

Klik op Inloggen met Slack en kies je werkruimte. Slack vraagt om bevestiging; de rechten blijven beperkt tot berichten plaatsen, je kanalenlijst lezen en reageren op je commando's.

Daarna zet een korte wizard je klaar: Bol.com koppelen, kanaal kiezen, meldingen instellen, precies de stappen hieronder.

Een openbaar kanaal werkt meteen.

Een privékanaal moet je eerst uitnodigen. Typ daar:

/invite @BluePing

Sla je dit over, dan komt er niets binnen. Dit is de meest voorkomende reden voor gemiste meldingen.

BluePing leest je bestellingen via de officiële Bol.com Retailer API. Maak eenmalig een client id en secret aan, per winkel:

1. Log in op je Bol.com-verkoopaccount → Instellingen.
2. Diensten → API Instellingen → Client credentials voor de Retailer API.
3. Vul je technisch contactpersoon in (jezelf is prima). Zonder dit werken de credentials niet.
4. Aanmaken, geef een naam (bijv. BluePing), bevestig met Ja, voeg toe.
5. Kopieer de Client ID, klik Toon secret voor de Client secret, en bewaar beide veilig. Kwijt? Maak een nieuwe aan en verwijder de oude.

Dit zijn je live productiegegevens. Precies die voer je in BluePing in. Eén set geeft toegang tot je bestellingen, er zijn geen aparte scopes.

Meerdere winkels? Herhaal dit per winkel: 1 op Starter, tot 3 op Plus.

Plak je client id en secret in BluePing. We checken ze meteen live bij Bol.com, dus je weet direct of de koppeling klopt. Daarna slaan we ze versleuteld op en gebruiken we ze alleen om je bestellingen op te halen.

Geen foutmelding? Dan is de koppeling actief. Meerdere winkels? Herhaal stap 3 per winkel; voorraadmeldingen tonen per regel welk account het is.

Kies je standaardkanaal, bijv. #bol-bestellingen. Een eigen kanaal houdt je bestelstroom overzichtelijk. Openbaar werkt meteen; privé vraagt stap 2.

Bestelmeldingen staan standaard aan. Voorraadmeldingen zet je zelf aan, met een eigen drempel (standaard 5). Beide pas je later aan in je dashboard.

De eerste sync is stil: bestaande orders tellen niet mee, je hoort alleen van nieuwe bestellingen. Vanaf de eerstvolgende controle (~60 min op Starter, ~15 min op Plus) verschijnt elke order automatisch, met:

• het ordertotaal
• artikelen, aantallen en SKU
• de leverbelofte (bijv. LVB of 1-2 dagen)
• een link naar de bestelling in Bol.com

Verzonden of geannuleerd? BluePing reageert in de thread van het oorspronkelijke bericht.

Op Starter komt alles in één kanaal terecht, voor veel verkopers genoeg.

Op Plus stuur je elk type naar een eigen kanaal, bijv. bestellingen naar #bol-bestellingen en voorraad naar #voorraad. Plus checkt ook sneller (~15 min i.p.v. ~60), koppelt tot 3 winkels en stuurt 2.500 meldingen per maand. Gebruik je privékanalen? Nodig de bot overal apart uit met /invite @BluePing.

• Starter (€0/maand): 1 Bol.com-winkel, 200 meldingen per maand, één kanaal voor alles.
• Plus (€4,99/maand, excl. btw): tot 3 winkels, 2.500 meldingen, sneller ophalen en een apart kanaal per meldingstype.

Betalen via Lemon Squeezy (Merchant of Record). Opzegbaar wanneer je wilt; je houdt Plus tot het einde van de periode.

• Geen meldingen in een privékanaal? Typ /invite @BluePing in dat kanaal, de meest voorkomende oorzaak.
• Koppeling mislukt? Check of client id en secret exact kloppen (geen spaties) en bij het juiste account horen.
• Secret kwijt of gelekt? Maak in Bol.com een nieuwe credential aan en verwijder de oude.
• Technisch contactpersoon niet ingevuld? Zonder dat werken de credentials niet.
• Gekoppeld maar niets te zien? De eerste sync is stil: je hoort pas van orders ná het koppelen. Forceer een check met /blueping sync, of bekijk de status met /blueping status.

Kom je er niet uit? Mail ons, meestal binnen 2 werkdagen antwoord.

Je client id en secret staan versleuteld opgeslagen en worden alleen gebruikt om je bestellingen op te halen. Verkeer met Bol.com en Slack loopt via TLS. Elke werkruimte staat op zichzelf en ziet nooit andermans gegevens.

Stoppen of opschonen kan altijd:

• Account ontkoppelen: verwijder de koppeling in je BluePing-instellingen. Wil je ook de Bol-kant intrekken, verwijder dan de credential in je verkoopaccount.
• BluePing verwijderen: haal de bot uit je werkruimte; alle meldingen stoppen meteen.
• Gegevens laten verwijderen: mail info@blueping.app.

Welke gegevens heb ik nodig om te koppelen?

De Retailer API client id en secret van je Bol.com-account. We verifiëren ze live en slaan ze versleuteld op.

Hoeveel Bol.com-accounts kan ik koppelen?

Eén op Starter, tot drie op Plus. Voorraadmeldingen tonen per regel het account; orders worden per account ontdubbeld.

Moet ik per bestelling een nieuwe koppeling maken?

Nee, de credentials maak je eenmalig aan per winkel. BluePing regelt de rest.

Krijg ik een stortvloed aan meldingen bij het koppelen?

Nee. De eerste sync is stil; je hoort alleen van nieuwe 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), gebouwd op de officiële Bol.com Retailer API. Niet aangesloten bij Bol.com of Slack.