Blog

Een chat-API kiezen: wat je vergelijkt voordat je bouwt

· Andrij Tkachenko · 12 min leestijd

Een klembord met een checklist, drie vakjes aangevinkt en één nog leeg, naast twee chatvensters, één met een database eronder en één met een hangslot

Kies een chat-API op wat die bij jou laat en op wat die telt: waar je berichten worden bewaard, wie bepaalt wie aan wie mag schrijven, waarmee de rekening groeit, en wat een pagina terugkrijgt nadat ze haar verbinding is kwijtgeraakt. Typindicatoren, leesbevestigingen en reacties staan op elke functielijst, dus ze onderscheiden diensten veel minder van elkaar dan die vier antwoorden.

Dit artikel loopt tien vragen door die je aan elke chat-API of chat-SDK stelt, met waarom elke vraag ertoe doet en hoe je het antwoord zelf controleert. Het noemt geen enkele dienst. Aan het eind beantwoordt het elke vraag voor WordPlus Cloud, met wat het aan jou overlaat.

Chat-API, chat-SDK of realtime API

De woorden worden losjes gebruikt, en er worden twee verschillende soorten diensten onder verkocht.

Een chatbackend bewaart de chat voor je. Je gebruikers, hun gesprekken en elk bericht staan in de database van de dienst, en je app vraagt ze op via de API ervan. Een realtime API brengt berichten over tussen de pagina’s en apps die open zijn, en bewaart weinig of niets. De gesprekken blijven in je eigen database, en je server zegt wie er in elk gesprek mag zijn.

Een chat-SDK is geen derde soort. Het is de bibliotheek voor één taal of platform die een van de twee omhult, vaak met een kant-en-klaar chatscherm, zodat je de verbinding, de nieuwe pogingen en de berichtenlijst niet zelf schrijft.

Chatbackend Realtime API
Berichten worden bewaard In zijn database In de jouwe
Wie mag praten, wordt bepaald In zijn instellingen Door je server
Je schrijft Eerst weinig Een tabel en twee routes

Geen van de twee is de betere soort. De eerste is sneller op dag één, en de tweede laat je later minder te ontwarren. De meeste van de tien vragen hieronder komen neer op welke van de twee je voor je hebt.

1. Waar worden de berichten bewaard?

Uit dit antwoord volgen de andere. Berichten in de database van een dienst hebben vanaf dag één een geschiedenis en een zoekfunctie. Ze staan ook los van de rest van je gegevens. Een rapport dat gesprekken aan bestellingen koppelt, een moderatorscherm in je eigen beheeromgeving, of een regel over hoe lang een bericht wordt bewaard: elk ervan hangt af van wat de API van de dienst je laat doen.

De privacywet stelt dezelfde vraag. Onder de AVG kan iemand vragen om zijn gegevens te laten wissen, en om ze in een machineleesbaar formaat te ontvangen, zoals de Europese Commissie opsomt bij de rechten van personen. Een chat bevat veel persoonsgegevens, dus waar de berichten ook staan, je hebt een manier nodig om die van één persoon te verwijderen en te exporteren.

Vraag na:

  • Kan ik elk gesprek exporteren, in een gedocumenteerd formaat, op het abonnement dat ik zou nemen?
  • Kan ik de berichten van één gebruiker verwijderen via de API?
  • Hoe lang wordt de geschiedenis bewaard op elk abonnement, en wat gebeurt ermee als ik vertrek?

2. Wie bepaalt wie aan wie mag schrijven?

Bij elke dienst ondertekent je server een token dat zegt wie de gebruiker is. Het verschil zit in waar de regels staan. Sommige diensten bewaren gebruikers, rollen en lidmaatschappen in hun eigen instellingen, dus je app moet elk nieuw lid, elke blokkade en elke verbanning naar de dienst kopiëren en de twee gelijk houden. Andere vragen het aan je server, elke keer dat een pagina een gesprek in wil, en je code antwoordt uit de gegevens die je al hebt.

Vraag na:

  • Als iemand in mijn database wordt geblokkeerd of een groep verlaat, hoe snel houdt de chat diegene dan tegen?
  • Kan een pagina schrijven als een andere gebruiker, of zet de dienst zelf de afzender op elk bericht?
  • Kan een lid lezen zonder te kunnen schrijven?

3. Wat telt de rekening?

Chatdiensten tellen een van drie dingen: de gebruikers die in een maand actief zijn, de berichten, of de verbindingen die op hetzelfde moment open zijn. De eenheid doet er meer toe dan de prijs ervan, want elk van de drie groeit met iets anders. Ons artikel over prijzen voor realtime rekent één chat door onder elk model.

Maandelijks actieve gebruikers tellen klinkt eenvoudig, tot je de definitie leest. Meestal telt iedereen die in de maand één keer verbinding maakt voor de hele maand. Veel abonnementen begrenzen ook hoeveel van hen op hetzelfde moment verbonden mogen zijn, op een klein deel van het maandelijkse aantal.

Vraag na:

  • Wie telt als actief, en telt iemand op een telefoon en een laptop één of twee keer?
  • Worden typindicatoren, leesbevestigingen en wie er online is als berichten geteld?
  • Wat gebeurt er boven het abonnement: wordt de app afgesloten, vertraagd of het extra gebruik gefactureerd?

4. Wat komt er terug na een verbroken verbinding?

Telefoons wisselen van netwerk, laptops gaan in slaap en servers krijgen een deploy, dus elke chat raakt zijn verbinding vele keren per dag kwijt. De websocket eronder doet daar niets aan. De standaard ervan zegt alleen dat een client hoort te wachten voordat hij opnieuw verbinding maakt, langer na elke mislukte poging, en kent geen manier om een verbinding te hervatten of opnieuw te versturen wat er gemist is. Alles wat een pagina terugkrijgt, is het werk van de dienst.

Vraag na:

  • Krijgt een pagina die opnieuw verbinding maakt wat ze gemist heeft, in de juiste volgorde, en niets dubbel?
  • Hoe ver gaat dat terug: een minuut, een uur, alles?
  • Wordt een bericht dat offline is geschreven later verstuurd, of gaat het ongemerkt verloren?
  • Heeft elk bericht een id, zodat je code een herhaling kan weggooien?

Maakt een chat helemaal geen verbinding, dan laat ons artikel over mislukte websocketverbindingen zien hoe je vindt wat de verbinding sloot.

5. Kan de dienst de berichten lezen?

Elke serieuze dienst versleutelt de verbinding, zodat niemand op het netwerk ertussen meeleest. De vraag is wat de dienst zelf ziet. De meeste zien elk bericht als leesbare tekst, en daardoor kunnen ze het doorzoeken, filteren en de woorden ervan in een melding zetten. Een paar vervoeren berichten verzegeld met sleutels die ze zelf nooit hebben.

Het is een echte afweging. Een dienst die je berichten niet kan lezen, kan ze ook niet voor je doorzoeken of filteren, dus dat werk verschuift naar jouw kant.

Vraag na:

  • Wie heeft de sleutels: de dienst, mijn server, of alleen de apparaten van de mensen die praten?
  • Staat het vanaf het begin aan, of is het een extra op een hoger abonnement?
  • Geldt het ook voor bestanden, de geschiedenis en de lijst van wie er in een gesprek zit?

6. Is er een kant-en-klare chat, en kun je die aanpassen?

Een kant-en-klaar chatscherm bespaart weken: de berichtenlijst, het invoerveld, de scrollpositie, de scheidingen tussen dagen en honderd kleine toestanden. Het kan ook het deel zijn waarmee je later vecht, wanneer het eruit moet zien als de rest van je app.

Vraag na:

  • Welke platforms hebben er een: het web, React, iOS, Android?
  • Kan ik de kleuren en teksten aanpassen, en één onderdeel vervangen, zoals het bericht zelf, zonder alles opnieuw te bouwen?
  • Kunnen een eigen scherm en het kant-en-klare in hetzelfde gesprek zitten?
  • Werkt het van rechts naar links, in de donkere modus en met alleen een toetsenbord?

7. Welke functies heeft je product nodig?

Typindicatoren, leesbevestigingen, reacties, wie er online is, bestanden, antwoorden, vermeldingen, bewerkingen: elke lijst heeft de meeste ervan. Tel ze niet. Kies de drie waar je product niet zonder kan, en test precies die.

Twee verdienen een nadere blik:

  • Bestanden. Gaan ze naar de opslag van de dienst, met zijn limieten op grootte en op hoe lang ze worden bewaard, of naar de jouwe?
  • Mensen die weg zijn. Een bericht verschijnt alleen meteen waar de chat open is. Wat bereikt iemand bij wie elke pagina dicht is: een pushmelding, een e-mail, of een webhook waarmee je server een van beide kan sturen?

8. Hoe modereer je?

Elke chat die openstaat voor vreemden heeft iemand nodig die kan dempen, verwijderen en verbannen. Die acties moeten werken op iemand die nu verbonden is, niet pas vanaf het volgende bezoek. Daarbuiten verschillen diensten in wat ze zelf doen. Sommige filteren woorden of geven elk bericht een score, wat alleen een dienst kan die de berichten leest.

Vraag na:

  • Gaat een verbanning meteen in, voor iemand die al in de ruimte zit?
  • Kan ik gemelde berichten zien in mijn eigen beheeromgeving, met mijn eigen gegevens ernaast?
  • Als de dienst berichten filtert, kan ik dat dan afstellen of uitzetten?

9. Past het bij je stack, en bij waar je gebruikers zijn?

Zoek een serverbibliotheek in de taal waarin je schrijft, of een gewone HTTP-API die je vanuit elke taal kunt aanroepen. Zoek dan een client voor elk platform dat je voor de komende twee jaar plant, niet alleen voor de platforms die je vandaag uitbrengt. Een webapp die volgend jaar een iOS- en een Android-app wordt, hoort geen tweede chat nodig te hebben.

Kijk daarna op een kaart. Een bericht reist van de afzender naar de dienst en verder naar de lezer, dus een dienst met servers op één continent voegt die reis toe voor iedereen op de andere.

10. Wat zijn de limieten, en hoe zou je vertrekken?

Lees de pagina met limieten vóór de pagina met functies: de grootte van een bericht, hoeveel berichten een gebruiker per seconde mag sturen, hoeveel leden een groep mag hebben, en hoeveel gesprekken één pagina tegelijk mag volgen. Een limiet is geen gebrek. Een limiet die je pas in productie ontdekt, is dat wel.

En stel je de dag voor waarop je vertrekt. Staan de gesprekken in je eigen database, dan is een andere dienst kiezen om ze te vervoeren een wijziging in je code. Staan ze in de database van een dienst, dan is het een migratie van elk bericht, elk bestand en elke leesstatus, op de voorwaarden van de export van die dienst.

Test het een middag lang

Een prijslijst en een functietabel kunnen de meeste van deze vragen niet beantwoorden. Een kleine test wel. Bouw op elke dienst die je overweegt de kleinste chat die je kunt maken, en doorloop deze zeven stappen:

  1. Open een gesprek als twee gebruikers in twee browsers, en als een van hen in een tweede tabblad. Verstuur vanuit elk, en kijk naar alle drie.
  2. Zet de wifi op één apparaat twee minuten uit, verstuur vijf berichten vanaf het andere, en zet hem weer aan. Tel wat er aankomt, en in welke volgorde.
  3. Schrijf een bericht terwijl je offline bent. Kijk of het wordt verstuurd wanneer de verbinding terugkomt.
  4. Blokkeer één gebruiker in je eigen database. Kijk of die nog kan schrijven, en hoe lang.
  5. Probeer vanuit de console van de browser te versturen als de andere gebruiker.
  6. Sluit elke pagina van één gebruiker en schrijf naar die gebruiker. Kijk wat er bij diegene aankomt.
  7. Open de pagina met het gebruik bij de dienst, en lees wat er voor deze middag is geteld.

Hoe WordPlus Cloud ze beantwoordt

WordPlus Cloud is van de tweede soort: een realtime API, met daarbovenop een chat-SDK en een kant-en-klare chat. Dezelfde tien vragen, op volgorde:

  1. Berichten worden bewaard in je database. Een webhook brengt elk bericht naar je server, ondertekend, en de chat laadt zijn geschiedenis van een route van jou. Een ruimte bewaart haar laatste events 5 minuten, alleen voor pagina’s die opnieuw verbinding maken.
  2. Je server bepaalt. Een regel voor elk soort gesprek leest je eigen gegevens en antwoordt wie erin mag, wie alleen mag lezen en wie buiten blijft. De cloud zet zelf de afzender op elk bericht, dus een pagina kan niet schrijven als iemand anders, en je server kan iemand er meteen uit halen.
  3. De rekening telt gelijktijdige verbindingen, vanaf 1.000: $11.99 per maand, jaarlijks gefactureerd, of $14.99 maandelijks gefactureerd. Berichten, typindicatoren, leesbevestigingen en bestanden worden nooit geteld. De tabbladen van één browser delen één verbinding, en wat je server verstuurt, gebruikt er geen.
  4. Een pagina die opnieuw verbinding maakt, krijgt wat ze gemist heeft, in de juiste volgorde, uit die 5 minuten geschiedenis, en alles wat ouder is van je route. Elk bericht heeft een id, dezelfde die je webhook krijgt, dus een herhaling wordt één keer bewaard.
  5. Wij kunnen een privégesprek niet lezen. De berichten, de geschiedenis en wie erin zit, reizen verzegeld met sleutels die je server maakt en die onze servers nooit hebben.
  6. Een kant-en-klare chat op het web, als element voor elke pagina en als React-component, met typindicator, leesbevestigingen, reacties, bestanden en bellen. De kleuren en teksten pas je zelf aan, en een scherm dat je zelf tekent, praat mee in dezelfde gesprekken.
  7. Bestanden gaan naar je eigen opslag, via een route van jou, en het bericht draagt alleen waar het bestand staat. Een melding van je server bereikt elke pagina en app die een gebruiker open heeft.
  8. Moderatie zit in je regels. Blokkeren, dempen en verbannen zijn rijen in je database, en de regel leest ze.
  9. Serverbibliotheken voor Node.js, PHP en Python, met handleidingen voor Next.js, Express, Laravel, gewoon PHP, Django, FastAPI en Flask, een HTTP-API voor elke andere taal, en SDK’s voor iOS en Android. De netwerkpagina laat zien waar de servers staan.
  10. De limieten zijn openbaar: 1 MB per event, 50 events per seconde vanaf een pagina, en 100.000 leden in een ruimte die toont wie erin zit. Tot 20% boven je abonnement wordt er nog verbinding gemaakt, en je krijgt een e-mail bij 80% en bij 100% ervan.

De handleiding voor chat bouwt in elke stack een gesprek van twee en een groep, met de tabel, de webhook en de route voor de geschiedenis. De chat tussen kopers en verkopers van een marktplaats in Next.js is een hele app die zo is gebouwd, en de live demo is een kleine winkel waar een klant naar de winkel schrijft, elk in een eigen venster.

Wat het aan jou overlaat

  • Een tabel, een webhookhandler en een route voor de geschiedenis. Je berichten worden bewaard door code die je zelf schrijft, en dat geldt ook voor het zoeken erin.
  • Mensen die niets open hebben. De SDK’s voor iOS en Android pushen oproepen, zodat een telefoon overgaat terwijl de app dicht is, en verder pushen ze niets. Voor een bericht aan iemand die weg is, stuurt je server de e-mail of de pushmelding.
  • Een chatscherm in mobiele apps. iOS en Android hebben de ruimtes, de typindicator en wie er online is, op een scherm dat je app zelf tekent.
  • Filteren. Wij hebben geen woordfilter, want we kunnen niet lezen wat er in een privégesprek staat. Je webhook krijgt elk bericht, en wat ermee gebeurt, bepaalt je code.

Wil je een chat die elk bericht bewaart en doorzoekt zonder eigen tabel, dan past een chatbackend beter bij je. Dat geldt ook als je app helemaal geen server heeft, want dan is er niets dat de regels kan beantwoorden.

Begin met de handleiding voor chat

WordPlus Cloud for Apps is geprijsd op gelijktijdige verbindingen, vanaf 1.000, maandelijks of jaarlijks gefactureerd. Bellen tussen twee mensen vanuit de chat is inbegrepen, en hetzelfde abonnement en dezelfde SDK brengen groepsgesprekken en livestreaming op dezelfde verbinding. Bekijk de chat-API en SDK voor elk onderdeel van een chat in elke stack, wat de cloud doet voor apps, of de prijzen voor apps. Vragen over je integratie? Schrijf ons.