Social media-API voor bureaus: beheer de accounts van je klanten vanuit je eigen software
Een social media-API voor bureaus laat de eigen software van het bureau de accounts van elke klant koppelen, posts publiceren, antwoorden sturen en rapporten maken. Met de Partner API van easyCoexistence worden het WhatsApp-nummer en de Instagram-, Facebook-, TikTok-, YouTube- en LinkedIn-accounts van een klant gekoppeld aan het account van het bureau, via gehoste links met het klant-id. Eén API-sleutel plant, routeert en bewaakt ze allemaal.
De maximale lengte van de external_ref die een connect-sessie accepteert, het eigen id van het bureau voor de klant, dat bij elke verbinding wordt bewaard.
Hoelang een gehoste connect-link werkt voor de klant die hem opent.
Wat een Meta-app nodig heeft om Instagram-professionele accounts te bedienen die het niet bezit of beheert, na App Review en bedrijfsverificatie.
De LinkedIn-Pagina-rol die een lid nodig heeft voor de rw_organization_admin-permissie, die Pagina's beheert en hun rapportages leest.
Wanneer de facturatie stopt voor een klantverbinding die het bureau via de API verwijdert.
Hoe organiseert de API de klanten van een bureau?
Via je klant-id. Stuur het mee als external_ref bij elke connect-sessie; het blijft staan bij elk nummer en account dat de sessie aanmaakt en komt terug bij elk statusevent. GET /channels?external_ref=client_118 geeft de social media-accounts van die klant, met &channel=instagram om tot één netwerk te beperken, en GET /connections?external_ref=client_118 geeft hun WhatsApp-nummers. Elke klant hangt aan het ene account van het bureau, onder één ec_live_-sleutel, en dat zet het hele aantal in één prijsband.
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"Hoe geeft een klant toegang?
Via een link die het bureau verstuurt. POST /connect-sessions met het netwerk als channel, de external_ref van de klant en de naam van het bureau als partner_name levert een url op; de klant opent die, logt in op het toestemmingsscherm van het netwerk, of gebruikt Meta's pop-up en scant een QR-code voor een WhatsApp-nummer, en komt terecht op de redirect_url van het bureau. Met een Facebook- of LinkedIn-login kunnen meerdere Pagina's tegelijk komen, elk met een eigen verbinding, dus controleer de lijst aan de hand van de opdracht van de klant.
Hoe publiceert het bureau voor klanten?
Vanuit de eigen goedkeuringsflow. De software van het bureau bewaart concepten tot de klant akkoord geeft en stuurt elke goedgekeurde post daarna naar POST /channels/:id/posts met de publish_at, tot 90 dagen vooruit. GET /channels/:id/posts geeft de planning van één account, GET /posts met een statusfilter toont wat bij alle klanten wacht, en post.published en post.failed laten de accountmanager zien wat er is gebeurd. LinkedIn-posts moeten altijd langs de goedkeuring van een persoon, wat de akkoordstap van het bureau al biedt.
Hoe beantwoordt het bureau reacties en DM's voor klanten?
Vanuit één inbox die per account routeert. PUT /channels/:id/webhook stelt een bestemming in voor elk Instagram-account, elke Facebook-Pagina en elk TikTok-account, en elke doorgestuurde reactie, vermelding of DM bevat de account_id, die naar de klant verwijst. De berichten van een WhatsApp-nummer gaan van Meta naar de webhook_url die ervoor is ingesteld. Antwoorden gaan via de API van elk netwerk met de inloggegevens uit GET /channels/:id?credentials=1, en het team van het bureau kan ook over klanten heen werken in Claude of ChatGPT via de MCP-connector op hetzelfde account.
Hoe maakt het bureau rapporten voor klanten?
Vanuit de eigen analytics van elk netwerk, aangeroepen met de inloggegevens van het klant-account. Instagram- en Facebook-inzichten komen uit Meta's Graph API, die van TikTok uit de TikTok API for Business, die van YouTube uit YouTube Analytics, waarvan de basis-URL in de inloggegevens staat, en die van LinkedIn uit de statistiekendpoints. De rapportagetaak van het bureau haalt bij elke uitvoering per account verse inloggegevens op, haalt de cijfers van de periode op en slaat ze op onder de external_ref van de klant.
Hoe weet het bureau dat het account van een klant aandacht nodig heeft?
Via ondertekende statusevents. channel.disconnected en connection.disconnected dragen de external_ref van de klant, zodat de software van het bureau de accountmanager van die klant kan waarschuwen en de klant een nieuwe connect-link kan sturen. Elke verbinding wordt 24/7 bewaakt, en de eigenaar van het bureau krijgt ook een e-mail als er één wegvalt. Een klant die de toegang intrekt in de instellingen van het netwerk, valt op dezelfde manier op.
Wat gebeurt er in de API als een klant vertrekt?
De offboarding-taak van het bureau zoekt de verbindingen van de klant op via external_ref en roept DELETE /channels/:id en DELETE /connections/:id aan op elk ervan. De facturatie ervoor stopt aan het einde van de facturatieperiode, geplande posts op een verwijderd kanaal worden geannuleerd, en het token van een verwijderd social media-account wordt vergeten. Een WhatsApp-nummer blijft op de Cloud API tot de klant het loskoppelt in de WhatsApp Business-app.
Veelgemaakte fouten
- Klantposts in de wachtrij zetten voordat de klant akkoord geeft. Een post in de wachtrij wordt op zijn tijd gepubliceerd zonder nieuwe controle, dus houd concepten vast in je goedkeuringsstap en stuur ze pas als ze zijn goedgekeurd.
- De Partner API-sleutel in de frontend van een klantportaal zetten. De sleutel geeft toegang tot de inloggegevens van elke klant op het account, dus houd hem op de server van het bureau.
- Wachten op events voor reacties van het YouTube-kanaal of de LinkedIn-Pagina van een klant. easyCoexistence ontvangt van geen van beide zulke events, dus de rapport- of inboxtaak leest ze via de API van elk netwerk.
easyCoexistence geeft de eigen software van een bureau één API voor de WhatsApp-nummers van zijn klanten en hun Instagram-, Facebook-, TikTok-, YouTube- en LinkedIn-accounts, en er komen steeds meer kanalen bij: gehoste connect-links met labels per klant, een publicatiewachtrij, doorgestuurde reacties en DM's, verse inloggegevens voor rapporten en bewaking van elke verbinding 24/7. Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je er meer toevoegt, met 3 dagen gratis proefperiode.
Veelgestelde vragen
Hebben klanten een eigen easyCoexistence-account nodig?
Nee. Een klant opent de gehoste link en logt in, en de verbinding komt bij het account van het bureau, waar ze wordt gefactureerd en bewaakt.
Kan het bureau klanten op aparte API-sleutels houden?
Eén account heeft één sleutel. Aparte sleutels betekenen aparte easyCoexistence-accounts, elk gefactureerd vanaf de eerste prijsband, dus de meeste bureaus houden klanten liever uit elkaar via external_ref.
Kan de klant de naam van het bureau zien bij het koppelen?
Ja. De gehoste pagina toont de naam die als partner_name is gestuurd. Het toestemmingsscherm van het netwerk noemt easyCoexistence als de app die toegang vraagt.
Hoeveel kost easyCoexistence voor een bureau?
Van US$ 9 tot US$ 0,75 per klantverbinding per maand, dalend naarmate het bureau meer klanten toevoegt, hetzelfde op elk netwerk, met 3 dagen gratis proefperiode.
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