Deze integratie is beschikbaar vanaf het Integrate-plan.
Speakap leden ontvangen voorgestelde posts vanuit Apostle als chatbericht in Speakap. Deze chats worden verstuurd vanuit één nieuw aangemaakte Speakap-gebruiker. De koppeling bestaat uit twee delen: eerst voeg je de Apostle-applicatie toe in Speakap, daarna koppel je de Speakap-connector in Apostle.
Wat heb je nodig?
Onderweg verzamel je vier gegevens die je invult in Apostle.
Gegeven | Waar vind je het? | Goed om te weten |
APP ID | Melding direct na het toevoegen van de applicatie in Speakap | Eenmalig zichtbaar, direct vastleggen |
APP SECRET | Melding direct na het toevoegen van de applicatie in Speakap | Eenmalig zichtbaar, direct vastleggen |
NETWORK ID | Tandwiel-icoon bij de applicatie in Speakap Market | Kun je later opnieuw ophalen |
API_KEY | Aanvragen via Speakap Support | Niet zelf te achterhalen of aan te maken. Nodig voor het versturen van chats |
💡 Tip: Vraag de API_KEY aan bij Speakap Support voordat je begint. Je hebt hem nodig in stap 3 en het is het enige gegeven waarvoor je van iemand anders afhankelijk bent.
Stap 1: De applicatie toevoegen in Speakap
Ga in je Speakap-omgeving naar Settings en vervolgens Network settings.
Ga naar Speakap Market.
Klik op + Application.
Kies Add your own application.
Plak het onderstaande manifest in het invoerscherm dat opent.
Klik op Add application.
Er opent een melding met de APP ID en de APP SECRET. Leg beide direct vast.
Kies Entire network om het venster te sluiten.
⚠️ Belangrijk: De APP ID en APP SECRET kun je na het sluiten van de melding niet meer opvragen. Ben je ze kwijt, dan moet je de applicatie opnieuw toevoegen.
Manifest om te plakken in stap 5:
{
"name": { "en-US": "Apostle Social", "nl-NL": "Apostle Social" },
"icon": "https://assets.apostle.social/logo-bordered.png",
"permissions": ["send_alerts", "post_updates", "get_profiles", "upload_files"],
"entries": [
{
"position": "main",
"devices": "desktop",
"url": "https://staging.api-apostle.com/speakap/entry",
"label": { "en-US": "Apostle Social", "nl-NL": "Apostle Social" },
"icon": "https://assets.apostle.social/logo-bordered.png",
"responsive": true,
"hasMenuItem": false
},
{
"position": "main",
"devices": "ios",
"url": "https://staging.api-apostle.com/speakap/entry",
"label": { "en-US": "Apostle Social", "nl-NL": "Apostle Social" },
"icon": "https://assets.apostle.social/logo-bordered.png",
"responsive": true,
"hasMenuItem": false
},
{
"position": "main",
"devices": "android",
"url": "https://staging.api-apostle.com/speakap/entry",
"label": { "en-US": "Apostle Social", "nl-NL": "Apostle Social" },
"icon": "https://assets.apostle.social/logo-bordered.png",
"responsive": true,
"hasMenuItem": false
},
{
"position": "settings-page",
"devices": "desktop",
"url": "https://staging.api-apostle.com/speakap/settings",
"lightboxTemplate": "close"
}
]
}
Stap 2: De NETWORK ID ophalen
Klik in Speakap Market bij de zojuist gemaakte applicatie op het tandwiel-icoon.
Er opent een pop-up met daarin je NETWORK ID. Leg deze vast.
Je kunt de NETWORK ID op deze manier op elk moment opnieuw ophalen.
Stap 3: De connector aanmaken in Apostle
Ga naar Integration Connectors.
Klik op Add connector en kies Speakap.
Vul de APP ID, APP SECRET, NETWORK ID en API_KEY in.
Stap 4: Een Speakap-gebruiker koppelen voor chats
Apostle verstuurt voorgestelde posts via de chat van Speakap. De chats worden vanuit één Speakap-gebruiker verstuurd naar alle gekoppelde ambassadeurs. Daarom moet je deze gebruiker koppelen in Apostle.
⚠️ Belangrijk: Log niet in met je eigen account, want je kunt geen chats naar jezelf sturen. Ons advies is om in Speakap een extra gebruiker aan te maken en die “Apostle Social” te noemen. Vanuit dit account ontvangen de ambassadeurs hun voorgestelde posts in de chat.
Maak in Speakap een nieuwe gebruiker aan en noem deze “Apostle Social”.
Ga in Apostle naar de Speakap-connector. Zodra je de API_KEY hebt ingevuld, verschijnt er een sleutel-icoon bij de connector.
Klik op het sleutel-icoon. Het venster Connect Speakap opent.
Vul de gebruikersnaam en het wachtwoord in van de gebruiker die je zojuist hebt aangemaakt.
Klik op Connect.
Controleer na een succesvolle login hoe lang het chat token geldig is en welk account is gekoppeld.
Let op: Wil je een ander account koppelen? Vul dan nieuwe inloggegevens in om het huidige account te vervangen. Klik op Remove login om het gekoppelde account te verwijderen.
Stap 5: Gebruikers synchroniseren
Klik bij de connector op Users.
Start de synchronisatie. Bestaande Speakap-gebruikers worden automatisch aangemaakt en gekoppeld in Apostle.
Na de eerste synchronisatie verloopt alles automatisch:
Nieuwe Speakap-gebruikers worden aangemaakt in Apostle.
Wijzigingen in voornaam, achternaam of e-mailadres worden doorgevoerd.
Verwijderde gebruikers worden ook uit Apostle verwijderd.
⚠️ Belangrijk: Synchroniseer gebruikers altijd eerst voordat je posts verstuurt. Dit geldt voor zowel bestaande Apostle-gebruikers als nieuw geïmporteerde Speakap-gebruikers.
Posts versturen via Speakap
Het inplannen van posts verloopt zoals je gewend bent in Apostle. Er zijn geen extra acties vereist om een post via Speakap aan te bieden aan gesynchroniseerde leden.
Stel een post samen via Create post.
Wijs in Choose Channels de variaties toe aan de juiste leden.
Bepaal je datum en tijdstip.
Klik op Plan this post.
⚠️ Belangrijk: Een gesynchroniseerde Speakap-gebruiker ontvangt geen e-mails meer met voorgestelde posts en kan alleen via Speakap plaatsen. Dit is bewust, omdat Speakap-leden Apostle niet kennen en alles vanuit hun vertrouwde omgeving kunnen doen.
💡 Tip: Verstuur een testpost eerst alleen aan jezelf om de volledige flow te controleren voordat je de post naar je leden stuurt.
Bedrijfspagina’s en kanalen
Als je in Apostle bedrijfspagina’s hebt gekoppeld, worden voorgestelde posts voor die pagina’s ook aangeboden via Speakap. Leden ontvangen deze posts op dezelfde manier als persoonlijke posts, via de chat.
Welke kanalen beschikbaar zijn, hangt af van de pagina’s die je hebt gekoppeld in Apostle. Mogelijke kanalen zijn:
Persoonlijk LinkedIn
Bedrijfspagina LinkedIn
Bedrijfspagina Facebook
Bedrijfspagina Instagram
Bedrijfspagina X
Let op: Posten naar persoonlijke Facebook- en Instagram-accounts is vooralsnog via Speakap niet mogelijk.
Statistieken
Posts die via Speakap worden gedeeld, zijn zichtbaar in Team insights en Post insights. Alle statistieken worden opgehaald, waaronder bereik en engagement per post en per gebruiker. Het is momenteel nog niet mogelijk om te filteren op of een post via Speakap of via een ander kanaal is gedeeld.
Let op: Posts die via Speakap worden gedeeld, worden geregistreerd als gedeeld via mail.