AI-agent SaaS-architectuur: je klanten van je klanten bereiken op WhatsApp, Instagram en TikTok
Een AI-agent-SaaS die je klanten van je klanten bereikt, werkt in vijf lagen: verbindingen, waarin elke klant WhatsApp, Instagram, TikTok en meer kanalen koppelt via de Partner API van easyCoexistence; ingestie, die webhooks verifieert en in de wachtrij zet; een gespreksopslag die jij beheert; een agentworker die jouw model draait; en uitgaand verkeer, dat antwoorden en posts verstuurt en statusgebeurtenissen volgt via de officiële API van elk netwerk.
De webhook die een bericht beschrijft dat het bedrijf verstuurde vanuit de WhatsApp Business-app op een Coexistence-nummer.
Hoe lang Meta een WhatsApp-webhook opnieuw probeert te verzenden die je endpoint niet accepteerde, waardoor hetzelfde bericht twee keer kan binnenkomen.
Afleveringen van elke doorgestuurde Instagram-, Facebook- of TikTok-gebeurtenis, zonder nieuwe poging en zonder bewaarde kopie.
Het klantenservicevenster van WhatsApp na een bericht van een persoon; daarbuiten mag een bedrijf alleen goedgekeurde templates versturen.
Vaste doorvoer van een nummer dat zowel met de WhatsApp Business-app als met de Cloud API wordt gebruikt.
Wat zijn de lagen van een AI-agent-SaaS?
Vijf, elk met één taak, zodat een traag model nooit een bericht verliest en een weggevallen account het product nooit platlegt. easyCoexistence zit in de eerste en de laatste: het koppelt de accounts en houdt ze werkend, terwijl de gesprekslogica en het model in je backend blijven.
Hoe modelleer je tenants, kanalen en gesprekken?
In drie tabellen. Een tenant is je klant, en het id ervan gaat als external_ref mee in elke connect-sessie, zodat elke verbinding en statusgebeurtenis met dat id terugkomt. Een kanaalrij bevat de connection_id van een WhatsApp-nummer of de channel_id van een social account, met het netwerk en de status. Een gesprek wordt vastgelegd op het kanaal en het ID van de persoon op dat netwerk: het WhatsApp-nummer in from, het Instagram-scoped ID bij een DM, of de draad van de reactie bij TikTok.
Waar moeten inkomende gebeurtenissen eerst terechtkomen?
In een duurzame wachtrij, voordat een model draait. Het ingestie-endpoint controleert het geheim in het URL-pad bij WhatsApp-afleveringen en X-EC-Signature bij doorgestuurde social gebeurtenissen, schrijft de gebeurtenis naar de wachtrij en antwoordt met 2xx. De twee bronnen gedragen zich verschillend: Meta probeert een WhatsApp-webhook tot 7 dagen opnieuw, dus hetzelfde bericht kan twee keer binnenkomen, terwijl een doorgestuurde Instagram-, Facebook- of TikTok-gebeurtenis één keer wordt verstuurd en nooit wordt bewaard, dus een gebeurtenis die je endpoint weigert, is weg. Ontdubbel op het eigen bericht- of reactie-ID van het netwerk.
Hoe houd je antwoorden in volgorde en op tijd?
Eén worker per gesprek, en een controle voor elke verzending. Vergrendel het gesprek terwijl de agent werkt, zodat twee berichten van dezelfde persoon na elkaar worden beantwoord en nooit dubbel. Voordat een WhatsApp-antwoord vertrekt, vergelijk je het laatste bericht van de persoon met het 24-uursvenster, en schakel over op een goedgekeurde template zodra dat is gesloten. Zet de verzendingen per nummer in de wachtrij met maximaal 20 berichten per seconde, de vaste snelheid van een Coexistence-nummer, en onthoud dat een TikTok-antwoord een openbare reactie is.
Hoe neemt een persoon het over van de agent?
Via het kanaal zelf. Bij Coexistence blijft het personeel van je klant de WhatsApp Business-app gebruiken op hetzelfde nummer, en elk bericht dat zij sturen komt bij je webhook aan als smb_message_echoes. Behandel een echo als overdracht: pauzeer de agent op dat gesprek, geef het antwoord van het personeel als context aan het model, en hervat na een rustige periode of wanneer het personeel het in je product teruggeeft. Instagram stuurt de eigen DM's van het account ook als echo's terug, dus dezelfde regel voorkomt dat de agent zichzelf antwoordt.
Moet de agent ook publiceren, niet alleen antwoorden?
Dat kan, met dezelfde sleutel. De agent stelt posts op en je backend zet ze in de wachtrij met POST /channels/:id/posts op Instagram, Facebook, TikTok en LinkedIn, van 1 minuut tot 90 dagen vooruit, waarbij post.published en post.failed terugmelden aan de gespreksopslag. LinkedIn-posts gaan pas uit nadat een persoon elke post in je product heeft goedgekeurd, omdat de API-voorwaarden van LinkedIn geautomatiseerd posten beperken.
Hoe reageert het product wanneer een verbinding wegvalt?
Via een status op de kanaalrij. Een statusgebeurtenis zet die op losgekoppeld, verwijderd of opgeschort, de agent stopt met verzenden op dat kanaal, en je interface vraagt de tenant om opnieuw te verbinden via een nieuwe connect-sessie. Een connection.token_missing-gebeurtenis laat een nummer wel ontvangen maar niet verzenden, dus de agent stelt antwoorden op voor het personeel. connection.connected of channel.connected zet de rij terug op actief, en de worker haalt verse inloggegevens op voordat het volgende antwoord wordt verstuurd.
Welke data sla je op, en welke bewaart easyCoexistence?
Je product slaat de gesprekken op. De berichten van een WhatsApp-nummer gaan van Meta rechtstreeks naar je webhook, en doorgestuurde social gebeurtenissen gaan via easyCoexistence zonder kopie. easyCoexistence bewaart wat nodig is om de verbinding te laten werken: het record van het account, de tokens, de gezondheidsgeschiedenis en de posts die het publiceert. Als je account ook de eigen automatiseringen van easyCoexistence inschakelt, wordt de berichttekst daarvan 7 dagen bewaard en de runlogs 30 dagen.
Veelgemaakte fouten
- Gesprekken vastleggen op alleen het telefoonnummer van de persoon. Dezelfde persoon kan naar twee van je tenants schrijven, dus leg elke draad vast op het kanaal en het ID van de persoon samen.
- Twee workers laten antwoorden op één gesprek. Parallelle workers kunnen antwoorden uit volgorde of dubbel versturen, dus vergrendel elke draad terwijl de agent eraan werkt.
- De agent aan laten staan nadat het personeel antwoordt vanuit de WhatsApp Business-app. De echo laat zien dat een persoon de draad heeft overgenomen, dus pauzeer de agent daar tot je overdrachtsregel hem terugzet.
- De LinkedIn-concepten van de agent op een timer publiceren. Een persoon keurt elke LinkedIn-post goed, dus stuur die concepten eerst naar een controlestap voordat ze de wachtrij bereiken.
easyCoexistence is de verbindingslaag voor je agentproduct: de WhatsApp-nummers van je klanten en hun Instagram-, Facebook-, TikTok-, YouTube- en LinkedIn-accounts, en meer kanalen, verbonden via gehoste links, met verse inloggegevens, webhooks, een publicatiewachtrij en ondertekende statusgebeurtenissen, en elke verbinding 24/7 bewaakt. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Moeten de klanten van je klanten iets installeren?
Nee. Zij schrijven naar het bedrijf zoals ze dat al doen, via WhatsApp, in Instagram-DM's of Messenger, of in de reacties, en je agent antwoordt op hetzelfde kanaal.
Kan het personeel van je klanten nog zelf antwoorden?
Ja. Bij Coexistence blijft de WhatsApp Business-app werken op hetzelfde nummer, en elk bericht dat het personeel stuurt, komt als echo bij je webhook aan, zodat de agent opzij kan gaan.
Draait easyCoexistence het model?
Nee. Het model, de prompts en het geheugen draaien in je backend. easyCoexistence koppelt de accounts, levert hun gebeurtenissen af en houdt hun toegang werkend.
Wat kost easyCoexistence per klant van een agent-SaaS?
Elk verbonden nummer of account kost US$ 9 tot US$ 0,75 per maand, dalend naarmate je totaal groeit, dus een klant met WhatsApp en Instagram telt dubbel. De eerste 3 dagen zijn gratis.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op