Toevoegingen

De laatste personen die aan een campagne zijn toegevoegd.

Toegevoegd betekent dat Social Runner de persoon in de campagne heeft gezet, niet dat het connectieverzoek al verstuurd is. Dat gebeurt zodra die campagne aan de beurt is, binnen de ingestelde werkuren. In Social Runner staat een net toegevoegde persoon eerst als Not verified; die controle doet Social Runner zelf.

Organisaties

Een organisatie is de opdrachtgever. Daaronder hangen de Social Runner-accounts en de gebruikers. Verwijderen bestaat niet; zet iets op inactief.

Social Runner-accounts

Eén rij per LinkedIn-account in Social Runner, met het accountId en het API-token. Het token wordt versleuteld opgeslagen en is daarna nooit meer op te vragen, ook niet hier. Vergeten? Plak een nieuw token.

Gebruikers

Koppel elke gebruiker aan het Social Runner-account waarvoor hij toevoegt. Zonder koppeling ziet hij geen campagnes. Een nieuwe gebruiker krijgt meteen een welkomstmail met zijn eerste inloglink.

Waar deze tool voor is

Social Runner Connect is het leidingwerk tussen twee tools die je al hebt. In Prospect Driver verrijk je een contactpersoon. In Social Runner lopen je campagnes. Deze tool zorgt dat je zo iemand van de ene naar de andere stuurt, zonder gegevens over te typen en zonder opnieuw in te loggen.

Wat je hier doet is instellen. Het echte werk gebeurt in Prospect Driver en straks in de browserextensie op LinkedIn. Daarom kom je hier weinig, en daarom staat deze handleiding er.

De drie apps, en wat je waar doet

Voor gebruikers

Inloggen

Er is geen wachtwoord. Je vult je e-mailadres in, krijgt een link gemaild en klikt die aan. De link werkt één keer en is vijftien minuten geldig. Vraag je een nieuwe aan, dan vervalt de vorige meteen.

Zie je de mail niet, kijk dan in je spam. Blijft hij weg, vraag de beheerder om een nieuwe link te sturen.

Je campagnes

Op Mijn account staat namens welk Social Runner-account je toevoegt, met daaronder de campagnes waaruit je kunt kiezen. Gestopte campagnes staan er niet bij. Een campagne die net in Social Runner is aangemaakt verschijnt pas na een klik op Lijst vernieuwen.

Zie je geen campagnes en de melding dat er geen account gekoppeld is, dan moet de beheerder je aan een Social Runner-account koppelen.

Koppelen met Prospect Driver

1. Klik op Koppelcode aanmaken op Mijn account.
2. Kopieer de code meteen. Hij is daarna niet meer op te vragen, ook niet door ons.
3. Plak hem in Prospect Driver bij Mijn account.

Kwijt? Maak een nieuwe aan. De oude vervalt dan onmiddellijk en moet ook in Prospect Driver vervangen worden.

Wat toevoegen betekent

Toevoegen zet de persoon in de campagne. Het verstuurt geen connectieverzoek en geen bericht. Dat doet Social Runner zelf, zodra die campagne aan de beurt is, binnen de werkuren die daar zijn ingesteld. Campagnes wisselen elkaar af, dus reken op uren en niet op minuten.

In Social Runner staat een net toegevoegde persoon eerst als Not verified. Die controle doet Social Runner zelf.

Voor beheerders

Een nieuwe klant inrichten, in volgorde

1. In Social Runner: zoek het accountId en het API-token op van het LinkedIn-account van de klant. Je vindt ze onder Settings, LinkedIn account settings. Elk LinkedIn-account heeft een eigen token.
2. Hier, tabblad Beheer: maak de organisatie aan.
3. Hier: maak het Social Runner-account aan onder die organisatie, met het accountId en het token. De basis-URL laat je leeg, tenzij de klant rechtstreeks Salesflow gebruikt in plaats van Social Runner.
4. Hier: klik op Verbinding testen. Je hoort het aantal campagnes te zien. Krijg je een foutmelding over het token, dan hoort het token niet bij dit accountId of is het verlopen.
5. Hier: maak de gebruikers aan en koppel elk aan het juiste Social Runner-account. Zonder koppeling ziet iemand geen campagnes.
6. De gebruiker zelf: maakt een koppelcode aan en plakt die in Prospect Driver. Dat kun jij niet voor hem doen, want dan zou jij zijn code kunnen zien.

Rollen

Je kunt je eigen account niet op inactief zetten en je eigen rol niet verlagen. Dat is expres: anders kan één verkeerde klik het portaal onbeheerbaar maken.

Campagnenamen doen ertoe

Als iemand er niet in komt

1. Laat hem in zijn spam kijken.
2. Klik bij die gebruiker op Inloglink mailen.
3. Werkt dat niet, test dan of mailen überhaupt werkt: WordPress-beheer, SR Connect, Testmail versturen.
4. Staat de gebruiker op inactief, dan kan hij niet inloggen en krijgt hij ook geen link.

Verwijderen bestaat niet

Organisaties, accounts en gebruikers gaan op inactief, niet weg. Zo blijft het logboek van toevoegingen kloppen. Verwijder de plugin ook nooit via WordPress: dan wist uninstall.php alle instellingen, inclusief de verwijzingen naar de SharePoint-lijsten. Bijwerken doe je door de map te overschrijven en daarna de WP Rocket-cache te legen.

Bij een verhuizing of een nieuwe installatie

Dit doe je hooguit één keer. De details staan in het bouwdocument 20260828_Bouwdoc_Social_Runner_Connect_v1.md, hoofdstuk 15. Hieronder alleen de volgorde en de valkuilen, zodat je weet waar je moet zoeken.

1. SharePoint. Vier lijsten: SRC_Organisaties, SRC_Accounts, SRC_Gebruikers en SRC_Toevoegingen. Aanmaken met PnP.PowerShell volgens hoofdstuk 4, met vóór elke kolom een naamcontrole.
2. Indexen. Zet een index op Email in SRC_Gebruikers en op LinkedInIdentifier in SRC_Toevoegingen. Zonder index weigert Microsoft Graph het filter en werkt inloggen of dedup niet.
3. App-registratie met Sites.Selected en Mail.Send, beheerderstoestemming verleend, en een siterecht op alleen deze SharePoint-site.
4. Mailen. De app heeft in Exchange een service principal plus de rol Application Mail.Send nodig, beperkt tot het verzendpostvak. De oude App Access Policies zijn daarvoor vervangen door RBAC for Applications.
5. wp-config.php. Twee constanten: SRC_TOKEN_KEY voor het versleutelen van de Salesflow-tokens, en SRC_SERVICE_TOKEN_PD voor de koppeling met Prospect Driver. Die laatste moet aan beide kanten dezelfde waarde hebben.
6. Instellingen in WordPress-beheer, en daarna de knop Diagnose uitvoeren. Die zoekt de Graph Site ID zelf op en leest alle vier de lijsten.
7. De pagina. Een pagina met de slug srconnect en daarop de shortcode [srconnect_portaal].