Een AI-agentproduct bouwen op de WhatsApp, Instagram en TikTok van je klanten
Een AI-agentproduct op de kanalen van klanten rust op drie onderdelen: een gehoste koppellink voor het WhatsApp-nummer of sociale account van elke klant, webhooks die hun berichten en reacties naar je backend brengen, en statusevents voor verbindingen die wegvallen. Daar schrijft je eigen model antwoorden die via de officiële API van elk netwerk worden verstuurd met het token van de klant. De agent houdt zich aan de regels van elk netwerk, zoals het 24-uursvenster van WhatsApp.
easyCoexistence geeft de AI-agents van je product een stem op de WhatsApp-nummers van je klanten en hun Instagram-, Facebook-, TikTok-, YouTube- en LinkedIn-accounts, en er komen steeds meer kanalen bij: gehoste connect-links, verse inloggegevens, webhooks en ondertekende statusevents via de officiële API van elk netwerk, met elke verbinding 24/7 bewaakt.
Het servicevenster van WhatsApp start na een bericht of oproep van een gebruiker; elk nieuw bericht start het opnieuw.
Wat een WhatsApp-bedrijf kan versturen zodra het servicevenster sluit: vooraf goedgekeurde templates.
Metas voorwaarden verbieden AI-aanbieders om WhatsApp te gebruiken voor AI als primaire, en niet slechts bijkomstige, functionaliteit.
Het venster waarbinnen een Instagram-account één privé-antwoord op een reactie kan geven, geteld vanaf het moment dat de reactie is geplaatst.
Vaste doorvoer van een nummer dat zowel met de WhatsApp Business-app als met de Cloud API wordt gebruikt.
Wat heeft een AI-agentproduct nodig van het kanaal van elke klant?
Vier dingen: een manier voor de klant om het te koppelen, hun berichten die je backend bereiken, een token om mee te antwoorden, en een melding wanneer de verbinding stopt met werken. De Partner API dekt elk daarvan, terwijl het model, de prompts en de gesprekslogica van jou blijven. easyCoexistence koppelt het account, houdt de toegang vernieuwd en bewaakt het, en je antwoorden gaan vanuit je backend rechtstreeks naar de API van het netwerk.
Hoe koppelt elke klant zich?
Je backend maakt een connect-sessie aan met POST /connect-sessions, met een channel, een redirect_url en een external_ref voor je klant, en voor een nummer ook de webhook_url en webhook_verify_token. De klant opent de gehoste link, meldt zich aan met Meta, TikTok, Google of LinkedIn en keert terug naar je app met connection_id of channel_id. Ze hebben geen easyCoexistence-account, e-mailadres of creditcard nodig, en elke verbinding die via jouw sleutel wordt gemaakt, hoort bij jouw account.
Hoe bereiken berichten en reacties je model?
Via de webhook, op de netwerken die ze versturen. Meta levert de berichten van een nummer rechtstreeks af bij zijn webhook_url, en wat de medewerkers van het bedrijf vanuit de WhatsApp Business-app versturen, komt daar aan als smb_message_echoes. Instagram- en Facebook-reacties, vermeldingen en DM's, en TikTok-reacties, worden doorgestuurd naar de bestemming van elk kanaal, ondertekend met het geheim ervan. YouTube en LinkedIn sturen geen reactie-events, dus leest de agent nieuwe reacties via hun API's volgens een schema. Beantwoord elke levering meteen met 2xx en laat een achtergrondproces het model aanroepen.
Hoe antwoordt de agent?
Via de eigen API van het netwerk, met de inloggegevens die je backend heeft opgehaald. Een WhatsApp-antwoord is een POST naar de send_endpoint van het nummer met het token van de klant; een Instagram- of Facebook-DM gaat naar de messages-edge van het account; een TikTok-antwoord gaat onder de reactie via business/comment/reply/create/. De onderstaande schets beantwoordt WhatsApp-berichten: hij controleert het geheim in het URL-pad, zet elk binnenkomend bericht in de wachtrij en antwoordt met wat je model teruggeeft.
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request
EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"} # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"] # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {} # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)
@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
if not hmac.compare_digest(secret, PATH_SECRET):
abort(404)
if request.method == "GET": # Meta's handshake when the destination is set
if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
abort(403)
return request.args.get("hub.challenge", "")
for entry in request.get_json().get("entry", []):
for change in entry.get("changes", []):
if change.get("field") == "messages": # echoes and history are context, not prompts
value = change["value"]
for msg in value.get("messages", []):
jobs.put((value["metadata"]["phone_number_id"], msg))
return "", 200 # answer at once; dedupe on msg["id"], since Meta can deliver twice
def worker() -> None:
while True:
phone_number_id, msg = jobs.get()
conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
headers=KEY, params={"credentials": 1}).json()
creds = conn["credentials"]
if not creds["access_token"]: # token_ready is false: a new connect session issues one
continue
reply = my_model(conn["external_ref"], msg) # your model, your prompt, your memory
requests.post(creds["send_endpoint"], # a reply to a fresh message is inside the 24 hours
headers={"Authorization": f"Bearer {creds['access_token']}"},
json={"messaging_product": "whatsapp", "to": msg["from"],
"type": "text", "text": {"body": reply}})
threading.Thread(target=worker, daemon=True).start()MCP-server of Partner API: welke gebruikt de agent?
De Partner API, wanneer de agent jouw product is en je klanten de kanalen meebrengen: je backend houdt de sleutel vast, ontvangt events en draait elk model dat je kiest. De MCP-server op https://easycoexistence.com/api/mcp past bij een assistent zoals Claude of ChatGPT die in je eigen easyCoexistence-account werkt, via tools die hij op verzoek aanroept na een OAuth-aanmelding. Nummers en kanalen die je met je sleutel koppelt, staan ook op dat account, zodat een MCP-sessie daar bij kan voor het werk van je eigen team.
| Partner API | MCP server | |
|---|---|---|
| Built for | Your product, serving your customers | An assistant working on your own account |
| Signs in with | An ec_live_ key, one per account | OAuth, from Claude, ChatGPT or another client |
| Incoming messages | Webhooks to your backend | Read when the assistant calls a tool |
| The model | Any model you run | The assistant's own |
| Replies | Your code calls each network's API | Tools such as send_message and reply_to_comment |
Hoe draaien bureaus agents voor veel klanten?
Op één account, met elke klant getagd. Geef het klant-ID mee als external_ref bij elke connect-sessie, toon de naam van je bureau op de gehoste pagina met partner_name, en laat de verbindingen van één klant zien met GET /connections?external_ref= en GET /channels?external_ref=. Elke verbinding wordt aan het bureau gefactureerd voor US$ 9 tot US$ 0,75 per verbinding per maand, dat daalt naarmate er meer verbindingen bijkomen, terwijl Meta de WhatsApp-gesprekskosten aan het eigen WhatsApp Business-account van de klant factureert. Met Coexistence blijven de medewerkers van de klant gewoon antwoorden in de WhatsApp Business-app, naast de agent.
Aan welke regels moet de agent zich houden?
Die van de netwerken zelf, die je code moet controleren voordat het antwoord van het model wordt verstuurd. Platforms houden zich daaraan namens hun klanten, want de handhaving van Meta treft het account van de klant:
- WhatsApp: vrije tekst alleen binnen 24 uur na het laatste bericht van de klant; daarna een goedgekeurd template, verstuurd via de API, omdat de WhatsApp Business-app in Coexistence geen templates kan versturen.
- WhatsApp: Metas voorwaarden verbieden AI aan te bieden als primaire functionaliteit, wat de referentie van de Partner API omschrijft als geen algemene AI-bots, en staan fine-tuning op WhatsApp-gegevens alleen toe voor het exclusieve gebruik van het bedrijf.
- Instagram en Facebook: DM's binnen 24 uur na het laatste bericht van de persoon, en één privé-antwoord per reactie binnen 7 dagen na die reactie.
- TikTok: antwoorden op reacties zijn openbaar, want een TikTok-verbinding heeft geen DM's.
- Volume: 20 berichten per seconde per Coexistence-nummer, en marketingtemplates vereisen een betaalmethode op het WhatsApp Business-account van de klant.
Hoe weet de agent dat een kanaal is gestopt met werken?
Via statusevents. connection.disconnected of channel.disconnected betekent dat antwoorden mislukken tot de klant opnieuw koppelt, dus pauzeer de agent van die klant, laat het de klant weten en stuur een nieuwe connect-link; connection.token_missing betekent dat het nummer wel kan ontvangen maar nog niet kan versturen. Wanneer connection.connected of channel.connected opnieuw binnenkomt, haal je verse inloggegevens op en hervat je. Elk event wordt ondertekend met X-EC-Signature en gedurende ongeveer 33 uur opnieuw geprobeerd.
Veelgemaakte fouten
- Het model een WhatsApp-bericht ouder dan 24 uur laten beantwoorden met vrije tekst. Het venster is gesloten, dus controleer het tijdstip van het laatste inkomende bericht van de klant en schakel over naar een goedgekeurd template.
- Een gedeeld model trainen op WhatsApp-gesprekken van klanten. Metas voorwaarden staan fine-tuning op WhatsApp Business Platform-gegevens alleen toe voor het exclusieve gebruik van het bedrijf, nooit om andere modellen te verbeteren.
- smb_message_echo's behandelen als berichten van klanten. Dat zijn berichten die de medewerkers van het bedrijf vanuit de app verstuurden, dus geef ze aan het model als context, niet als berichten om op te antwoorden.
- Antwoorden op de eigen berichten van het account. Instagram-DM's die het verstuurt, komen terug als echo's en TikTok-antwoorden als reactie-events, dus sla alles over wat het account zelf schreef, anders antwoordt de agent zichzelf.
US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je er meer toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Kan ik mijn eigen AI-model gebruiken?
Ja. Je backend ontvangt de berichten, roept het model aan dat je kiest en antwoordt via de API van het netwerk met het token van de klant. De berichten van een WhatsApp-nummer gaan van Meta rechtstreeks naar je webhook, nooit via easyCoexistence.
Wat betekent Metas AI-beleid voor een WhatsApp-agent?
Metas voorwaarden verbieden AI-aanbieders het WhatsApp Business Platform te gebruiken om AI-technologie aan te bieden als primaire functie, en niet als bijkomstige of ondersteunende functie, zoals Meta bepaalt. Houd je daaraan namens je klanten, samen met het 24-uursvenster en goedgekeurde templates.
Kan de agent DM's versturen op TikTok, YouTube of LinkedIn?
Nee. Op die netwerken werkt de agent in de reacties: TikTok-antwoorden zijn openbaar, en YouTube- en LinkedIn-reacties worden gelezen en beantwoord via hun API's.
Hoeveel kost easyCoexistence voor een AI-agentproduct?
Per verbinding, hetzelfde op elk netwerk: US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je er meer toevoegt, met een gratis proefperiode van 3 dagen. Meta factureert de WhatsApp-gesprekskosten aan het eigen WhatsApp Business-account van elke klant.
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