InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Multi-tenant API voor sociale media: één API-sleutel, accounts van veel klanten

De Partner API van easyCoexistence is standaard multi-tenant: één ec_live_-sleutel op je account verbindt en beheert de WhatsApp-nummers en sociale accounts van veel klanten. Elke verbinding draagt het id van je klant als external_ref, heeft het eigen token van die klant, krijgt een eigen webhook-bestemming en verschijnt in ondertekende statusevents, zodat GET /channels?external_ref= de accounts van één klant weergeeft.

200 characters

Langste external_ref die een connect-sessie accepteert: je eigen id voor de klant, opgeslagen op de verbinding die de sessie maakt.

1 key

API-sleutels die een easyCoexistence-account tegelijk bevat; aparte sleutels betekenen aparte accounts met aparte facturen.

50 open

Connect-sessies die één account tegelijk open kan hebben, naast een limiet van 100 nieuwe sessies per uur.

5 minutes

Leeftijd waarna de tijdstempel van een ondertekend event moet worden geweigerd, met de HMAC vergeleken in constante tijd.

Hoe bedient één account veel klanten?

Je easyCoexistence-account staat voor je product, en elke klant is een tag op de verbindingen die ze meebrengen. Klanten maken geen eigen account aan, zien je sleutel nooit en worden door jou gefactureerd, niet door easyCoexistence:

Your accountOne ec_live_ key, one bill, one status events URL
Your customerYour own id, sent as external_ref
NumberA WhatsApp number at /connections
ChannelA social account at /channels
DestinationA webhook per number or channel

Hoe tag je elke verbinding met je klant?

Stuur external_ref mee in de connect-sessie. De waarde wordt opgeslagen op het nummer of kanaal dat de sessie aanmaakt, toegevoegd aan de redirect en opgenomen in de statusevents. Een Facebook- of LinkedIn-aanmelding die meerdere Pagina's meebrengt, voorziet elk van een tag. Om de accounts van één klant te zien, filter je op een van beide lijsten:

One customer's social accounts and numbers
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

Hoe worden de tokens van klanten gescheiden gehouden?

Elke verbinding heeft het token van de eigen klant. Het token van een WhatsApp-nummer is het zakelijke token dat Meta uitgeeft bij Embedded Signup, beperkt tot de assets van die klant, en het token van een sociaal account is het token dat de eigenaar heeft verleend. Inloggegevens komen alleen via je sleutel, vanuit je backend, en een ID dat niet op je account staat, antwoordt met 404 not_found. Zoek de verbinding op van de klant bij wie een taak hoort voordat je het token ophaalt, zodat het werk van de ene klant nooit op het account van een andere draait.

Hoe werken webhooks per klant?

Eén bestemming per account, door jou gekozen. Richt de kanalen op één URL en routeer op account_id in de body, of geef elke klant een eigen URL. Elk kanaal ondertekent met een eigen geheim uit PUT /channels/{id}/webhook, dus het account_id vertelt je met welk geheim je moet verifiëren. De berichten van een nummer gaan van Meta naar zijn webhook_url, die op het WhatsApp Business Account is ingesteld. Routeer die daarom op phone_number_id.

Hoe zeggen statusevents welke klant ze betreffen?

Door je external_ref mee te sturen. Eén events-URL per account ontvangt connection.*- en channel.*-events, elk met de weergave van de verbinding of het kanaal erin, inclusief external_ref. post.published en post.failed bevatten de post en het bijbehorende kanaal. Events worden ondertekend met het eigen geheim van het account in X-EC-Signature en opnieuw verstuurd wanneer je endpoint faalt, dus verwerk elk delivery-id slechts één keer.

Hoe snel kun je veel klanten onboarden?

Met 50 open connect-sessies en 100 nieuwe per uur per account. Meta telt elke eerste WhatsApp-onboarding mee op een limiet voor de hele app die alle easyCoexistence-accounts delen, en de plafonds voorkomen dat de import van één platform die verbruikt. Maak elke sessie aan wanneer de klant bijna gaat verbinden. Bij een plafond antwoordt de API met 429 cap_reached of rate_limited.

Wat als het account van een klant al elders verbonden is?

De aanmelding wordt geweigerd. Een sociaal account verbindt met één easyCoexistence-account tegelijk, dus als een andere dienst die easyCoexistence gebruikt het al vasthoudt, zegt de last_error van de sessie dat. De klant verwijdert het daar of meldt zich aan met een ander account. Binnen je eigen account kan een klant zoveel accounts verbinden als nodig is, elk getagd met dezelfde external_ref.

Hoe verwijder je één klant?

Zoek hun verbindingen en kanalen op via external_ref en verwijder elk met DELETE. Een nummer verwijderen trekt de toegang van easyCoexistence bij Meta in en stopt de monitoring; een kanaal verwijderen trekt de toegang bij het netwerk in en annuleert de posts die nog in de wachtrij staan. De facturering voor elk stopt aan het eind van de cyclus, en de andere verbindingen van de klant blijven, net als die van andere klanten, onaangeroerd.

Veelgemaakte fouten

  • Een e-mailadres gebruiken als external_ref. E-mailadressen veranderen en de waarde wordt op elke verbinding opgeslagen, dus gebruik het stabiele id uit je eigen database.
  • Geforwarde events verifiëren met het geheim van de verkeerde klant. Zoek het geheim op via de account_id in de body, want elk kanaal ondertekent met zijn eigen geheim.
  • Connect-links in één keer naar je hele klantenbestand sturen. Er kunnen maar 50 sessies per account open staan, dus nodig klanten in golven uit.
  • Een klant alleen in je eigen database verwijderen. Hun verbindingen blijven op je account en je factuur staan totdat elk via de API is verwijderd.
Dit doen met EasyCoexistence

easyCoexistence laat één API-sleutel je hele klantenbestand bedienen: hun WhatsApp-nummers en hun Instagram-, Facebook-, TikTok-, YouTube- en LinkedIn-accounts, en meer kanalen, elk getagd met je klant-id, met een eigen token, webhook en ondertekende events, en elke verbinding 24/7 gemonitord. Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Heb ik per klant één easyCoexistence-account nodig?

Nee. Eén account en zijn sleutel kunnen de verbindingen van veel klanten bevatten, uit elkaar gehouden via external_ref. Aparte accounts zijn alleen nodig als je aparte facturen wilt.

Kunnen mijn klanten elkaars accounts zien?

Niet via easyCoexistence. Ze hebben je sleutel nooit en openen alleen hun eigen connect-links. Wat elke klant in jouw product ziet, bepaalt jouw code.

Kan ik elke klant een andere webhook-URL geven?

Ja. Elk nummer en elk kanaal krijgt een eigen bestemming, dus een klantspecifieke URL werkt, net als één gedeelde URL die op account_id routeert.

Hoe wordt een multi-tenant account gefactureerd?

Per verbinding over al je klanten samen: van US$ 9 tot US$ 0,75 per verbinding per maand, bepaald door de schijf van je totale aantal, met de eerste 3 dagen 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