Zodra je een groep precies naar wens hebt afgestemd, hoef je die opzet niet in elke andere groep met de hand opnieuw op te bouwen. Met de REST API van Telm kun je de instellingen, moderatieregels en whitelist van een groep uitlezen en ze in een andere groep schrijven, zodat een bewezen configuratie een sjabloon wordt dat je overal kunt uitrollen. Het is de voor de hand liggende optie voor bureaus en iedereen die meerdere communities onder één beleid beheert. De volledige API is inbegrepen bij Pro en hoger; je bestuurt hem met een API-sleutel die je in het dashboard aanmaakt.
Wil je dit instellen? Doe het direct in je Telm-account.
Openen in je dashboard1Waarom een configuratie kopiëren
Een groep goed afstemmen kost tijd — je stelt de antispamgevoeligheid in, voegt de moderatieregels toe die bij je community passen en bouwt een whitelist op van mensen die nooit geraakt mogen worden. Dat allemaal met de hand in de volgende groep opnieuw maken is traag en foutgevoelig.
Het kopiëren van de configuratie lost dat op. Je legt een opzet vast die al werkt en reproduceert die in seconden. Het is ideaal voor bureaus die één standaardbeleid over veel communities toepassen, voor het opzetten van nieuwe chats vanuit een sjabloongroep, en voor het bewaren van een veilige momentopname van een configuratie waarop je vertrouwt.
2Wat je kunt kopiëren
Drie onderdelen van een groep bepalen het grootste deel van zijn gedrag, en elk kan uit de ene groep worden gelezen en naar de andere worden geschreven:
- Groepsinstellingen — antispamgevoeligheid, welkom, taal en elke schakelaar die in de groepsconfiguratie is opgeslagen.
- Moderatieregels — de naam, het type, de voorwaarden, acties, prioriteit en aan/uit-status van elke aangepaste regel.
- Whitelist — de lijst met leden die van moderatie zijn vrijgesteld.
3Hoe het werkt met de API
Telm biedt een gewone REST API op api.telm.com/api/public/v1. Je leest uit de brongroep en schrijft naar de doelgroep met gewone HTTPS-verzoeken — vanuit elke taal, of rechtstreeks vanuit je terminal met curl.
Voor instellingen haal je ze op uit de brongroep en stuur je ze met één enkele PATCH naar het doel — de waarden die je verstuurt, worden samengevoegd in de configuratie van het doel. Voor regels en de whitelist som je de vermeldingen op de brongroep op en maak je dezelfde aan op het doel. De werking, authenticatie en quota worden behandeld in De Telm REST API.
4Wat je nodig hebt
Je hebt een API-sleutel nodig, die je in het dashboard aanmaakt, en een plan dat volledige API-toegang bevat — dat is Pro en hoger. Lees meer in De Telm REST API.
De sleutel erft je toegang, dus hij kan alleen groepen aanraken die je al beheert. Dat houdt configuratieoverdrachten beperkt tot je eigen account.
5Praktische tips
Bewaar de antwoorden die je uit een groep leest als gewone JSON-bestanden — ze zijn een momentopname die je op elk moment opnieuw kunt toepassen om een groep terug te zetten naar een bekende goede staat.
Rol eerst uit naar één groep en controleer die voordat je dezelfde configuratie over de rest toepast. Het is veel makkelijker om een verrassing op één chat te betrappen dan op twintig.
Om te beslissen welke groepen je synchroon wilt houden, zie eerst Meerdere groepen beheren.